Elevation

Класс ElevationService

class google.maps.ElevationService
library "elevation"

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

const {ElevationService} = await google.maps.importLibrary("elevation");

Конструктор
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 необязательно	Тип: 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 необязательно	Тип: 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 необязательно	Тип: LatLng optional Местоположение этого результата.

Константы ElevationStatus

константы google.maps.ElevationStatus
библиотека "elevation"

Статус, возвращаемый ElevationService после выполнения запроса данных о высоте. Укажите их по значению или по названию константы. Примеры: 'OK' или google.maps.ElevationStatus.OK.

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом ElevationStatusString.

const {ElevationStatus} = await google.maps.importLibrary("elevation");

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