Elevation

Класс ElevationService

google.maps . ElevationService Класс google.maps . ElevationService

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

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

ElevationService
ElevationService()
Параметры: Нет
Создает новый экземпляр ElevationService , который отправляет запросы на повышение прав на серверы Google.
getElevationAlongPath
getElevationAlongPath(request[, callback])
Параметры:
Возвращаемое значение: Promise < PathElevationResponse >
Выполняет запрос на высоту по пути, где данные о высоте возвращаются в виде выборок на основе расстояния по этому пути.
getElevationForLocations
getElevationForLocations(request[, callback])
Параметры:
Возвращаемое значение: Promise < LocationElevationResponse >
Выполняет запрос на повышение прав для списка отдельных местоположений.

Интерфейс LocationElevationRequest

google.maps . LocationElevationRequest Интерфейс google.maps . LocationElevationRequest

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

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

Интерфейс LocationElevationResponse

google.maps . LocationElevationResponse Интерфейс google.maps . LocationElevationResponse

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

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

Интерфейс PathElevationRequest

google.maps . PathElevationRequest Интерфейс google.maps . PathElevationRequest

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

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

Интерфейс PathElevationResponse

google.maps . PathElevationResponse Интерфейс google.maps . PathElevationResponse

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

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

Интерфейс ElevationResult

google.maps . ElevationResult Интерфейс google.maps . ElevationResult

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

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

Константы ElevationStatus

google.maps . 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 Запрос на повышение прав не удалось успешно обработать, однако точная причина сбоя неизвестна.