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. |