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

لإرسال أي طلب إلى 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 Console.
  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