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

برای ارسال هرگونه درخواست به Map Management API، باید موارد زیر را در سرصفحه‌ها و نشانی‌های وب خود اضافه کنید:

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

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

  • نام منبع: شماره یا شناسه پروژه Google Cloud در نشانی وب درخواست، به‌همراه شناسه منبع خاص (مانند 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/v2/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/v2/projects/YOUR_PROJECT_NUMBER/mapConfigs/YOUR_MAP_CONFIG_ID

اگر درخواست موفقیت‌آمیز باشد، شیء پاسخ خالی دریافت می‌کنید: 

{}

دریافت شماره پروژه

برای دریافت شماره یا شناسه پروژه Google Cloud:

  1. به صفحه نمای کلی پروژه در کنسول Cloud بروید.
  2. شماره پروژه و شناسه پروژه در بخش اطلاعات پروژه نشان داده می‌شود.

دریافت کد OAuth

برای توسعه یا آزمایش، می‌توانید از gcloud CLI برای تولید کردن یک 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/v2/projects/YOUR_PROJECT_NUMBER/mapConfigs