دليل ومثالان على Map Management API

يمكنك استخدام Map Management API لإدارة موارد تصميم الخرائط باستخدام السحابة الإلكترونية آليًا من خلال نقطتَي النهاية v2alpha (تجريبية) وv2beta (نسخة حصرية).

ملخّص العمليات

لعرض خريطة مخصّصة باستخدام Map Management API، اتّبِع الخطوات الرئيسية التالية:

1. إنشاء StyleConfig: حدِّد المظهر المرئي لخريطتك باستخدام تمثيل JSON لإعدادات الألوان ومستوى العرض والكثافة.
2. إنشاء MapConfig: أنشئ معرّف خريطة فريدًا يعمل كحاوية لهوية خريطتك وميزاتها العالية المستوى.
3. ربطها بـ MapContextConfig: يمكنك ربط StyleConfig (ومجموعات البيانات الاختيارية) بنُسخ معيّنة من الخريطة (مثل ROADMAP أو SATELLITE) ضمن MapConfig.

الإعدادات التلقائية

عند استخدام نقاط النهاية في الإصدار 2، يُرجى مراعاة الإعدادات التلقائية التالية:

• نوع الخريطة: نوع عرض الخريطة التلقائي هو RASTER. لاستخدام الخرائط المستندة إلى المتجهات، يجب ضبط map_type على VECTOR بشكل صريح في MapConfig.
• Map Variant: في حال عدم تحديد أي map_variants عند إنشاء MapContextConfig، سيتم تطبيق الإعدادات على الصيغة ROADMAP فقط بشكل تلقائي.
• النمط الأساسي: إذا كان json_style_sheet فارغًا أو لم يتم توفيره في StyleConfig، سيتم استخدام الخريطة الأساسية التلقائية من Google بدون نمط.

التعامل مع StyleConfigs

يحتوي StyleConfig على تعريفات الأنماط المستندة إلى JSON.

إنشاء StyleConfig

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/styleConfigs \
-d '{
  "display_name": "My Custom Style",
  "json_style_sheet": "[{\"featureType\":\"all\",\"stylers\":[{\"saturation\":-100}]}]"
}'

عرض StyleConfigs

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/styleConfigs

العمل باستخدام MapConfigs

يحدّد MapConfig الهوية ونوع العرض الأساسي للخريطة.

إنشاء MapConfig

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/mapConfigs \
-d '{
  "display_name": "My New Map",
  "map_type": "VECTOR"
}'

العمل باستخدام MapContextConfigs

يربط MapContextConfig التنسيق بـ MapConfig.

إنشاء MapContextConfig

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/mapConfigs/YOUR_MAP_ID/mapContextConfigs \
-d '{
  "style_config": "projects/YOUR_PROJECT_ID/styleConfigs/YOUR_STYLE_ID",
  "map_variants": ["ROADMAP", "NAVIGATION"]
}'

الأخطاء

• PERMISSION_DENIED: لا يتضمّن الطلب أذونات كافية لإدارة الهوية وإمكانية الوصول أو لم يتم تفعيل واجهة برمجة التطبيقات في المشروع.
• NOT_FOUND: المورد المحدّد (Project أو MapConfig أو StyleConfig) غير موجود.
• ‫INVALID_ARGUMENT: نص الطلب مكتوب بشكل غير صحيح أو يحتوي على قيم حقول غير صالحة.