ElevationService class
google.maps.ElevationService
classe
Definisce una classe di servizio che comunica direttamente con i server Google per richiedere i dati di elevazione.
Accesso chiamando il numero const {ElevationService} = await google.maps.importLibrary("elevation")
.
Consulta Librerie nell'API Maps JavaScript.
Costruttore | |
---|---|
ElevationService |
ElevationService() Parametri: nessuno
Crea una nuova istanza di un ElevationService che invia query di elevazione ai server di Google. |
Metodi | |
---|---|
getElevationAlongPath |
getElevationAlongPath(request[, callback]) Parametri:
Valore restituito:
Promise<PathElevationResponse> Esegue una richiesta di elevazione lungo un percorso, in cui i dati di elevazione vengono restituiti come campioni basati sulla distanza lungo il percorso. |
getElevationForLocations |
getElevationForLocations(request[, callback]) Parametri:
Valore restituito:
Promise<LocationElevationResponse> Invia una richiesta di elevazione per un elenco di località discrete. |
Interfaccia LocationElevationRequest
google.maps.LocationElevationRequest
interfaccia
Una richiesta di elevazione inviata da ElevationService
contenente l'elenco delle coordinate discrete (LatLng
) per le quali restituire i dati di elevazione.
Proprietà | |
---|---|
locations optional |
Tipo:
Array<LatLng|LatLngLiteral> optional Le posizioni discrete per cui recuperare le elevazioni. |
Interfaccia LocationElevationResponse
google.maps.LocationElevationResponse
interfaccia
Una risposta relativa all'altitudine restituita da ElevationService
contenente l'elenco dei ElevationResult
corrispondenti alle posizioni dei LocationElevationRequest
.
Proprietà | |
---|---|
results |
Tipo:
Array<ElevationResult> L'elenco dei ElevationResult corrispondenti alle località del LocationElevationRequest . |
Interfaccia 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 prelevati campioni di elevazione a intervalli equidistanti. Tutti i percorsi da un vertice all'altro utilizzano segmenti del cerchio massimo tra i due punti.
Proprietà | |
---|---|
samples |
Tipo:
number Obbligatorio. Il numero di punti equidistanti lungo il percorso specificato per cui recuperare i dati di elevazione, inclusi i punti finali. 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 relativa all'elevazione restituita da ElevationService
contenente l'elenco dei ElevationResult
equidistanti lungo il percorso di PathElevationRequest
.
Proprietà | |
---|---|
results |
Tipo:
Array<ElevationResult> L'elenco dei ElevationResult corrispondenti agli esempi di 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ò generare più ElevationResult
.
Proprietà | |
---|---|
elevation |
Tipo:
number L'elevazione di questo punto sulla Terra, in metri sopra il livello del mare. |
resolution |
Tipo:
number La distanza, in metri, tra i punti di campionamento da cui è stata interpolata l'elevazione. Questa proprietà non sarà presente se la risoluzione non è nota. Tieni presente che i dati di elevazione diventano più grossolani (valori resolution più grandi) quando vengono superati 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 di elevazione. |
Costanti ElevationStatus
google.maps.ElevationStatus
costanti
Lo stato restituito da ElevationService
al termine di una richiesta di elevazione. Specificali per valore o utilizzando il nome della costante. Ad esempio, 'OK'
o google.maps.ElevationStatus.OK
Accesso chiamando il numero const {ElevationStatus} = await google.maps.importLibrary("elevation")
.
Consulta 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 elevazione. |
UNKNOWN_ERROR |
La richiesta di riassegnazione non è stata elaborata correttamente, ma il motivo esatto del problema non è noto. |