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

Map Management API एक RESTful API है. इसका इस्तेमाल करके, क्लाउड पर मैप की स्टाइलिंग के संसाधनों को प्रोग्राम के हिसाब से मैनेज किया जा सकता है. इस एपीआई की मदद से, अपने मैप के विज़ुअल तय किए जा सकते हैं, मैप आइडेंटिटी मैनेज की जा सकती हैं, और पसंद के मुताबिक स्टाइल और डेटासेट को मैप के खास वैरिएंट से जोड़ा जा सकता है. इसके लिए, आपको Cloud Console का इस्तेमाल करने की ज़रूरत नहीं है.

Map Management API को उन डेवलपर के लिए डिज़ाइन किया गया है जो बड़े पैमाने पर मैप कॉन्फ़िगरेशन मैनेज करना चाहते हैं. इसके अलावा, यह उन डेवलपर के लिए भी है जो मैप स्टाइलिंग को अपने ऑटोमेटेड वर्कफ़्लो और इंटरनल टूल में इंटिग्रेट करना चाहते हैं.

मुख्य संसाधन

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

एपीआई वर्शनिंग चैनल

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 में बिलिंग पेज पर दिखते हैं. हालांकि, इनके लिए कोई शुल्क नहीं लिया जाता. हालांकि, अनुरोधों पर ये पाबंदियां लागू होती हैं:

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

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