Classe ElevationService
Classe
google.maps.ElevationService
Define uma classe de serviço que se comunica diretamente com servidores do Google para solicitar dados de elevação.
Acesse chamando const {ElevationService} = await google.maps.importLibrary("elevation")
. Consulte Bibliotecas na API Maps JavaScript.
Construtor | |
---|---|
ElevationService |
ElevationService() Parâmetros: nenhum
Cria uma nova instância de um ElevationService que envia consultas de elevação para servidores do Google. |
Métodos | |
---|---|
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. |
LocationElevationRequest
Interface
google.maps.LocationElevationRequest
Uma solicitação de elevação enviada pelo ElevationService
contendo a lista de coordenadas discretas (LatLng
s) para retornar dados de elevação.
Propriedades | |
---|---|
locations optional |
Tipo:
Array<LatLng|LatLngLiteral> optional Os locais específicos para os quais dados de elevação deverão ser recuperados. |
LocationElevationResponse
Interface
google.maps.LocationElevationResponse
Uma resposta de elevação retornada pelo ElevationService
contendo a lista de ElevationResult
s correspondentes aos locais do LocationElevationRequest
.
Propriedades | |
---|---|
results |
Tipo:
Array<ElevationResult> A lista de ElevationResult s correspondentes aos locais do LocationElevationRequest . |
PathElevationRequest
Interface
google.maps.PathElevationRequest
Uma consulta de elevação enviada pelo ElevationService
contendo o caminho pelo qual os dados de amostra precisam ser 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.
Propriedades | |
---|---|
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 optional |
Tipo:
Array<LatLng|LatLngLiteral> optional O caminho pelo qual coletar valores de elevação. |
PathElevationResponse
Interface
google.maps.PathElevationResponse
Uma resposta de elevação retornada pelo ElevationService
contendo a lista de ElevationResult
s espaçadas uniformemente ao longo do caminho da PathElevationRequest
.
Propriedades | |
---|---|
results |
Tipo:
Array<ElevationResult> A lista de ElevationResult s que correspondem às amostras de PathElevationRequest . |
ElevationResult
Interface
google.maps.ElevationResult
O resultado de uma solicitação ElevationService
, que consiste no conjunto de coordenadas de elevação e seus valores de elevação. Uma única solicitação pode produzir várias ElevationResult
s.
Propriedades | |
---|---|
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 pontos de amostragem a partir dos quais a elevação foi interpolada. Essa propriedade não estará presente se a resolução for desconhecida. Os dados de elevação se tornam mais aproximados (valores resolution maiores) 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 optional |
Tipo:
LatLng optional O local deste resultado de elevação. |
Constantes ElevationStatus
Constantes
google.maps.ElevationStatus
O status retornado pelo ElevationService
após a conclusão de uma solicitação de elevação. Especifique-as por valor ou usando o nome da constante. Por exemplo, 'OK'
ou google.maps.ElevationStatus.OK
.
Acesse chamando const {ElevationStatus} = await google.maps.importLibrary("elevation")
. Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
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 com êxito, mas o motivo exato da falha é desconhecido. |