Elevation

Класс обслуживания Elevation

google.maps . ElevationService

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

Доступ осуществляется путем вызова const {ElevationService} = await google.maps.importLibrary("elevation") .
См. Библиотеки в Maps JavaScript API .

Конструктор
ElevationService	ElevationService() Параметры: нет Создает новый экземпляр ElevationService , который отправляет запросы о высоте на серверы Google.

Методы
getElevationAlongPath	getElevationAlongPath(request[, callback]) Параметры: request : PathElevationRequest callback : function( Array < ElevationResult > optional , ElevationStatus ): void optional Возвращаемое значение: Promise < PathElevationResponse > Делает запрос высоты вдоль пути, где данные о высоте возвращаются в виде выборок на основе расстояния вдоль этого пути.
getElevationForLocations	getElevationForLocations(request[, callback]) Параметры: request : LocationElevationRequest callback : function( Array < ElevationResult > optional , ElevationStatus ): void optional Возвращаемое значение: Promise < LocationElevationResponse > Делает запрос высоты для списка отдельных местоположений.

Интерфейс LocationElevationRequest

google.maps . LocationElevationRequest

Запрос высоты, отправленный ElevationService , содержащий список дискретных координат ( LatLng ), для которых необходимо вернуть данные высоты.

Характеристики
locations optional	Тип: Array < LatLng | LatLngLiteral > optional Конкретные местоположения, для которых необходимо получить данные о высотах.

Интерфейс LocationElevationResponse

google.maps . LocationElevationResponse

Ответ на запрос о высоте, возвращаемый службой ElevationService , содержащий список ElevationResult , соответствующих местоположениям LocationElevationRequest .

Характеристики
results	Тип: Array < ElevationResult > Список ElevationResult , соответствующих местоположениям LocationElevationRequest .

Интерфейс PathElevationRequest

google.maps . PathElevationRequest

Запрос высоты, отправленный службой ElevationService , содержащий путь, по которому будут возвращены данные выборки. Этот запрос определяет непрерывный путь вдоль земной поверхности, вдоль которого должны быть получены данные выборки высот на равноудаленных расстояниях. Все пути от вершины к вершине используют сегменты большого круга между этими двумя точками.

Характеристики
samples	Тип: number Обязательно. Количество равноудаленных точек вдоль заданного пути, для которых необходимо получить данные о высоте, включая конечные точки. Количество выборок должно быть от 2 до 512 включительно.
path optional	Тип: Array < LatLng | LatLngLiteral > optional Путь, вдоль которого будут собираться значения высот.

Интерфейс PathElevationResponse

google.maps . PathElevationResponse

Ответ о высоте, возвращаемый ElevationService , содержащий список ElevationResult , равномерно распределенных вдоль пути PathElevationRequest .

Характеристики
results	Тип: Array < ElevationResult > Список ElevationResult , соответствующих образцам PathElevationRequest .

Интерфейс ElevationResult

google.maps . ElevationResult

Результат запроса ElevationService , состоящий из набора координат высоты и их значений. Обратите внимание, что один запрос может возвращать несколько результатов ElevationResult .

Характеристики
elevation	Тип: number Высота данной точки на Земле в метрах над уровнем моря.
resolution	Тип: number Расстояние (в метрах) между точками выборки, из которых была интерполирована высота. Это свойство будет отсутствовать, если разрешение неизвестно. Обратите внимание, что данные о высоте становятся более грубыми (с более высоким resolution ) при прохождении нескольких точек. Чтобы получить наиболее точное значение высоты для точки, её следует запрашивать независимо.
location optional	Тип: LatLng optional Местоположение этого результата возвышения.

Константы ElevationStatus

google.maps . ElevationStatus

Статус, возвращаемый ElevationService после завершения запроса высоты. Укажите его значением или именем константы. Например, 'OK' или google.maps.ElevationStatus.OK .

Доступ осуществляется путем вызова const {ElevationStatus} = await google.maps.importLibrary("elevation") .
См. Библиотеки в Maps JavaScript API .

Константы
INVALID_REQUEST	Запрос был недействительным.
OK	Запрос не выявил никаких ошибок.
OVER_QUERY_LIMIT	Веб-страница превысила лимит запросов за слишком короткий промежуток времени.
REQUEST_DENIED	Веб-странице не разрешено использовать службу определения высоты.
UNKNOWN_ERROR	Запрос на повышение статуса не удалось успешно обработать, однако точная причина сбоя неизвестна.