Map Management API के बारे में खास जानकारी

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 क्लाउड प्रोजेक्ट में Google Maps Platform के संसाधनों को मैनेज करने के लिए, ज़रूरी IAM अनुमतियां होनी चाहिए.
  • संसाधन का दायरा: यह एपीआई, क्लाउड पर मैप की स्टाइलिंग से जुड़े संसाधनों को मैनेज करने पर फ़ोकस करता है. Google Maps Platform के अन्य कॉन्फ़िगरेशन के लिए, अब भी Cloud Console की ज़रूरत पड़ सकती है.

लागत

Map Management API का इस्तेमाल करने के लिए कोई शुल्क नहीं लिया जाता. एपीआई कॉल, Cloud Console में बिलिंग पेज पर दिखती हैं. हालांकि, इनके लिए कोई शुल्क नहीं लिया जाएगा. हालांकि, अनुरोधों पर ये पाबंदियां लागू होती हैं:

  • 3 क्यूपीएस (क्वेरी प्रति सेकंड)
  • किसी प्रोजेक्ट के लिए 180 क्यूपीएम (क्वेरी प्रति मिनट). यह हर मिनट रीफ़्रेश होता है
  • किसी प्रोजेक्ट के लिए 1,00, 000 क्यूपीडी (क्वेरी प्रति दिन). यह हर दिन रीफ़्रेश होता है

इस्तेमाल और बिलिंग लेख पढ़ें.