Classe ElevationService
google.maps.ElevationService
classe
Definisce una classe di servizio che comunica direttamente con i server Google per richiedere i dati di altitudine.
Accedi chiamando const {ElevationService} = await google.maps.importLibrary("elevation")
. Consulta la sezione Librerie nell'API Maps JavaScript.
Costruttore | |
---|---|
ElevationService |
ElevationService() Parametri: nessuno
Crea una nuova istanza di ElevationService che invia query di elevazione ai server Google. |
Metodi | |
---|---|
getElevationAlongPath |
getElevationAlongPath(request[, callback]) Parametri:
Valore restituito:
Promise<PathElevationResponse> Effettua una richiesta di altitudine lungo un percorso, dove i dati di altitudine vengono restituiti come campioni basati sulla distanza lungo il percorso. |
getElevationForLocations |
getElevationForLocations(request[, callback]) Parametri:
Valore restituito:
Promise<LocationElevationResponse> Crea una richiesta di altitudine per un elenco di località discrete. |
Interfaccia LocationElevationRequest
Interfaccia google.maps.LocationElevationRequest
Una richiesta di elevazione inviata da ElevationService
contenente l'elenco di coordinate discrete (LatLng
) per le quali restituire i dati di altitudine.
Proprietà | |
---|---|
locations optional |
Tipo:
Array<LatLng|LatLngLiteral> optional Le posizioni discrete per le quali recuperare l'altitudine. |
Interfaccia LocationElevationResponse
Interfaccia google.maps.LocationElevationResponse
Una risposta di elevazione restituita da ElevationService
contenente l'elenco di ElevationResult
corrispondenti alle località di LocationElevationRequest
.
Proprietà | |
---|---|
results |
Tipo:
Array<ElevationResult> L'elenco di ElevationResult corrispondenti alle località di LocationElevationRequest . |
Interfaccia PathElevationRequest
Interfaccia google.maps.PathElevationRequest
Una query sull'elevazione inviata da ElevationService
contenente il percorso lungo il quale restituire dati campionati. Questa richiesta definisce un percorso continuo lungo la Terra lungo il quale devono essere effettuati i campioni di altitudine a distanze equidistanti. Tutti i percorsi dal vertice al vertice utilizzano i segmenti del grande cerchio tra questi due punti.
Proprietà | |
---|---|
samples |
Tipo:
number obbligatorio. Il numero di punti equidistanti lungo il percorso specificato per i quali recuperare i dati di altitudine, inclusi gli endpoint. Il numero di campioni deve essere un valore compreso tra 2 e 512 inclusi. |
path optional |
Tipo:
Array<LatLng|LatLngLiteral> optional Il percorso lungo il quale raccogliere i valori di elevazione. |
Interfaccia PathElevationResponse
Interfaccia google.maps.PathElevationResponse
Una risposta di elevazione restituita da ElevationService
contenente l'elenco di ElevationResult
a spaziatura uniforme lungo il percorso di PathElevationRequest
.
Proprietà | |
---|---|
results |
Tipo:
Array<ElevationResult> L'elenco di ElevationResult corrispondenti agli esempi di PathElevationRequest . |
Interfaccia ElevationResult
Interfaccia google.maps.ElevationResult
Il risultato di una richiesta ElevationService
, composta dal set di coordinate di altitudine e dai relativi valori di elevazione. Tieni presente che una singola richiesta può produrre più ElevationResult
.
Proprietà | |
---|---|
elevation |
Tipo:
number L'elevazione di questo punto sulla Terra, in metri sul livello del mare. |
resolution |
Tipo:
number La distanza, in metri, tra i punti campione da cui è stata interpolata l'altitudine. Questa proprietà non sarà presente se la risoluzione non è nota. Tieni presente che i dati di elevazione diventano più approssimativi (valori resolution più grandi) quando vengono passati più punti. Per ottenere il valore di elevazione più preciso di un punto, la query deve essere eseguita in modo indipendente. |
location optional |
Tipo:
LatLng optional La posizione del risultato di questa altitudine. |
Costanti ElevationStatus
google.maps.ElevationStatus
costanti
Lo stato restituito da ElevationService
al completamento di una richiesta di elevazione. Specificali in base al valore o utilizzando il nome della costante. Ad esempio, 'OK'
o google.maps.ElevationStatus.OK
Accedi chiamando const {ElevationStatus} = await google.maps.importLibrary("elevation")
. Consulta la sezione Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
INVALID_REQUEST |
La richiesta non è valida. |
OK |
La richiesta non ha generato errori. |
OVER_QUERY_LIMIT |
La pagina web ha superato il limite di richieste in un periodo di tempo troppo breve. |
REQUEST_DENIED |
La pagina web non è autorizzata a utilizzare il servizio di elevazione. |
UNKNOWN_ERROR |
Non è stato possibile elaborare la richiesta di elevazione, ma il motivo esatto dell'errore non è noto. |