Обзор API повышения высоты

Elevation API — это служба, которая возвращает данные о высоте для местоположения на Земле или выборочные данные о высоте вдоль путей.

Зачем использовать Elevation API

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

Что вы можете делать с помощью Elevation API

С помощью Elevation API вы можете включать данные о высоте в свои приложения или на карту. Например:

  • Получить высоту для определенного места.
  • Рассчитайте перепады высот вдоль маршрута или между двумя точками.

Как работает Elevation API

Elevation API принимает запрос в виде закодированного URL-адреса с координатами широты и долготы, предоставленными либо в виде отдельных местоположений, либо в виде серии местоположений вдоль пути. Этот запрос, например, запрашивает высоту для центра Денвера, штат Колорадо, указывая возврат в формате JSON.
  https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

Служба получает высоту для предоставленных координат. Он также интерполирует высоту для местоположения без отметки, предоставляя среднее значение, полученное из четырех ближайших местоположений, которые предоставляют данные о высоте. Наконец, он определяет общее разрешение для местоположения.

Ресурсы

В следующей таблице приведены ресурсы, доступные через Elevation API, а также данные, которые он возвращает.

Ресурсы данных Данные возвращены Формат возврата
Координаты широты/долготы

Вы можете предоставить данные в виде набора из одного или нескольких местоположений или в виде серии вдоль пути. Вы также можете указать закодированные координаты. Передайте до 512 координат.

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

  • Положительные значения указывают места выше LMSL, включая места на поверхности или на дне высокогорных озер.
  • Отрицательные значения указывают местоположения ниже LMSL, включая местоположения на поверхности или на дне океана.
  • Разрешение указывает расстояние между точкой данных и высотой в метрах.
  • JSON
  • XML

Как использовать Elevation API

1 Настройтесь. Начните с настройки проекта Google Cloud и выполните следующие инструкции по настройке.
2 Попробуйте запросить повышение Получив ключ API, вы можете приступить к тестированию Elevation API прямо из браузера. Дополнительные сведения см. в разделе Примеры запросов в руководстве по началу работы .
3 Составьте более сложный запрос После того, как вы настроите проект, попробуйте запрос, который предоставляет данные о местоположении по пути. Дополнительные сведения см. в разделе Указание путей .
4 Понимание основ ответа Изучите ответы на данные о высоте, чтобы подготовиться к использованию данных о высоте для вашего приложения. Дополнительные сведения см. в разделе Ответы на изменение высоты .
5 Включите данные о высоте в свое собственное приложение! Вы можете использовать данные о высоте для улучшения приложений на основе местоположения, таких как приложения для занятий спортом или для данных опросов.

Доступные клиентские библиотеки

Вызовите этот API на выбранном вами языке через одну из следующих клиентских библиотек:

Клиент Java, клиент Python, клиент Go и клиент Node.js для сервисов Google Maps — это поддерживаемые сообществом клиентские библиотеки с открытым исходным кодом в соответствии с лицензией Apache 2.0 . Загрузите их с GitHub, где вы также можете найти инструкции по установке и примеры кода.

Что дальше