API данных о высоте предоставляет данные о высоте для всех точек на поверхности Земли, включая точки глубины на дне океана (которые возвращают отрицательные значения).
Эта служба также доступна как часть клиентского API Карт JavaScript или для использования на стороне сервера с клиентом Java, клиентом Python, клиентом Go и клиентом Node.js для служб Google Карт .
Образец запроса и ответа
Вы получаете доступ к 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
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 Client, Python Client, Go Client и Node.js Client для Google Maps Services .
Аутентификация, квоты, ценообразование и политики
Аутентификация
Чтобы использовать API Elevation, необходимо сначала включить API и получить соответствующие учетные данные для аутентификации. Для получения дополнительной информации см. раздел Начало работы с платформой Google Maps .
Квоты и ценообразование
Подробную информацию о квотах и ценах на API Elevation можно найти на странице использования и выставления счетов .
Политики
Использование API Elevation должно осуществляться в соответствии с политиками API .
Узнать больше
С Elevation API вы можете делать больше, например, запрашивать данные о высоте из нескольких местоположений . Дополнительные примеры и другие подробности см. в руководстве разработчика Elevation API.
Руководство разработчика API Elevation предназначено для разработчиков веб-сайтов и мобильных устройств, которые хотят использовать данные о высоте на картах, предоставляемых одним из API платформы Google Maps. Оно содержит введение в использование API и справочные материалы по доступным параметрам.