شما میتوانید از API مدیریت نقشه برای مدیریت برنامهریزیشدهی منابع طراحی نقشههای مبتنی بر ابر خود در هر دو نقطهی پایانی v2alpha (آزمایشی) و v2beta (پیشنمایش) استفاده کنید.
خلاصه عملیات
برای تجسم یک نقشه سفارشی با API مدیریت نقشه، این مراحل کلیدی را دنبال کنید:
- ایجاد StyleConfig : ظاهر بصری نقشه خود را با استفاده از نمایش JSON از تنظیمات رنگ، قابلیت مشاهده و تراکم تعریف کنید.
- ایجاد MapConfig : یک Map ID منحصر به فرد ایجاد کنید که به عنوان ظرفی برای هویت نقشه و ویژگیهای سطح بالای شما عمل کند.
- آنها را با MapContextConfig مرتبط کنید :
StyleConfig(و مجموعه دادههای اختیاری) خود را به انواع خاص نقشه (مانندROADMAPیاSATELLITE) درMapConfigخود پیوند دهید.
رفتارهای پیشفرض
هنگام استفاده از نقاط پایانی v2، رفتارهای پیشفرض زیر را در نظر داشته باشید:
- نوع نقشه : نوع رندر نقشه پیشفرض
RASTERاست. برای استفاده از نقشههای مبتنی بر بردار، باید درMapConfigخود،map_typeصریحاً رویVECTORتنظیم کنید. - نوع نقشه : اگر هنگام ایجاد
MapContextConfigهیچmap_variantsمشخص نشده باشد، پیکربندی به طور پیشفرض فقط روی نوعROADMAPاعمال میشود. - استایلدهی پایه : اگر
json_style_sheetخالی باشد یا درStyleConfigارائه نشده باشد، از نقشه پیشفرض بدون استایل Google Base استفاده خواهد شد.
کار با 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}]}]"
}'پیکربندیهای سبک لیست
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/styleConfigs
کار با MapConfig ها
یک 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 : بدنه درخواست ناقص است یا حاوی مقادیر فیلد نامعتبر است.