Class Maps

Maps

इस एपीआई की मदद से, दिशाओं का पता लगाया जा सकता है, जियोकोडिंग की जा सकती है, ऊंचाई के सैंपल लिए जा सकते हैं, और स्टैटिक मैप इमेज बनाई जा सकती हैं.

प्रॉपर्टी

प्रॉपर्टी	टाइप	ब्यौरा
DirectionFinder	DirectionFinderEnums
StaticMap	StaticMapEnums

तरीके

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
decodePolyline(polyline)	Number[]	यह फ़ंक्शन, कोड में बदली गई पॉलीलाइन स्ट्रिंग को वापस पॉइंट के ऐरे में बदलता है.
encodePolyline(points)	String	यह फ़ंक्शन, पॉइंट के किसी ऐरे को स्ट्रिंग में बदलता है.
newDirectionFinder()	DirectionFinder	यह DirectionFinder ऑब्जेक्ट बनाता है.
newElevationSampler()	ElevationSampler	ElevationSampler ऑब्जेक्ट बनाता है.
newGeocoder()	Geocoder	यह नया Geocoder ऑब्जेक्ट बनाता है.
newStaticMap()	StaticMap	यह एक नया StaticMap ऑब्जेक्ट बनाता है.
resetAuthenticationApiKey()	void	यह पुष्टि करने के क्रेडेंशियल को रीसेट करता है, ताकि कोटे की डिफ़ॉल्ट सीमा का इस्तेमाल किया जा सके.
setAuthenticationByApiKey(apiKey)	void	इस कुकी की मदद से, एपीआई पासकोड का इस्तेमाल करके अनुरोधों की पुष्टि की जा सकती है, ताकि अतिरिक्त कोटा का फ़ायदा लिया जा सके.
setAuthenticationByApiKey(apiKey, signingKey)	void	इस अनुमति से, एपीआई पासकोड और साइनिंग की का इस्तेमाल करके, StaticMap में अतिरिक्त कोटा का फ़ायदा पाने के लिए अनुरोधों की पुष्टि की जा सकती है.

ऐसे तरीके जिन्हें अब इस्तेमाल नहीं किया जा सकता

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
setAuthentication(clientId, signingKey)	void	इस कुकी की मदद से, Google Maps APIs Premium Plan के किसी बाहरी खाते का इस्तेमाल किया जा सकता है, ताकि कोटा अनुमतियों का ज़्यादा फ़ायदा लिया जा सके.

ज़्यादा जानकारी वाला दस्तावेज़

decodePolyline(polyline)

यह फ़ंक्शन, कोड में बदली गई पॉलीलाइन स्ट्रिंग को वापस पॉइंट के ऐरे में बदलता है.

// Decodes a string representation of the latitudes and longitudes of
// Minneapolis and Milwaukee respectively.
const polyline = 'qvkpG`qhxPbgyI_zq_@';
const points = Maps.decodePolyline(polyline);
for (let i = 0; i < points.length; i += 2) {
  Logger.log('%s, %s', points[i], points[i + 1]);
}

पैरामीटर

नाम	टाइप	ब्यौरा
polyline	String	डिकोड करने के लिए, कोड में बदली गई पॉलीलाइन.

वापसी का टिकट

Number[] — अक्षांश और देशांतर की जोड़ियों का एक कलेक्शन (lat0, long0, lat1, long1, ...).

इन्हें भी देखें

• कोड में बदले गए पॉलीलाइन फ़ॉर्मैट

---

encodePolyline(points)

यह फ़ंक्शन, पॉइंट के किसी ऐरे को स्ट्रिंग में बदलता है.

// The latitudes and longitudes of New York and Boston respectively.
const points = [40.77, -73.97, 42.34, -71.04];
const polyline = Maps.encodePolyline(points);

पैरामीटर

नाम	टाइप	ब्यौरा
points	Number[]	अक्षांश/देशांतर की जोड़ियों का ऐसा कलेक्शन जिसे कोड में बदला जाना है.

वापसी का टिकट

String — यह एक कोड में बदली गई स्ट्रिंग है, जो उन पॉइंट को दिखाती है.

इन्हें भी देखें

