शुरू करना

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

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

अनुरोध और जवाब का सैंपल

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 क्लाइंट, Python क्लाइंट, Go क्लाइंट, और Node.js क्लाइंट में उपलब्ध है.

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

पुष्टि करना

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

कोटा और कीमत

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

नीतियां

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

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

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

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