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 (שאילתות ביום) לפרויקט, מתעדכן כל יום
מידע נוסף זמין במאמר בנושא שימוש וחיוב.