
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). Высота может быть возвращена как положительное или отрицательное значение, как показано ниже:
|
|
Как использовать Elevation API
1 | Настройтесь. | Начните с настройки проекта Google Cloud и выполните следующие инструкции по настройке. |
2 | Попробуйте запросить повышение | Получив ключ API, вы можете приступить к тестированию Elevation API прямо из браузера. Дополнительные сведения см. в разделе Примеры запросов в руководстве по началу работы . |
3 | Составьте более сложный запрос | После того, как вы настроите проект, попробуйте запрос, который предоставляет данные о местоположении по пути. Дополнительные сведения см. в разделе Указание путей . |
4 | Понимание основ ответа | Изучите ответы на данные о высоте, чтобы подготовиться к использованию данных о высоте для вашего приложения. Дополнительные сведения см. в разделе Ответы на изменение высоты . |
5 | Включите данные о высоте в свое собственное приложение! | Вы можете использовать данные о высоте для улучшения приложений на основе местоположения, таких как приложения для занятий спортом или для данных опросов. |
Доступные клиентские библиотеки
Вызовите этот API на выбранном вами языке через одну из следующих клиентских библиотек:
- Java-клиент для сервисов Google Maps
- Клиент Python для сервисов Google Maps
- Клиент Go для сервисов Google Maps
- Клиент Node.js для сервисов Google Maps
Клиент Java, клиент Python, клиент Go и клиент Node.js для сервисов Google Maps — это поддерживаемые сообществом клиентские библиотеки с открытым исходным кодом в соответствии с лицензией Apache 2.0 . Загрузите их с GitHub, где вы также можете найти инструкции по установке и примеры кода.
Что дальше
- Начните использовать Elevation API : перейдите к разделу «Настройка проекта Google Cloud» .
- Попробуйте получить данные о высоте на основе пути . Перейдите к разделу «Указание путей».
- Следуйте рекомендациям : перейдите к рекомендациям по веб-службе .