Map Management API एक RESTful API है. इसका इस्तेमाल करके, क्लाउड पर मैप की स्टाइलिंग से जुड़े संसाधनों को प्रोग्राम के हिसाब से मैनेज किया जा सकता है. इस एपीआई की मदद से, Cloud Console का इस्तेमाल किए बिना ये काम किए जा सकते हैं: मैप के विज़ुअल को तय करना, मैप की पहचान मैनेज करना, और मैप के अलग-अलग वर्शन के साथ कस्टम स्टाइल और डेटासेट जोड़ना.
Map Management API को उन डेवलपर के लिए डिज़ाइन किया गया है जो मैप कॉन्फ़िगरेशन को बड़े पैमाने पर मैनेज करना चाहते हैं. इसके अलावा, वे मैप स्टाइलिंग को अपने-आप काम करने वाले वर्कफ़्लो और इंटरनल टूल में इंटिग्रेट करना चाहते हैं.
मुख्य संसाधन
- StyleConfig: इसमें मैप की स्टाइल का JSON फ़ॉर्मैट होता है. इससे मैप की सुविधाओं के रंग, दिखने की स्थिति, और घनत्व तय होता है.
- MapConfig: यह मैप की यूनीक आइडेंटिटी (मैप आईडी) को दिखाता है. यह स्टाइलिंग सेटिंग और सुविधाओं के लिए कंटेनर के तौर पर काम करता है. जैसे, पीओएस बूस्टिंग या बिल्डिंग फ़्लैटनिंग.
- MapContextConfig: यह
MapConfigमें मौजूद किसीMapVariantsके साथStyleConfigऔर ज़रूरत पड़ने पर एक या उससे ज़्यादा डेटासेट को असोसिएट करता है.
एपीआई वर्शनिंग चैनल
Map Management API, चैनल पर आधारित वर्शनिंग का इस्तेमाल करता है. इससे एक्सपेरिमेंट के तौर पर उपलब्ध सुविधाओं को स्टेबल वर्शन में सामान्य रूप से उपलब्ध कराने का तरीका साफ़ तौर पर पता चलता है.
- v2alpha (एक्सपेरिमेंट के तौर पर उपलब्ध): इसमें एक्सपेरिमेंट के तौर पर उपलब्ध नई सुविधाएं शामिल हैं. इस चैनल में मौजूद सुविधाओं में बिना सूचना दिए बदलाव किया जा सकता है. साथ ही, प्रोडक्शन के लिए इनका इस्तेमाल करने का सुझाव नहीं दिया जाता.
- v2beta (झलक): इसमें ऐसी सुविधाएं शामिल हैं जो स्टेबल हैं और सामान्य तौर पर उपलब्ध होने के लिए तैयार की जा रही हैं. यह चैनल, प्री-प्रोडक्शन एनवायरमेंट में जल्दी अपनाने और टेस्टिंग के लिए सही है.
- v2 (सभी के लिए उपलब्ध): इसमें पूरी तरह से काम करने वाली और प्रोडक्शन के लिए तैयार सुविधाएं शामिल हैं.
v2 की ज़्यादातर सुविधाएं, रोल आउट के अलग-अलग चरणों के दौरान v2alpha और v2beta, दोनों एंडपॉइंट पर उपलब्ध होती हैं. नए उपयोगकर्ताओं के लिए, Google v2beta एंडपॉइंट से शुरुआत करने का सुझाव देता है.
पुष्टि करना
Map Management API के साथ पुष्टि करने के लिए, सिर्फ़ OAuth 2.0 का इस्तेमाल किया जा सकता है. यह एपीआई पासकोड के साथ काम नहीं करता. ज़्यादा जानकारी के लिए, OAuth का इस्तेमाल करना लेख पढ़ें.
सीमाएं
- डेवलपर की भूमिकाएं: Map Management API का इस्तेमाल करने के लिए, आपके पास ज़रूरी आईएएम अनुमतियां होनी चाहिए. इनकी मदद से, Google Cloud प्रोजेक्ट में Google Maps Platform के संसाधनों को मैनेज किया जा सकता है.
- संसाधन का दायरा: यह एपीआई, क्लाउड पर आधारित मैप स्टाइलिंग संसाधनों को मैनेज करने पर फ़ोकस करता है. Google Maps Platform के अन्य कॉन्फ़िगरेशन के लिए, अब भी Cloud Console की ज़रूरत पड़ सकती है.
लागत
Map Management API का इस्तेमाल करने के लिए कोई शुल्क नहीं देना पड़ता. एपीआई कॉल, Cloud Console में Billing पेज पर दिखते हैं. हालांकि, इसके लिए कोई शुल्क नहीं लिया जाएगा. हालांकि, अनुरोधों पर ये पाबंदियां लागू होती हैं:
- 3 क्यूपीएस (क्वेरी प्रति सेकंड)
- किसी प्रोजेक्ट के लिए, हर मिनट 180 क्वेरी. यह सीमा हर मिनट रीफ़्रेश होती है
- किसी प्रोजेक्ट के लिए, हर दिन 1,00,000 क्वेरी का कोटा. यह कोटा हर दिन रीफ़्रेश होता है
इस्तेमाल और बिलिंग लेख पढ़ें.