Map Management API का इस्तेमाल करके, क्लाउड पर आधारित मैप की स्टाइलिंग से जुड़े संसाधनों को प्रोग्राम की मदद से मैनेज किया जा सकता है. इसके लिए, v2alpha (एक्सपेरिमेंटल) और v2beta (प्रीव्यू) दोनों एंडपॉइंट का इस्तेमाल किया जा सकता है.
कार्रवाइयों की खास जानकारी
Map Management API की मदद से, कस्टम मैप को विज़ुअलाइज़ करने के लिए, यह तरीका अपनाएं:
- StyleConfig बनाएं: रंगों, दिखने की सेटिंग, और डेंसिटी सेटिंग के JSON फ़ॉर्मैट का इस्तेमाल करके, अपने मैप के विज़ुअल अपीयरेंस को तय करें.
- MapConfig बनाएं: एक यूनीक मैप आईडी बनाएं. यह आईडी, आपके मैप की पहचान और हाई-लेवल की सुविधाओं के लिए कंटेनर के तौर पर काम करता है.
- इन्हें MapContextConfig से जोड़ें: अपने
MapConfigमें,StyleConfig(और ज़रूरी नहीं कि डेटासेट) को मैप के खास वैरिएंट (जैसे,ROADMAPयाSATELLITE) से लिंक करें.
डिफ़ॉल्ट सेटिंग
v2 एंडपॉइंट का इस्तेमाल करते समय, इन डिफ़ॉल्ट सेटिंग का ध्यान रखें:
- मैप का टाइप: मैप रेंडर करने का डिफ़ॉल्ट टाइप
RASTERहै. वेक्टर पर आधारित मैप का इस्तेमाल करने के लिए, आपको अपनेMapConfigमेंmap_typeको साफ़ तौर परVECTORपर सेट करना होगा. - मैप का वैरिएंट: अगर
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: अनुरोध का मुख्य भाग गलत फ़ॉर्मैट में है या इसमें फ़ील्ड की अमान्य वैल्यू शामिल हैं.