Эта страница переведена с помощью Cloud Translation API.

Начало работы

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'

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

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

Клиентские библиотеки упрощают разработку с помощью 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 и справочный материал по доступным параметрам.