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

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

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

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

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

السلوكيات التلقائية

عند استخدام نقطتَي النهاية v2، يُرجى مراعاة السلوكيات التلقائية التالية:

  • نوع الخريطة: نوع عرض الخريطة التلقائي هو RASTER. لاستخدام الخرائط المستندة إلى المتجهات، عليك ضبط map_type على VECTOR بشكلٍ صريح في MapConfig.
  • متغيّر الخريطة: إذا لم يتم تحديد 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: لا يتضمّن الطلب أذونات IAM كافية أو أنّ واجهة برمجة التطبيقات غير مفعّلة في المشروع.
  • NOT_FOUND: المورد المحدّد (المشروع أو MapConfig أو StyleConfig) غير موجود.
  • INVALID_ARGUMENT: نص الطلب غير صالح أو يحتوي على قيم حقول غير صالحة.