پارامترهای درخواستی مورد نیاز

برای ارسال هرگونه درخواست به API مدیریت نقشه، باید موارد زیر را در هدرها و URL های خود وارد کنید:

  • شناسه پروژه : شماره پروژه یا شناسه پروژه Google Cloud شما در سربرگ X-Goog-User-Project . این مقدار، پروژه مورد استفاده برای محاسبات صورتحساب و سهمیه را تعیین می‌کند.

  • سربرگ مجوز : یک توکن OAuth 2.0 در سربرگ Authorization . برای اطلاعات بیشتر، به بخش «استفاده از OAuth» مراجعه کنید.

  • نام منبع : شماره یا شناسه پروژه گوگل کلود در 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
  }
}'

اگر درخواست موفقیت‌آمیز باشد، شیء Map Config تازه ایجاد شده را دریافت می‌کنید:

{
  "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 نشان می‌دهد. وقتی این درخواست را ارسال می‌کنید، در صورت یافتن و حذف موفقیت‌آمیز MapConfig، یک شیء JSON خالی {} در پاسخ دریافت خواهید کرد.

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. شماره پروژه و شناسه پروژه در قسمت اطلاعات پروژه نمایش داده می‌شوند.

یک توکن OAuth دریافت کنید

برای توسعه یا آزمایش، می‌توانید از رابط خط فرمان 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