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

لإجراء أي طلب إلى 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/v2beta/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/v2beta/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/v2beta/projects/YOUR_PROJECT_NUMBER/mapConfigs