معلَمات الطلب المطلوبة

لإرسال أي طلب إلى 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/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. عند إرسال هذا الطلب، ستتلقّى عنصر 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/v2/projects/YOUR_PROJECT_NUMBER/mapConfigs/YOUR_MAP_CONFIG_ID

في حال نجاح الطلب، ستتلقّى عنصر استجابة فارغًا: 

{}

الحصول على رقم المشروع

للحصول على رقم تعريف مشروعك على Google Cloud، اتّبِع الخطوات التالية:

  1. انتقِل إلى صفحة "نظرة عامة" الخاصة بالمشروع في وحدة تحكّم Cloud.
  2. يظهر رقم المشروع ورقم تعريف المشروع في منطقة معلومات المشروع.

الحصول على رمز 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/v2/projects/YOUR_PROJECT_NUMBER/mapConfigs