راهنما و نمونه‌های Map Management API

می‌توانید از Map Management API برای مدیریت برنامه‌نویسی‌شده منابع سبک‌پردازی نقشه بااستفاده از فضای ابری در هر دو نقطه پایانی v2alpha (آزمایشی) و v2beta (پیش‌نمایش) استفاده کنید.

خلاصه فعالیت‌ها

برای تجسم نقشه سفارشی با Map Management API، این مراحل کلیدی را دنبال کنید:

1. ایجاد StyleConfig: ظاهر دیداری نقشه‌تان را بااستفاده از نمایش JSON رنگ‌ها، نمایان بودن، و تنظیمات تراکم تعریف کنید.
2. ایجاد MapConfig: یک شناسه نقشه منحصربه‌فرد ایجاد کنید که به‌عنوان ظرفی برای هویت و ویژگی‌های سطح بالای نقشه شما عمل می‌کند.
3. آن‌ها را با MapContextConfig مرتبط کنید: StyleConfig (و مجموعه‌داده‌های اختیاری) خود را به انواع نقشه خاص (مانند ROADMAP یا SATELLITE) در MapConfig خود پیوند دهید.

رفتارهای پیش‌فرض

هنگام استفاده از نقاط پایانی نسخه ۲، رفتارهای پیش‌فرض زیر را درنظر داشته باشید:

• نوع نقشه: نوع پیش‌فرض پرداز نقشه RASTER است. برای استفاده از نقشه‌های برداری، باید صریحاً map_type را روی VECTOR در MapConfig خود تنظیم کنید.
• متغیر نقشه: اگر هنگام ایجاد MapContextConfig هیچ map_variants مشخص نشده باشد، پیکربندی به‌طور پیش‌فرض فقط بر متغیر 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 است یا API برای پروژه فعال نشده است.
• NOT_FOUND: منبع مشخص‌شده (Project،‏ MapConfig، یا StyleConfig) وجود ندارد.
• INVALID_ARGUMENT: بدنه درخواست بدشکل است یا حاوی مقادیر فیلد نامعتبر است.