פרמטרים נדרשים של בקשה

כדי לשלוח בקשה אל Map Management API, צריך לכלול את הפרטים הבאים בכותרות ובכתובות ה-URL:

  • מזהה הפרויקט: מספר הפרויקט או המזהה של פרויקט Google Cloud בכותרת X-Goog-User-Project. הערך הזה קובע את הפרויקט שמשמש לחישובים של חיוב ומכסות.

  • כותרת הרשאה: טוקן OAuth 2.0 בכותרת Authorization. מידע נוסף זמין במאמר בנושא שימוש ב-OAuth.

  • שם משאב: מספר או מזהה של פרויקט בענן ב-Google Cloud בכתובת ה-URL של הבקשה, יחד עם מזהה המשאב הספציפי (למשל mapConfigId או styleConfigId).

דוגמה: יצירת MapConfig

בדוגמה הבאה מוצג אופן היצירה של אובייקט MapConfig באמצעות curl. כששולחים את הבקשה הזו, מקבלים את האובייקט החדש שנוצר בתגובה, אם יצירת MapConfig הושלמה בהצלחה.

curl -X POST \
-H 'X-Goog-User-Project: YOUR_PROJECT_NUMBER' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_NUMBER/mapConfigs -d '{
  "displayName": "My New York Map",
  "description": "A Map for New York City",
  "mapType" : "VECTOR",
  "mapFeatures": {
    "simpleFeatures": ["FLATTEN_BUILDINGS", "ICONIC_ICONS"],
    "poiBoostLevel": 1
  }
}'

אם הבקשה מבוצעת בהצלחה, מקבלים את אובייקט הגדרות המפה שנוצר: 

{
  "name": "projects/YOUR_PROJECT_NUMBER/mapConfigs/YOUR_MAP_CONFIG_ID",
  "displayName": "Testing No Type",
  "description": "Testing",
  "mapId": "YOUR_MAP_CONFIG_ID",
  "mapFeatures": {
    "simpleFeatures": [
      "FLATTEN_BUILDINGS",
      "ICONIC_ICONS"
    ],
    "poiBoostLevel": 1
  },
  "createTime": "2026-02-07T20:04:11.467243390Z",
  "updateTime": "2026-02-07T20:04:11.467243542Z",
  "mapType": "VECTOR"
}

דוגמה: מחיקת MapConfig

בדוגמה הבאה מוצג אופן המחיקה של אובייקט MapConfig באמצעות curl. כששולחים את הבקשה הזו, מקבלים אובייקט JSON ריק {} בתגובה אם נמצא MapConfig והוא נמחק בהצלחה.

curl -X DELETE \
-H 'X-Goog-User-Project: YOUR_PROJECT_NUMBER' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_NUMBER/mapConfigs/YOUR_MAP_CONFIG_ID

אם הבקשה מצליחה, מקבלים אובייקט תגובה ריק: 

{}

איך מוצאים את מספר הפרויקט

כדי לקבל את המספר או המזהה של הפרויקט ב-Google Cloud:

  1. נכנסים לדף הסקירה הכללית של הפרויקט במסוף Cloud.
  2. מספר הפרויקט ומזהה הפרויקט מופיעים באזור Project info.

איך מקבלים טוקן OAuth

לצורך פיתוח או בדיקה, אפשר להשתמש ב-CLI של gcloud כדי ליצור טוקן OAuth זמני:

gcloud auth application-default print-access-token

אפשר לכלול את הפקודה gcloud ישירות בכותרת Authorization של בקשת curl, כמו בדוגמאות שמופיעות למעלה. אפשר גם להגדיר משתנה סביבה:

export TOKEN=$(gcloud auth application-default print-access-token)
curl -X GET \
-H 'X-Goog-User-Project: YOUR_PROJECT_NUMBER' \
-H "Authorization: Bearer $TOKEN" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_NUMBER/mapConfigs