Elevation

Classe ElevationService

google.maps.ElevationService libreria di
classi "elevation"

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

const {ElevationService} = await google.maps.importLibrary("elevation");
ElevationService
ElevationService()
Parametri: nessuno
Crea una nuova istanza di un ElevationService che invia query di elevazione ai server Google.
getElevationAlongPath
getElevationAlongPath(request[, callback])
Parametri:
Valore restituito: Promise<PathElevationResponse>
Effettua una richiesta di altitudine lungo un percorso, dove i dati di altitudine vengono restituiti come campioni basati sulla distanza lungo quel percorso.
getElevationForLocations
getElevationForLocations(request[, callback])
Parametri:
Effettua una richiesta di altitudine per un elenco di località distinte.

Interfaccia LocationElevationRequest

Interfaccia google.maps.LocationElevationRequest

Una richiesta di altitudine inviata da ElevationService contenente l'elenco di coordinate discrete (LatLng) per cui restituire i dati di altitudine.

locations
facoltativo
Tipo: Array<LatLng|LatLngLiteral> optional
Le singole località per cui recuperare le altitudini.

Interfaccia LocationElevationResponse

Interfaccia google.maps.LocationElevationResponse

Una risposta di altitudine restituita da ElevationService contenente l'elenco di ElevationResult corrispondenti alle località di LocationElevationRequest.

results
L'elenco di ElevationResult corrispondenti alle località di LocationElevationRequest.

Interfaccia PathElevationRequest

Interfaccia google.maps.PathElevationRequest

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 i campioni di altitudine devono essere prelevati a distanze equidistanti. Tutti i percorsi da vertice a vertice utilizzano segmenti del cerchio massimo tra questi due punti.

samples
Tipo: number
Obbligatorio. Il numero di punti equidistanti lungo il percorso specificato per i quali recuperare i dati sull'altitudine, inclusi i punti di arrivo. Il numero di campioni deve essere un valore compreso tra 2 e 512 inclusi.
path
facoltativo
Tipo: Array<LatLng|LatLngLiteral> optional
Il percorso lungo il quale raccogliere i valori di altitudine.

Interfaccia PathElevationResponse

Interfaccia google.maps.PathElevationResponse

Una risposta di altitudine restituita da ElevationService contenente l'elenco di ElevationResult distanziati in modo uniforme lungo il percorso di PathElevationRequest.

results
L'elenco di ElevationResult corrispondenti agli esempi di PathElevationRequest.

Interfaccia ElevationResult

Interfaccia google.maps.ElevationResult

Il risultato di una richiesta ElevationService, costituito dall'insieme di coordinate di altitudine e dai relativi valori di altitudine. Tieni presente che una singola richiesta può 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 di campionamento da cui è stata interpolata l'altitudine. Questa proprietà non sarà presente se la risoluzione non è nota. Tieni presente che i dati sull'altitudine diventano più approssimativi (valori resolution più grandi) quando vengono passati più punti. Per ottenere il valore di altitudine più accurato per un punto, questo deve essere interrogato in modo indipendente.
location
facoltativo
Tipo: LatLng optional
La posizione di questo risultato di altitudine.

Costanti ElevationStatus

google.maps.ElevationStatus libreria di costanti
"elevation"

Lo stato restituito da ElevationService al completamento di una richiesta di elevazione. Specifica questi valori in base al valore o utilizzando il nome della costante. Ad esempio, 'OK' o google.maps.ElevationStatus.OK

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo ElevationStatusString.

const {ElevationStatus} = await google.maps.importLibrary("elevation");
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 Non è stato possibile elaborare la richiesta di elevazione, ma il motivo esatto dell'errore non è noto.