Обзор Elevation 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 Карт – это клиентские библиотеки, поддерживаемые сообществом, на базе ПО с открытым исходным кодом, которые предоставляются согласно лицензии Apache 2.0. Их можно скачать на сайте GitHub, где также опубликованы образцы кода и инструкции по установке.

Дальнейшие действия