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_KEYcURL
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", }
एक्सएमएल
<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 Web Service API का इस्तेमाल करके डेवलपमेंट करना आसान हो जाता है. ऐसा इसलिए, क्योंकि इसमें सामान्य टास्क के लिए पहले से मौजूद सुविधाएं मिलती हैं. जैसे, पुष्टि करना, अनुरोध थ्रॉटलिंग, और अपने-आप फिर से कोशिश करना. Elevation API, Java Client, Python Client, Go Client, और Node.js Client for Google Maps Services में उपलब्ध है.
पुष्टि करना, कोटा, कीमत, और नीतियां
पुष्टि करना
Elevation API का इस्तेमाल करने के लिए, आपको सबसे पहले एपीआई चालू करना होगा. साथ ही, पुष्टि करने के लिए सही क्रेडेंशियल पाने होंगे. ज़्यादा जानकारी के लिए, Google Maps Platform का इस्तेमाल शुरू करना लेख पढ़ें.
कोटा और कीमत
Elevation API के लिए तय किए गए कोटे और कीमत के बारे में जानने के लिए, इस्तेमाल और बिलिंग पेज देखें.
नीतियां
Elevation API का इस्तेमाल, एपीआई की नीतियों के मुताबिक होना चाहिए.
ज़्यादा जानें
Elevation API का इस्तेमाल कई अन्य कामों के लिए भी किया जा सकता है. जैसे, एक साथ कई जगहों के लिए ऊंचाई के डेटा का अनुरोध करना. ज़्यादा उदाहरण और अन्य जानकारी के लिए, Elevation API की डेवलपर गाइड देखें.
Elevation API डेवलपर गाइड, वेबसाइट और मोबाइल डेवलपर के लिए है. यह उन डेवलपर के लिए है जो Google Maps Platform API में से किसी एक के ज़रिए उपलब्ध कराए गए मैप में ऊंचाई का डेटा इस्तेमाल करना चाहते हैं. इसमें एपीआई इस्तेमाल करने के बारे में बुनियादी जानकारी दी गई है. साथ ही, उपलब्ध पैरामीटर के बारे में रेफ़रंस मटीरियल दिया गया है.