Classe ElevationService
google.maps.ElevationService
corso
Definisce una classe di servizio che comunica direttamente con i server Google per richiedere i dati sull'elevazione.
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 un ElevationService che invia query sull'elevazione ai server di Google. |
Metodi | |
---|---|
getElevationAlongPath |
getElevationAlongPath(request[, callback]) Parametri:
Valore restituito:
Promise<PathElevationResponse> Effettua una richiesta di dati sull'elevazione lungo un percorso, dove i dati sull'elevazione vengono restituiti come campioni basati sulla distanza lungo il percorso. |
getElevationForLocations |
getElevationForLocations(request[, callback]) Parametri:
Valore restituito:
Promise<LocationElevationResponse> Effettua una richiesta di dati sull'elevazione per un elenco di località distinte. |
Interfaccia LocationElevationRequest
google.maps.LocationElevationRequest
interfaccia
Una richiesta di dati sull'elevazione inviata da ElevationService
contenente l'elenco di coordinate discrete (LatLng
) per le quali restituire i dati sull'elevazione.
Proprietà | |
---|---|
locations optional |
Tipo:
Array<LatLng|LatLngLiteral> optional Le posizioni distinte per cui recuperare le altezze. |
Interfaccia LocationElevationResponse
google.maps.LocationElevationResponse
interfaccia
Una risposta relativa all'elevazione restituita dal ElevationService
contenente l'elenco dei ElevationResult
corrispondenti alle posizioni dei LocationElevationRequest
.
Proprietà | |
---|---|
results |
Tipo:
Array<ElevationResult> L'elenco di ElevationResult corrispondenti alle località del LocationElevationRequest . |
Interfaccia PathElevationRequest
google.maps.PathElevationRequest
interfaccia
Una query sull'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 acquisiti campioni di elevazione a distanze equidistanti. Tutti i percorsi da un vertice all'altro utilizzano i segmenti del cerchio massimo tra i due punti.
Proprietà | |
---|---|
samples |
Tipo:
number Obbligatorio. Il numero di punti equidistanti lungo il percorso specificato per i quali recuperare i dati sull'elevazione, 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
google.maps.PathElevationResponse
interfaccia
Una risposta di elevazione restituita da ElevationService
contenente l'elenco di ElevationResult
equidistanti lungo il percorso di PathElevationRequest
.
Proprietà | |
---|---|
results |
Tipo:
Array<ElevationResult> L'elenco di ElevationResult corrispondenti ai campioni del PathElevationRequest . |
Interfaccia ElevationResult
google.maps.ElevationResult
interfaccia
Il risultato di una richiesta ElevationService
, costituito dall'insieme di coordinate di elevazione 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'elevazione. Questa proprietà non sarà presente se la risoluzione non è nota. Tieni presente che i dati sull'elevazione diventano meno precisi (valori resolution più grandi) quando vengono passati più punti. Per ottenere il valore di elevazione più preciso per un punto, è necessario eseguire una query in modo indipendente. |
location optional |
Tipo:
LatLng optional La posizione di questo risultato relativo all'elevazione. |
Costanti ElevationStatus
google.maps.ElevationStatus
costanti
Lo stato restituito da ElevationService
al termine 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 riscontrato 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 altezza. |
UNKNOWN_ERROR |
Non è stato possibile elaborare correttamente la richiesta di elevazione, ma il motivo esatto dell'errore non è noto. |