शुरू करना

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

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

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

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

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

URL

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 डेवलपर गाइड, वेबसाइट और मोबाइल डेवलपर के लिए है. यह उन डेवलपर के लिए है जो Google Maps Platform API में से किसी एक के ज़रिए उपलब्ध कराए गए मैप में ऊंचाई का डेटा इस्तेमाल करना चाहते हैं. इसमें एपीआई इस्तेमाल करने के बारे में बुनियादी जानकारी दी गई है. साथ ही, उपलब्ध पैरामीटर के बारे में रेफ़रंस मटीरियल भी दिया गया है.