Elevation

Класс ElevationService

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