शुरू करें

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

ऊंचाई वाले एपीआई की मदद से, धरती की सतह पर मौजूद सभी जगहों के लिए ऊंचाई से जुड़ा डेटा देखा जा सकता है. इसमें समुद्र के तल पर गहराई वाली जगहें भी शामिल होती हैं, जो नेगेटिव वैल्यू दिखाती हैं.

यह सेवा क्लाइंट-साइड Maps JavaScript API के हिस्से के तौर पर या Java क्लाइंट, Python क्लाइंट, Go क्लाइंट, और Google Maps सेवाओं के लिए Node.js क्लाइंट के हिस्से के तौर पर भी उपलब्ध है.

अनुरोध और जवाब का नमूना

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

नीचे दिए गए उदाहरण में, JSON फ़ॉर्मैट में, डेनवर, कोलोराडो, "माइल हाई सिटी" की ऊंचाई का अनुरोध किया गया है:

यूआरएल

https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'

अपने वेब ब्राउज़र में यूआरएल डालकर, आप इसकी जांच कर सकते हैं. ध्यान रखें कि YOUR_API_KEY को अपने असल एपीआई पासकोड से बदलना न भूलें. इस रिस्पॉन्स में, मीटर में, उस वैल्यू और ऊंचाई के बीच की ऊंचाई को शामिल किया जाता है. जिस डेटा पॉइंट से एलिवेशन इंटरपोलेट किया गया था उसके बीच की दूरी मीटर में होती है.

डेवलपर के लिए, अनुरोध वाले यूआरएल बनाने और उपलब्ध पैरामीटर के बारे में ज़्यादा जानकारी के लिए, डेवलपर की गाइड देखें. साथ ही, रिस्पॉन्स समझने के लिए निर्देश देखें.

जवाब का एक उदाहरण नीचे दिया गया है:

JSON

{
  "results":
    [
      {
        "elevation": 1608.637939453125,
        "location": { "lat": 39.7391536, "lng": -104.9847034 },
        "resolution": 4.771975994110107,
      },
    ],
  "status": "OK",
}

XML

<ElevationResponse>
 <status>OK</status>
 <result>
  <location>
   <lat>39.7391536</lat>
   <lng>-104.9847034</lng>
  </location>
  <elevation>1608.6379395</elevation>
  <resolution>4.7719760</resolution>
 </result>
</ElevationResponse>

हमारी क्लाइंट लाइब्रेरी की मदद से कोडिंग शुरू करें

क्लाइंट लाइब्रेरी, Google Maps वेब सर्विस एपीआई की मदद से आसानी से काम कर पाती है. यह पुष्टि करने, अनुरोध करने को थ्रॉटल करने, और अपने-आप फिर से कोशिश करने जैसे सामान्य कामों को आसानी से करती है. ऊंचाई वाले एपीआई Java क्लाइंट, Python क्लाइंट, Go Client, और Node.js क्लाइंट के लिए Google Maps की सेवाओं के लिए उपलब्ध हैं.

पुष्टि करने, कोटा, कीमत, और नीतियां

पुष्टि करना

ऊंचाई वाले एपीआई का इस्तेमाल करने के लिए, आपको पहले एपीआई को चालू करना होगा और सही पुष्टि वाले क्रेडेंशियल पाने होंगे. ज़्यादा जानकारी के लिए, Google Maps Platform का इस्तेमाल शुरू करना देखें.

कोटा और कीमत

Elevation API के लिए तय किए गए कोटा और कीमत के बारे में ज़्यादा जानने के लिए, इस्तेमाल और बिलिंग पेज पर जाएं.

नीतियां

ऊंचाई वाले एपीआई का इस्तेमाल, एपीआई की नीतियों के मुताबिक होना चाहिए.

ज़्यादा जानें

Elevation API की मदद से, कई और काम किए जा सकते हैं. जैसे, एक से ज़्यादा जगहों से ऊंचाई का डेटा इकट्ठा करने का अनुरोध करना. ज़्यादा उदाहरणों और दूसरी जानकारी के लिए, Elevation API डेवलपर गाइड देखें.

ऊंचाई से जुड़ी एपीआई डेवलपर गाइड, उन वेबसाइट और मोबाइल डेवलपर के लिए है जो Google Maps Platform API में शामिल किसी मैप में, ऊंचाई से जुड़ा डेटा इस्तेमाल करना चाहते हैं. इसमें, उपलब्ध पैरामीटर के बारे में बताने के लिए, एपीआई और एपीआई का इस्तेमाल करने के बारे में बताया गया है.