Начать

Elevation API предоставляет данные о высоте для всех местоположений на поверхности земли, включая местоположения глубины на дне океана (которые возвращают отрицательные значения).

Эта служба также доступна как часть API JavaScript Карт на стороне клиента или для использования на стороне сервера с клиентом Java, клиентом Python, клиентом Go и клиентом Node.js для служб Google Maps .

Образец запроса и ответа

Вы получаете доступ к Elevation API через интерфейс HTTP с запросами, созданными в виде строки URL, используя координаты широты/долготы для определения местоположений или вершин пути. Запросы должны включать ваш ключ 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'

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);
});

Питон

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)

Ява

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();

Рубин

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 также доступна в виде коллекции Postman .

Беги в Почтальоне

Вы можете проверить это, введя URL-адрес в свой веб-браузер (не забудьте заменить YOUR_API_KEY вашим фактическим ключом API ). Ответ включает высоту в этой точке в метрах, а также значение разрешения (максимальное расстояние между точками данных, из которых высота была интерполирована, в метрах).

Просмотрите руководство разработчика, чтобы получить дополнительные сведения о создании URL-адресов запроса и доступных параметрах, а также о понимании ответа .

Ниже приведен пример ответа:

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>

Спецификация OpenAPI

Спецификация OpenAPI опубликована для этого API и доступна на GitHub .

Получить спецификацию OpenAPI

Коллекция почтальона

Спецификация OpenAPI также доступна в виде коллекции Postman .

Беги в Почтальоне

Начните программировать с нашими клиентскими библиотеками

Клиентские библиотеки упрощают разработку с помощью API-интерфейсов веб-сервисов Google Maps, предоставляя простые, встроенные реализации общих задач, таких как проверка подлинности, регулирование запросов и автоматический повтор. API Elevation доступен в клиенте Java, клиенте Python, клиенте Go и клиенте Node.js для сервисов Google Maps .

Аутентификация, квоты, цены и политики

Аутентификация

Чтобы использовать Elevation API, вы должны сначала включить API и получить надлежащие учетные данные для аутентификации. Дополнительную информацию см. в разделе Начало работы с платформой Google Maps .

Квоты и цены

Просмотрите страницу использования и выставления счетов , чтобы узнать подробности о квотах и ​​ценах, установленных для Elevation API.

Политики

Использование Elevation API должно соответствовать политикам API .

Учить больше

С помощью Elevation API вы можете делать больше, например запрашивать данные о высоте из нескольких местоположений . Дополнительные примеры и другие сведения см. в руководстве разработчика Elevation API .

Руководство разработчика Elevation API предназначено для разработчиков веб-сайтов и мобильных устройств, которые хотят использовать данные о высоте на картах, предоставляемых одним из API платформы Google Maps. Он содержит введение в использование API и справочный материал по доступным параметрам.