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

لإجراء أي طلب إلى 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 المميز

لأغراض التطوير أو الاختبار، يمكنك استخدام واجهة سطر الأوامر 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