Elevation

Classe ElevationService

google.maps.ElevationService classe
biblioteca "elevation"

Define uma classe de serviço que se comunica diretamente com servidores do Google para solicitar dados de elevação.

const {ElevationService} = await google.maps.importLibrary("elevation");
ElevationService
ElevationService()
Parâmetros: nenhum
Cria uma nova instância de um ElevationService que envia consultas de elevação para os servidores do Google.
getElevationAlongPath
getElevationAlongPath(request[, callback])
Parâmetros:
Valor de retorno: Promise<PathElevationResponse>
Faz uma solicitação de elevação ao longo de um caminho, onde os dados de elevação são retornados como pontos de amostragem (baseados na distância) ao longo desse caminho.
getElevationForLocations
getElevationForLocations(request[, callback])
Parâmetros:
Valor de retorno: Promise<LocationElevationResponse>
Faz uma solicitação de elevação para uma lista de locais específicos.

Interface LocationElevationRequest

Interface google.maps.LocationElevationRequest

Uma solicitação de elevação enviada pelo ElevationService que contém a lista de coordenadas discretas (LatLngs) para as quais os dados de elevação serão retornados.
locations
opcional
Tipo: Array<LatLng|LatLngLiteral> optional
Os locais específicos para os quais dados de elevação deverão ser recuperados.

Interface LocationElevationResponse

Interface google.maps.LocationElevationResponse

Uma resposta de elevação retornada pelo ElevationService que contém a lista de ElevationResults correspondentes aos locais do LocationElevationRequest.
results
A lista de ElevationResults que correspondem aos locais do LocationElevationRequest.

Interface PathElevationRequest

Interface google.maps.PathElevationRequest

Uma consulta de elevação enviada pelo ElevationService que contém o caminho ao longo do qual os dados de amostra serão retornados. Essa solicitação define um caminho contínuo pela Terra, ao longo do qual os pontos de amostragem de elevação devem ser usados em distâncias espaçadas uniformemente. Todos os caminhos de um vértice a outro usam segmentos do grande círculo entre esses dois pontos.
samples
Tipo: number
Obrigatório. O número de pontos equidistantes ao longo do caminho especificado para recuperação de dados de elevação, incluindo os pontos de extremidade. O número de amostras precisa ser um valor entre 2 e 512, inclusive.
path
opcional
Tipo: Array<LatLng|LatLngLiteral> optional
O caminho pelo qual coletar valores de elevação.

Interface PathElevationResponse

Interface google.maps.PathElevationResponse

Uma resposta de elevação retornada pelo ElevationService que contém a lista de ElevationResults espaçados de maneira uniforme ao longo do caminho do PathElevationRequest.
results
A lista de ElevationResults que correspondem às amostras do PathElevationRequest.

Interface ElevationResult

Interface google.maps.ElevationResult

O resultado de uma solicitação de ElevationService, que consiste no conjunto de coordenadas de elevação e nos valores de elevação delas. Uma única solicitação pode produzir vários ElevationResults.
elevation
Tipo: number
A elevação deste ponto na Terra, em metros acima do nível do mar.
resolution
Tipo: number
A distância, em metros, entre os pontos de amostra em que a elevação foi interpolada. Essa propriedade não estará presente se a resolução for desconhecida. Os dados de elevação ficam mais imprecisos (valores maiores de resolution) quando vários pontos são transmitidos. Para obter o valor de elevação mais preciso para um ponto, é necessário fazer a consulta separadamente.
location
opcional
Tipo: LatLng optional
O local deste resultado de elevação.

Constantes ElevationStatus

google.maps.ElevationStatus biblioteca de constantes
"elevation"

O status retornado pelo ElevationService após a conclusão de uma solicitação de elevação. Especifique-os por valor ou usando o nome da constante. Por exemplo, 'OK' ou google.maps.ElevationStatus.OK.

Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo ElevationStatusString.

const {ElevationStatus} = await google.maps.importLibrary("elevation");
INVALID_REQUEST Solicitação inválida.
OK A solicitação não encontrou erros.
OVER_QUERY_LIMIT A página web ultrapassou o limite de solicitações em um período muito curto.
REQUEST_DENIED A página da Web não tem permissão para usar o serviço de elevação.
UNKNOWN_ERROR A solicitação de elevação não foi processada, mas o motivo exato da falha não é conhecido.