API Elevation предоставляет данные о высоте для всех мест на поверхности земли, включая местоположения на глубине на дне океана (которые возвращают отрицательные значения).
Эта служба также доступна как часть клиентского API JavaScript Карт или для использования на стороне сервера с клиентом Java, клиентом Python, клиентом Go и клиентом Node.js для служб Google Maps .
Пример запроса и ответа
Вы получаете доступ к API Elevation через интерфейс HTTP с запросами, созданными в виде строки URL-адреса и использующими координаты широты и долготы для определения местоположений или вершин пути. Запросы должны включать ваш ключ API.
В следующем примере запрашивается высота Денвера, штат Колорадо, «Города высотой в милю», в формате JSON:
URL-адрес
https://maps.googleapis.com/maps/api/elevation/json ?locations=39.7391536%2C-104.9847034 &key=YOUR_API_KEY
КУЛЬ
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 .
Аутентификация, квоты, цены и политики
Аутентификация
Чтобы использовать API Elevation, необходимо сначала включить API и получить правильные учетные данные для аутентификации. Дополнительную информацию см. в разделе Начало работы с платформой Google Maps .
Квоты и цены
Просмотрите страницу использования и выставления счетов , чтобы получить подробную информацию о квотах и ценах, установленных для Elevation API.
Политика
Использование Elevation API должно осуществляться в соответствии с политиками API .
Узнать больше
С помощью Elevation API вы можете делать больше, например запрашивать данные о высоте из нескольких мест . Дополнительные примеры и другие подробности см. в руководстве разработчика Elevation API .
Руководство для разработчиков Elevation API предназначено для разработчиков веб-сайтов и мобильных устройств, которые хотят использовать данные о высоте на картах, предоставляемые одним из API платформы Google Maps. В нем содержится введение в использование API и справочные материалы по доступным параметрам.