Elevation

Класс ElevationService

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	Веб-странице не разрешено использовать сервис Elevation.
UNKNOWN_ERROR	Запрос высоты не удалось обработать по неизвестной причине.