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

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

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

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

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

डिफ़ॉल्ट ऐक्शन और सेटिंग

v2 एंडपॉइंट का इस्तेमाल करते समय, इन डिफ़ॉल्ट ऐक्शन और सेटिंग का ध्यान रखें:

  • मैप का टाइप: मैप रेंडर करने का डिफ़ॉल्ट टाइप RASTER है. वेक्टर पर आधारित मैप इस्तेमाल करने के लिए, आपको अपने MapConfig में map_type को साफ़ तौर पर VECTOR पर सेट करना होगा.
  • मैप वैरिएंट: अगर 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: अनुरोध के पास ज़रूरी आईएएम अनुमतियां नहीं हैं या प्रोजेक्ट के लिए एपीआई चालू नहीं है.
  • NOT_FOUND: बताया गया संसाधन (प्रोजेक्ट, MapConfig या StyleConfig) मौजूद नहीं है.
  • INVALID_ARGUMENT: अनुरोध का मुख्य हिस्सा गलत तरीके से बनाया गया है या उसमें फ़ील्ड की अमान्य वैल्यू शामिल हैं.