Maps JavaScript एपीआई के पैरामीटर

इस दस्तावेज़ में उन सभी पैरामीटर के बारे में बताया गया है, जिन्हें Maps JavaScript API लोड करते समय स्क्रिप्ट लोड होने वाले यूआरएल की क्वेरी स्ट्रिंग में डाला जा सकता है. कुछ पैरामीटर ज़रूरी हैं, जबकि कुछ ज़रूरी नहीं हैं. जैसा कि यूआरएल में स्टैंडर्ड होता है, सभी पैरामीटर को एंपरसैंड (&) वर्ण का इस्तेमाल करके अलग किया जाता है.

नीचे दिए गए उदाहरण के यूआरएल में सभी संभावित पैरामीटर के लिए प्लेसहोल्डर हैं:

https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY
&callback=FUNCTION_NAME
&v=VERSION
&libraries="LIBRARIES"
&language="LANGUAGE"
&region="REGION"
&solution_channel="SOLUTION_IDENTIFIER"
&auth_referrer_policy="AUTH_REFERRER_POLICY"

यहां दिए गए उदाहरण script के टैग में मौजूद यूआरएल, Maps JavaScript एपीआई को लोड करता है:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
</script>

ज़रूरी पैरामीटर

Maps JavaScript API को लोड करते समय ये पैरामीटर ज़रूरी हैं.

  • key: आपकी एपीआई कुंजी. Maps API एपीआई तब तक लोड नहीं होगा, जब तक मान्य एपीआई कुंजी तय नहीं की जाती.

  • callback: 'मैप JavaScript एपीआई' के पूरी तरह से लोड हो जाने के बाद, किए जाने वाले ग्लोबल फ़ंक्शन का नाम.

ज़रूरी नहीं पैरामीटर

मैप JavaScript API के किसी खास वर्शन का अनुरोध करने, अतिरिक्त लाइब्रेरी लोड करने, अपने मैप को स्थानीय भाषा में बदलने या एचटीटीपी रेफ़रलकर्ता जांच नीति तय करने के लिए इन पैरामीटर का इस्तेमाल करें

  • vMaps JavaScript API का वर्शन इस्तेमाल करने के लिए.

  • libraries लोड करने के लिए, Maps JavaScript एपीआई की लाइब्रेरी की कॉमा लगाकर अलग की गई सूची.

  • language: इस्तेमाल की जाने वाली भाषा. इससे कंट्रोल के नाम, कॉपीराइट की सूचनाओं, ड्राइविंग के दिशा-निर्देशों, और कंट्रोल लेबल के साथ-साथ सेवा के अनुरोधों के जवाबों पर भी असर पड़ता है. इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें.

  • region: इस्तेमाल करने के लिए region कोड. यह दिए गए देश या क्षेत्र के आधार पर मैप के व्यवहार को बदलता है.

  • solution_channel Google Maps Platform कई तरह के सैंपल कोड उपलब्ध कराता है, ताकि आप तेज़ी से काम कर सकें. Google के ज़्यादा कॉम्प्लेक्स कोड सैंपल को अपनाने और समाधान की क्वालिटी को ट्रैक करने के लिए, Google अपने सैंपल कोड में एपीआई कॉल में solution_channel क्वेरी पैरामीटर शामिल करता है.

  • auth_referrer_policy: Maps JS के ग्राहक, Cloud Console में एचटीटीपी रेफ़रल देने वाले प्रतिबंधों को कॉन्फ़िगर कर सकते हैं. इससे वे यह सीमित कर सकते हैं कि किन यूआरएल को किसी खास एपीआई कुंजी का इस्तेमाल करने की अनुमति दी जाए. डिफ़ॉल्ट रूप से, इन प्रतिबंधों को इस तरह कॉन्फ़िगर किया जा सकता है कि वे API कुंजी का इस्तेमाल करने के लिए सिर्फ़ कुछ पाथ दें. अगर एक ही डोमेन या शुरुआत की जगह पर मौजूद कोई यूआरएल एपीआई कुंजी का इस्तेमाल कर सकता है, तो आप मैप JavaScript एपीआई के अनुरोधों को अनुमति देते समय भेजे जाने वाले डेटा को सीमित करने के लिए auth_referrer_policy=origin को सेट कर सकते हैं. यह 3.46 वर्शन में उपलब्ध है. अगर इस पैरामीटर की जानकारी दी जाती है और Cloud Console पर एचटीटीपी रेफ़रर पाबंदियां चालू की जाती हैं, तो Maps JavaScript API सिर्फ़ तब लोड होगा, जब एचटीटीपी यूआरएल का कोई प्रतिबंध होगा, जो मौजूदा वेबसाइट के डोमेन से मेल खाता हो. साथ ही, इसमें कोई पाथ न बताया गया हो.