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

برای ارسال هرگونه درخواست به 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
  }
}'

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

{
  "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