Panoramica dell'API Elevation

L'API Elevation è un servizio che restituisce dati di altitudine per una località sulla terra o dati di altitudine campionati lungo i percorsi.

Perché utilizzare l'API Elevation

Con l'API Elevation, puoi sviluppare applicazioni per supportare i tuoi clienti con attività sensibili all'altitudine, applicazioni di posizionamento o sondaggi con bassa probabilità che includono aumenti e variazioni di altitudine lungo i percorsi. Ad esempio, puoi fornire i dati sul dislivello e sulla perdita per migliorare un'applicazione sportiva per attività come escursionismo, ciclismo o immersioni subacquee.

Che cosa puoi fare con l'API Elevation

Con l'API Elevation, puoi includere dati sull'altitudine nelle applicazioni o su una mappa. Ad esempio:

  • Ottieni l'altitudine per un determinato luogo.
  • Calcola le differenze in altitudine lungo un percorso o tra due punti.

Come funziona l'API Elevation

L'API Elevation accetta una richiesta come URL codificato con coordinate di latitudine/longitudine fornite come posizioni discrete o come una serie di posizioni lungo un percorso. Questa richiesta, ad esempio, esegue query sull'altitudine per il centro di Denver, in Colorado, specificando un ritorno in formato JSON. 
  https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

Il servizio ricava l'altitudine per le coordinate fornite. Interpola anche l'altitudine per una località senza altitudine, fornendo una media restituita dalle quattro località più vicine che forniscono dati sull'altitudine. Infine, determina la risoluzione complessiva della località.

Risorse

La tabella riportata di seguito riassume le risorse disponibili tramite l'API Elevation insieme ai dati che restituisce.

Risorse dei dati Dati restituiti Formato restituito
Coordinate di latitudine/longitudine

Puoi fornire i dati come un insieme di una o più località o come serie lungo un percorso. Puoi anche fornire coordinate codificate. Inserisci fino a 512 coordinate.

L'API Elevation fornisce l'altitudine in metri rispetto al livello medio locale del mare (LMSL). L'altitudine può essere restituita come valore positivo o negativo come indicato di seguito:

  • I valori positivi indicano le località al di sopra dell'SGA, comprese le posizioni della superficie o la parte inferiore dei laghi ad alta quota.
  • I valori negativi indicano le località inferiori a SGA, comprese quelle sulla superficie o sul fondale oceanico.
  • Risoluzione indica la distanza tra il punto dati e l'altitudine, in metri.
  • JSON
  • XML

Come utilizzare l'API Elevation

1 Configurazione. Inizia con Configura il tuo progetto Google Cloud e completa le istruzioni per la configurazione che seguono.
2 Prova una richiesta di altitudine Una volta che disponi di una chiave API, puoi iniziare a testare l'API Elevation direttamente dal tuo browser. Per maggiori dettagli, consulta la sezione Richieste di esempio nella Guida introduttiva.
3 Scrivere una richiesta più complessa Dopo aver configurato un progetto, prova a inviare una richiesta che fornisce i dati sulla posizione lungo un percorso. Per i dettagli, consulta Specifica dei percorsi .
4 Nozioni di base sulle risposte Esplora le risposte ai dati relativi all'altitudine per prepararti a utilizzare i dati relativi all'altitudine per la tua app. Per ulteriori dettagli, consulta la pagina Risposte all'altitudine.
5 Incorpora i dati dell'altitudine nella tua app. Puoi utilizzare i dati relativi all'altitudine per migliorare le app basate sulla posizione, ad esempio app per attività sportive o per dati di sondaggi.

Librerie client disponibili

Chiama questa API nel linguaggio che preferisci tramite una delle seguenti librerie client:

Il client Java, il client Python, il client Go e il client Node.js per Google Maps Services sono librerie client supportate dalla community, open source basate sulla licenza Apache 2.0. Scaricali da GitHub, dove puoi anche trovare le istruzioni di installazione e il codice campione.

Passaggi successivi