• कोड में बदले गए पॉलीलाइन फ़ॉर्मैट

---

newDirectionFinder()

यह DirectionFinder ऑब्जेक्ट बनाता है.

वापसी का टिकट

DirectionFinder — यह दिशा ढूंढने वाला नया ऑब्जेक्ट है.

---

newElevationSampler()

ElevationSampler ऑब्जेक्ट बनाता है.

वापसी का टिकट

ElevationSampler — ऊंचाई के बारे में जानकारी देने वाला नया ऑब्जेक्ट.

---

newGeocoder()

यह नया Geocoder ऑब्जेक्ट बनाता है.

वापसी का टिकट

Geocoder — यह एक नया जियोकोडर ऑब्जेक्ट है.

---

newStaticMap()

यह एक नया StaticMap ऑब्जेक्ट बनाता है.

वापसी का टिकट

StaticMap — एक नया स्टैटिक मैप ऑब्जेक्ट.

---

resetAuthenticationApiKey()

यह पुष्टि करने के क्रेडेंशियल को रीसेट करता है, ताकि कोटे की डिफ़ॉल्ट सीमा का इस्तेमाल किया जा सके. यह तरीका तब काम करता है, जब अनुरोधों की पुष्टि करने के लिए एपीआई पासकोड का इस्तेमाल किया जा रहा हो. अगर आपको पुष्टि करने के क्रेडेंशियल दिए बिना Maps के तरीकों का इस्तेमाल करना है, तो इस तरीके का इस्तेमाल करके डिफ़ॉल्ट कोटा की अनुमतियों पर वापस जाया जा सकता है.

Maps.resetAuthenticationApiKey();

थ्रॉ

Error — अगर पुष्टि करने के लिए setAuthentication(clientId, signingKey) का इस्तेमाल किया जा रहा है.

---

setAuthenticationByApiKey(apiKey)

इस कुकी की मदद से, एपीआई पासकोड का इस्तेमाल करके अनुरोधों की पुष्टि की जा सकती है, ताकि अतिरिक्त कोटा का फ़ायदा लिया जा सके.

इस तरीके का इस्तेमाल, एपीआई पासकोड सेट करने के लिए किया जाता है. इसका इस्तेमाल अनुरोधों की पुष्टि करने के लिए किया जाता है. इस तरीके को कॉल करने पर, कोटे का इस्तेमाल और बिलिंग, कीमत की जानकारी देने वाली शीट के मुताबिक, दिए गए एपीआई पासकोड से जुड़े Google Cloud प्रोजेक्ट से ली जाती है. पुष्टि करने के क्रेडेंशियल दिए बिना, डिफ़ॉल्ट कोटा के साथ Maps तरीकों का इस्तेमाल किया जा सकता है. StaticMap का इस्तेमाल करने पर, कृपया setAuthenticationByApiKey(apiKey, signingKey) तरीके का इस्तेमाल करें.

ध्यान दें: अगर अनुरोधों की पुष्टि करने के लिए क्लाइंट आईडी का इस्तेमाल किया जा रहा है, तो कृपया ध्यान दें कि क्लाइंट आईडी का इस्तेमाल 26 मई, 2025 से बंद कर दिया गया है. इसका इस्तेमाल 31 मई, 2026 के बाद नहीं किया जा सकेगा. Google Maps API सेवा के ट्रैफ़िक की पुष्टि करने के लिए, क्लाइंट आईडी के बजाय एपीआई पासकोड क्रेडेंशियल का इस्तेमाल करना ज़रूरी है. ज़्यादा जानकारी के लिए, गाइड देखें.

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0');

पैरामीटर

नाम	टाइप	ब्यौरा
apiKey	String	एपीआई पासकोड, जिसे Google Cloud Console से हासिल किया जा सकता है. इसके लिए, क्विकस्टार्ट गाइड में दिया गया तरीका अपनाएं.

थ्रॉ

Error — अगर apiKey null है या अगर setAuthentication(clientId, signingKey) का इस्तेमाल पहले से ही पुष्टि करने के लिए किया जा रहा है

---

setAuthenticationByApiKey(apiKey, signingKey)

