शुरू करें

शुरू करने से पहले: एलिवेशन एपीआई का इस्तेमाल शुरू करने से पहले, आपको एक ऐसा प्रोजेक्ट चाहिए जिसमें बिलिंग खाता हो और एलिवेशन एपीआई चालू हो. हम एक से ज़्यादा प्रोजेक्ट के मालिक और बिलिंग एडमिन बनाने का सुझाव देते हैं, ताकि आपकी टीम के पास इन भूमिकाओं के लिए हमेशा कोई न कोई उपलब्ध रहे. ज़्यादा जानने के लिए, Cloud Console में सेट अप करना देखें.

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

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

अनुरोध और जवाब का नमूना

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

इस उदाहरण में, 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>

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

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

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

पुष्टि करना

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

कोटा और कीमत

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

नीतियां

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

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

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

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