Map Management API की गाइड और उदाहरण

Map Management API का इस्तेमाल करके, प्रोग्राम के हिसाब से, अपने-आप होने वाली प्रोसेस के ज़रिए क्लाउड पर मैप की स्टाइलिंग से जुड़े संसाधनों को मैनेज किया जा सकता है. ऐसा v2alpha (एक्सपेरिमेंट के तौर पर उपलब्ध) और v2beta (प्रीव्यू) दोनों एंडपॉइंट पर किया जा सकता है.

कारोबार और उससे जुड़े कामों के बारे में खास जानकारी

Map Management API की मदद से, कस्टम मैप को विज़ुअलाइज़ करने के लिए, यह तरीका अपनाएं:

1. StyleConfig बनाएं: रंगों, दिखने की स्थिति, और घनत्व की सेटिंग के JSON फ़ॉर्मैट का इस्तेमाल करके, मैप के विज़ुअल को तय करें.
2. MapConfig बनाना: एक यूनीक मैप आईडी बनाएं. यह आपके मैप की पहचान और बेहतर सुविधाओं के लिए कंटेनर के तौर पर काम करता है.
3. उन्हें MapContextConfig से जोड़ें: अपने StyleConfig (और वैकल्पिक डेटासेट) को अपने MapConfig में मौजूद मैप के अलग-अलग वर्शन (जैसे कि ROADMAP या SATELLITE) से लिंक करें.

डिफ़ॉल्ट बिहेवियर

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}]}]"
}'

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: अनुरोध का मुख्य हिस्सा गलत तरीके से बनाया गया है या इसमें फ़ील्ड की अमान्य वैल्यू शामिल हैं.