מדריך ומקרים לדוגמה של Map Management API

אתם יכולים להשתמש ב-Map Management API כדי לנהל באופן פרוגרמטי את משאבי עיצוב המפות מבוסס-הענן שלכם בשתי נקודות הקצה: v2alpha(ניסיוני) ו-v2beta (גרסת Preview).

סיכום הפעולות

כדי להציג מפה בהתאמה אישית באמצעות Map Management API, צריך לבצע את השלבים העיקריים הבאים:

  1. יוצרים StyleConfig: מגדירים את המראה החזותי של המפה באמצעות ייצוג JSON של הגדרות הצבעים, החשיפה והצפיפות.
  2. יצירת MapConfig: הגדרת מזהה מפה ייחודי שמשמש כמאגר לזהות המפה ולתכונות ברמה גבוהה.
  3. משייכים אותם ל-MapContextConfig: מקשרים את StyleConfig (ואת מערכי הנתונים האופציונליים) לגרסאות ספציפיות של המפה (כמו ROADMAP או SATELLITE) בתוך MapConfig.

התנהגויות ברירת מחדל

כשמשתמשים בנקודות הקצה מגרסה 2, חשוב לזכור את התנהגויות ברירת המחדל הבאות:

  • סוג המפה: סוג ברירת המחדל של עיבוד המפה הוא RASTER. כדי להשתמש במפות מבוססות-ווקטור, צריך להגדיר במפורש את map_type ל-VECTOR ב-MapConfig.
  • Map Variant (מיפוי וריאנט): אם לא מציינים map_variants כשיוצרים MapContextConfig, ההגדרה תחול כברירת מחדל רק על הווריאנט ROADMAP.
  • סגנון בסיסי: אם התג json_style_sheet ריק או לא צוין ב-StyleConfig, תשתמש המערכת במפת הבסיס של Google ללא סגנון.

עבודה עם StyleConfigs

קובץ StyleConfig מכיל את הגדרות הסגנון מבוססות ה-JSON.

יצירת StyleConfig

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/styleConfigs \
-d '{
  "display_name": "My Custom Style",
  "json_style_sheet": "[{\"featureType\":\"all\",\"stylers\":[{\"saturation\":-100}]}]"
}'

הצגת רשימה של StyleConfigs

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/styleConfigs

עבודה עם MapConfigs

MapConfig מגדיר את הזהות ואת סוג העיבוד המרכזי של מפה.

יצירת MapConfig

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/mapConfigs \
-d '{
  "display_name": "My New Map",
  "map_type": "VECTOR"
}'

עבודה עם MapContextConfigs

‫MapContextConfig מקשר בין סגנון לבין MapConfig.

יצירת MapContextConfig

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/mapConfigs/YOUR_MAP_ID/mapContextConfigs \
-d '{
  "style_config": "projects/YOUR_PROJECT_ID/styleConfigs/YOUR_STYLE_ID",
  "map_variants": ["ROADMAP", "NAVIGATION"]
}'

שגיאות

  • ‫PERMISSION_DENIED: לבקשה חסרות הרשאות IAM מספיקות או שה-API לא מופעל בפרויקט.
  • ‫NOT_FOUND: המשאב שצוין (פרויקט, MapConfig או StyleConfig) לא קיים.
  • ‫INVALID_ARGUMENT: גוף הבקשה לא תקין או שהוא מכיל ערכים לא תקינים בשדות.