Elevation

Classe ElevationService

lezione google.maps.ElevationService

Definisce una classe di servizio che comunica direttamente con i server di Google per richiedere i dati dell'altitudine.

Accedi chiamando const {ElevationService} = await google.maps.importLibrary("elevation"). Consulta la sezione Librerie nell'API Maps JavaScript.
ElevationService
ElevationService()
Parametri: nessuno
Crea una nuova istanza di un ElevationService che invia query di elevazione ai server di Google.
getElevationAlongPath
getElevationAlongPath(request[, callback])
Parametri: 
Valore restituito:  Promise<PathElevationResponse>
Effettua una richiesta di elevazione lungo un percorso, dove i dati sull'altitudine vengono restituiti come campioni basati sulla distanza lungo tale percorso.
getElevationForLocations
getElevationForLocations(request[, callback])
Parametri: 
Valore restituito:  Promise<LocationElevationResponse>
Effettua una richiesta di altitudine per un elenco di località discrete.

Interfaccia di LocationElevationRequest

google.maps.LocationElevationRequest interfaccia

Una richiesta di altitudine inviata da ElevationService contenente l'elenco di coordinate discrete (LatLng) per cui restituire i dati di altitudine.
locations optional
Tipo:  Array<LatLng|LatLngLiteral> optional
Le posizioni discrete per le quali recuperare le elevazioni.

Interfaccia LocationElevationResponse

google.maps.LocationElevationResponse interfaccia

Una risposta relativa all'altitudine restituita da ElevationService contenente l'elenco di ElevationResult corrispondente alle località di LocationElevationRequest.
results
L'elenco di ElevationResult che corrisponde alle località di LocationElevationRequest.

Interfaccia di PathElevationRequest

google.maps.PathElevationRequest interfaccia

Una query di elevazione inviata da ElevationService contenente il percorso lungo il quale restituire i dati campionati. Questa richiesta definisce un percorso continuo lungo la terra lungo il quale devono essere eseguiti campioni di altitudine a distanze distanziate tra loro. Tutti i percorsi dal vertice al vertice utilizzano segmenti del grande cerchio tra questi due punti.
samples
Tipo:  number
Obbligatorio. Il numero di punti equidistanti lungo il percorso specificato per cui recuperare i dati sull'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 altitudine.

Interfaccia di PathElevationResponse

google.maps.PathElevationResponse interfaccia

Una risposta elevazione restituita da ElevationService contenente l'elenco di ElevationResult con spaziatura uniforme lungo il percorso di PathElevationRequest.
results
L'elenco di ElevationResult corrispondenti agli esempi di PathElevationRequest.

Interfaccia ElevationResult

google.maps.ElevationResult interfaccia

Il risultato di una richiesta ElevationService, composta dal set di coordinate di elevazione e dai relativi valori di altitudine. Tieni presente che una singola richiesta potrebbe generare più ElevationResult.
elevation
Tipo:  number
L'altitudine 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 maggiori) quando vengono trasmessi più punti. Per ottenere il valore di elevazione più preciso per un punto, è necessario interrogarlo in modo indipendente.
location optional
Tipo:  LatLng optional
La posizione di questo risultato di altitudine.

Costanti di ElevationStatus

google.maps.ElevationStatus costanti

Lo stato restituito da ElevationService al termine di una richiesta di altitudine. Specificale 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.
INVALID_REQUEST La richiesta non è valida.
OK La richiesta non ha restituito 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 Impossibile elaborare la richiesta di altitudine, ma il motivo esatto dell'errore non è noto.