शुरू करना

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

यह सेवा, क्लाइंट-साइड Maps JavaScript API के तौर पर भी उपलब्ध है. इसके अलावा, इसे सर्वर-साइड पर इस्तेमाल करने के लिए, Google Maps सेवाओं के लिए Java Client, Python Client, Go Client, और 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 की डेवलपर गाइड देखें.

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