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> optionalLe 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:
numberObbligatorio. 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> optionalIl 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:
numberL'elevazione di questo punto sulla Terra, in metri sopra il livello del mare. |
resolution |
Tipo:
numberLa 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 optionalLa 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. |