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