Elevation

Класс ElevationService

google.maps.ElevationService библиотека
класса "elevation"

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

const {ElevationService} = await google.maps.importLibrary("elevation");
ElevationService
ElevationService()
Параметры: нет.
Создает новый экземпляр ElevationService, который отправляет запросы высоты на серверы Google.
getElevationAlongPath
getElevationAlongPath(request[, callback])
Параметры:
Возвращаемое значение: Promise<PathElevationResponse>
Делает запрос данных о высоте вдоль пути. Данные о высоте возвращаются в виде выборок по расстоянию вдоль пути.
getElevationForLocations
getElevationForLocations(request[, callback])
Параметры:
Возвращаемое значение: Promise<LocationElevationResponse>
Делает запрос данных о высоте для списка точек.

Интерфейс LocationElevationRequest

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

Запрос высоты, отправленный ElevationService и содержащий список отдельных координат (LatLng), для которых нужно вернуть данные о высоте.
locations
необязательно
Тип: Array<LatLng|LatLngLiteral> optional
Отдельные точки, для которых требуются данные о высоте.

Интерфейс LocationElevationResponse

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

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

Интерфейс PathElevationRequest

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

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

Интерфейс PathElevationResponse

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

Ответ, возвращаемый ElevationService и содержащий список объектов ElevationResult, равномерно распределенных вдоль пути PathElevationRequest.
results
Список 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 Запрос высоты не удалось обработать по неизвестной причине.