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");
Costruttore | |
|---|---|
ElevationService |
ElevationService()Parametri: nessuno
Crea una nuova istanza di un ElevationService che invia query di elevazione ai server Google. |
Metodi | |
|---|---|
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:
Valore restituito:
Promise<LocationElevationResponse>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.
Proprietà | |
|---|---|
locations
facoltativo |
Tipo:
Array<LatLng|LatLngLiteral> optionalLe 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.
Proprietà | |
|---|---|
results |
Tipo:
Array<ElevationResult>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.
Proprietà | |
|---|---|
samples |
Tipo:
numberObbligatorio. 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> optionalIl 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.
Proprietà | |
|---|---|
results |
Tipo:
Array<ElevationResult>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.
Proprietà | |
|---|---|
elevation |
Tipo:
numberL'altitudine di questo punto sulla Terra, in metri sul livello del mare. |
resolution |
Tipo:
numberLa 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 optionalLa 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");
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 |
Non è stato possibile elaborare la richiesta di elevazione, ma il motivo esatto dell'errore non è noto. |