शुरू करना

Elevation API, पृथ्वी की सतह पर मौजूद सभी जगहों के लिए एलिवेशन डेटा उपलब्ध कराता है. इसमें समुद्र के तल पर मौजूद जगहों की गहराई का डेटा भी शामिल है. समुद्र के तल पर मौजूद जगहों की गहराई के लिए, नेगेटिव वैल्यू मिलती हैं.

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

अनुरोध और जवाब का उदाहरण

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

यहां दिए गए उदाहरण में, कोलोराडो के डेनवर शहर ("माइल हाई सिटी") के लिए, 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>
</pre>
      
    

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

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

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

पुष्टि करना

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

कोटा और कीमत

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

नीतियां

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

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

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

Elevation API Developer's Guide उन वेबसाइट और मोबाइल डेवलपर के लिए है जो Google Maps Platform के किसी एपीआई से मिले मैप में, एलिवेशन डेटा का इस्तेमाल करना चाहते हैं. इसमें, एपीआई का इस्तेमाल करने के बारे में जानकारी दी गई है. साथ ही, उपलब्ध पैरामीटर के बारे में रेफ़रंस के तौर पर जानकारी दी गई है.