Начать

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

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

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

Доступ к 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'

Чтобы проверить это, введите 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 Карт, предоставляя встроенные реализации распространенных задач, таких как аутентификация, регулирование запросов и автоматический повтор. Elevation API доступен в клиентах Java, Python, Go и Node.js для веб-сервисов Google Карт.

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

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

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

Квоты и цены

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

Правила

Использовать Elevation API необходимо в соответствии с правилами API.

Подробнее…

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

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