इस अनुमति से, एपीआई पासकोड और साइनिंग की का इस्तेमाल करके, StaticMap में अतिरिक्त कोटा का फ़ायदा पाने के लिए अनुरोधों की पुष्टि की जा सकती है. Static Map API के अनुरोधों के लिए signingKey ज़रूरी है. हालांकि, इस तरीके का इस्तेमाल Maps की अन्य सेवाओं की पुष्टि करने के लिए भी किया जा सकता है. ऐसे मामलों में, signingKey पैरामीटर को अनदेखा कर दिया जाता है.

इस तरीके का इस्तेमाल, एपीआई कुंजी और साइनिंग की सेट करने के लिए किया जाता है. इसका इस्तेमाल अनुरोधों की पुष्टि करने के लिए किया जाता है. StaticMap के लिए, हस्ताक्षर करने वाली कुंजी ज़रूरी होती है. यह टेस्टिंग के मकसद से, बिना हस्ताक्षर वाले कुछ अनुरोधों को स्वीकार करता है. हालांकि, प्रोडक्शन में थ्रेशोल्ड तक पहुंचने के बाद, ये अनुरोध पूरे नहीं होते. इसके बारे में ज़्यादा जानकारी यहां मिल सकती है.

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0',
'7_pry-Skg0PKxds-7nvdl91mB5=');

पैरामीटर

नाम	टाइप	ब्यौरा
apiKey	String	एपीआई पासकोड, जिसे Google Cloud Console से हासिल किया जा सकता है. इसके लिए, क्विकस्टार्ट गाइड में दिया गया तरीका अपनाएं.
signingKey	String	साइनिंग पासकोड, जिसे Google Cloud Console से पाया जा सकता है. इसके लिए, डिजिटल हस्ताक्षर से जुड़ी गाइड में दिया गया तरीका अपनाएं. यह StaticMap के लिए ज़रूरी है. हालांकि, Maps की अन्य सेवाओं के लिए इसे अनदेखा किया जाता है.

थ्रॉ

Error — अगर apiKey null है या अगर setAuthentication(clientId, signingKey) का इस्तेमाल पहले से ही पुष्टि करने के लिए किया जा रहा है

इन्हें भी देखें

• setAuthenticationByApiKey(apiKey)

ऐसे तरीके जिन्हें अब इस्तेमाल नहीं किया जा सकता

setAuthentication(clientId, signingKey)

अब सेवा में नहीं है. इसके बजाय, setAuthenticationByApiKey(apiKey) का इस्तेमाल करें. यह पुष्टि करने के लिए एपीआई पासकोड का इस्तेमाल करता है.

इस कुकी की मदद से, Google Maps APIs Premium Plan के किसी बाहरी खाते का इस्तेमाल किया जा सकता है, ताकि कोटा अनुमतियों का ज़्यादा फ़ायदा लिया जा सके. क्लाइंट आईडी और साइनिंग कुंजी, Google Cloud Console के Maps सेक्शन से हासिल की जा सकती है. डिफ़ॉल्ट कोटे के इस्तेमाल पर वापस जाने के लिए, इन वैल्यू को null पर सेट करें.

ध्यान दें: यह तरीका, एपीआई कुंजियों के साथ काम नहीं करता. इसके अलावा, कृपया ध्यान दें कि Premium प्लान अब नए ग्राहकों के लिए उपलब्ध नहीं है. अगर आपके पास Premium प्लान का लाइसेंस नहीं है, तो कृपया setAuthentication(clientId, signingKey) पर कॉल न करें. डिफ़ॉल्ट कोटे की अनुमतियों के साथ, Maps तरीकों का इस्तेमाल किया जा सकता है.

Maps.setAuthentication('gme-123456789', 'VhSEZvOXVSdnlxTnpJcUE');

पैरामीटर

नाम	टाइप	ब्यौरा
clientId	String	यह क्लाइंट आइडेंटिफ़ायर है.
signingKey	String	निजी साइनिंग कुंजी.

थ्रॉ

Error — अगर setAuthenticationByApiKey(apiKey) का इस्तेमाल पुष्टि करने के लिए पहले से किया जा रहा है