इस पेज का अनुवाद Cloud Translation API से किया गया है.

शुरू करें

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

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

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

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

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

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

यूआरएल

https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

यूआरएल

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'

JavaScript

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY',
  headers: { }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Python

import requests

url = "https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY")
  .method("GET", body)
  .build();
Response response = client.newCall(request).execute();

Ruby

require "uri"
require "net/http"

url = URI("https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body

शुरू करें

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536,-104.9847034&key=YOUR_API_KEY"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

पोस्टमैन

OpenAPI की खास बातें पोस्टमैन संग्रह के रूप में भी उपलब्ध हैं.

पोस्टमैन में दौड़ें

अपने वेब ब्राउज़र में यूआरएल डालकर, आप इसकी जांच कर सकते हैं. 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>

OpenAPI विवरण

इस एपीआई के लिए, OpenAPI की खास जानकारी पब्लिश की गई है और यह GitHub पर उपलब्ध है.

OpenAPI की जानकारी पाना

डाकघर संग्रह

OpenAPI की खास बातें पोस्टमैन संग्रह के रूप में भी उपलब्ध हैं.

पोस्टमैन में दौड़ें

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

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

प्रमाणीकरण, कोटा, मूल्य-निर्धारण और नीतियां

पुष्टि करें

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

कोटा और कीमत

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

नीतियां

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

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

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

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