Map Management API הוא ממשק RESTful API שמאפשר לנהל באופן פרוגרמטי את משאבי העיצוב של מפות מבוססות-ענן. באמצעות ה-API הזה, אתם יכולים להגדיר את המראה החזותי של המפות, לנהל את הזהויות של המפות ולשייך סגנונות מותאמים אישית וערכות נתונים לגרסאות ספציפיות של מפות – והכול בלי להשתמש במסוף Cloud.
ממשק Map Management API מיועד למפתחים שרוצים לבצע ניהול בקנה מידה גדול של הגדרות מפה, או לשלב סגנונות מפה בתהליכי עבודה אוטומטיים ובכלים פנימיים משלהם.
משאבים עיקריים
- StyleConfig: מכיל את הייצוג ב-JSON של סגנון מפה. כאן מגדירים את הצבעים, את מידת החשיפה ואת הצפיפות של הרכיבים במפה.
- MapConfig: מייצג מזהה מפה ייחודי (מזהה מפה). הוא משמש כמאגר להגדרות סגנון ולתכונות כמו הדגשה של נקודות עניין או החלקה של בניינים.
- MapContextConfig: משייך
StyleConfig(ואפשרותית מערכי נתונים אחד או יותר) ל-MapVariantsספציפיים בתוךMapConfig.
ערוצים של גרסאות API
ב-Map Management API נעשה שימוש בניהול גרסאות מבוסס-ערוצים כדי לספק דרך ברורה ממאפיינים ניסיוניים לזמינות לכלל המשתמשים (GA) יציבה.
- v2alpha (ניסיוני): מכיל את התכונות הניסיוניות העדכניות ביותר. התכונות בערוץ הזה עשויות להשתנות ללא הודעה מוקדמת, ולא מומלץ להשתמש בהן בסביבת ייצור.
- v2beta (גרסת טרום-השקה): מכילה תכונות יציבות שנמצאות בהכנה לזמינות לכלל המשתמשים. הערוץ הזה מתאים לאימוץ מוקדם ולבדיקות בסביבות טרום-ייצור.
- v2 (זמינות כללית): מכיל תכונות נתמכות באופן מלא ומוכנות לשימוש בסביבת ייצור.
רוב התכונות של גרסה 2 זמינות בנקודות הקצה v2alpha ו-v2beta במהלך שלבי ההשקה שלהן. למשתמשים חדשים, Google ממליצה להתחיל עם נקודת הקצה v2beta.
אימות
רק באמצעות OAuth 2.0 אפשר לבצע אימות באמצעות Map Management API, שלא תומך במפתחות API. מידע נוסף זמין במאמר בנושא שימוש ב-OAuth.
מגבלות
- תפקידים למפתחים: כדי להשתמש ב-Map Management API, צריכות להיות לכם הרשאות IAM לניהול משאבים של Google Maps Platform בפרויקט בענן שלכם ב-Google Cloud.
- היקף המשאבים: ה-API הזה מתמקד בניהול של משאבי סגנונות מפות מבוססי-Cloud. יכול להיות שעדיין תצטרכו את מסוף Cloud להגדרות אחרות של Google Maps Platform.
עלויות
השימוש ב-Map Management API לא כרוך בתשלום. קריאות ל-API מופיעות בדף החיוב במסוף Cloud, אבל החיובים יהיו 0$. עם זאת, הבקשות מוגבלות באופן הבא:
- 3 QPS (שאילתות לשנייה)
- 180 QPM (שאילתות לדקה) לפרויקט, מתעדכן כל דקה
- 100,000 QPD (שאילתות ביום) לפרויקט, מתעדכן כל יום
מידע נוסף זמין במאמר בנושא שימוש וחיוב.