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 בפרויקט שלכם ב-Google Cloud.
- היקף המשאבים: ה-API הזה מתמקד בניהול משאבים של סגנונות מפות מבוססי-Cloud. יכול להיות שעדיין תצטרכו את מסוף Cloud להגדרות אחרות ב-Google Maps Platform.
עלויות
השימוש ב-Map Management API לא כרוך בתשלום. קריאות ה-API מופיעות בדף החיוב במסוף Cloud, אבל החיובים יהיו 0$. עם זאת, יש מגבלות על הבקשות:
- 3 QPS (שאילתות לשנייה)
- 180 QPM (שאילתות לדקה) לפרויקט, עם רענון כל דקה
- 100,000 QPD (שאילתות ביום) לפרויקט, מתעדכן כל יום
מידע נוסף זמין במאמר בנושא שימוש וחיוב.