Elevation

Classe ElevationService

google.maps.ElevationService classe

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

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 ElevationService che invia query di elevazione ai server Google.

Metodi
getElevationAlongPath	getElevationAlongPath(request[, callback]) Parametri:  request:  PathElevationRequest callback:  function(Array<ElevationResult> optional, ElevationStatus): void optional 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 il percorso.
getElevationForLocations	getElevationForLocations(request[, callback]) Parametri:  request:  LocationElevationRequest callback:  function(Array<ElevationResult> optional, ElevationStatus): void optional Valore restituito:  Promise<LocationElevationResponse> Crea una richiesta di altitudine per un elenco di località discrete.

Interfaccia LocationElevationRequest

Interfaccia google.maps.LocationElevationRequest

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

Proprietà
locations optional	Tipo:  Array<LatLng|LatLngLiteral> optional Le posizioni discrete per le quali recuperare l'altitudine.

Interfaccia LocationElevationResponse

Interfaccia google.maps.LocationElevationResponse

Una risposta di elevazione 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 sull'elevazione inviata da ElevationService contenente il percorso lungo il quale restituire dati campionati. Questa richiesta definisce un percorso continuo lungo la Terra lungo il quale devono essere effettuati i campioni di altitudine a distanze equidistanti. Tutti i percorsi dal vertice al vertice utilizzano i segmenti del grande cerchio tra questi due punti.

Proprietà
samples	Tipo:  number obbligatorio. Il numero di punti equidistanti lungo il percorso specificato per i quali recuperare i dati di altitudine, 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

Interfaccia google.maps.PathElevationResponse

Una risposta di elevazione restituita da ElevationService contenente l'elenco di ElevationResult a spaziatura 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, composta dal set di coordinate di altitudine 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'altitudine. Questa proprietà non sarà presente se la risoluzione non è nota. Tieni presente che i dati di elevazione diventano più approssimativi (valori resolution più grandi) quando vengono passati più punti. Per ottenere il valore di elevazione più preciso di un punto, la query deve essere eseguita in modo indipendente.
location optional	Tipo:  LatLng optional La posizione del risultato di questa altitudine.

Costanti ElevationStatus

google.maps.ElevationStatus costanti

Lo stato restituito da ElevationService al completamento 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 generato 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.