Начать

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

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

Пример запроса и ответа

Доступ к API Elevation осуществляется через 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'

Вы можете проверить это, введя 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>
</pre>

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

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

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

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

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

Квоты и цены

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

Политики

Использование API Elevation должно осуществляться в соответствии с политикой API .

Узнать больше

Возможности Elevation API широки, например, запрос данных о высоте из нескольких мест , также весьма разнообразны. Дополнительные примеры и подробности см. в Руководстве разработчика Elevation API .

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