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

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