Panoramica dell'API Elevation

L'API Elevation è un servizio che restituisce dati sull'altitudine relativi a 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 applicazioni di rilevazione bassa, che includono dislivelli e dislivelli lungo i percorsi. Ad esempio, è possibile fornire dati sull'aumento e la perdita di altitudine per migliorare un'applicazione sportiva per attività quali escursionismo, ciclismo o immersioni subacquee.

Cosa puoi fare con l'API Elevation

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

  • Ottieni l'altitudine di un luogo specifico.
  • Calcola le differenze di altitudine lungo un percorso o tra due punti.

Come funziona l'API Elevation

L'API Elevation accetta una richiesta come URL codificato con le coordinate di latitudine/longitudine fornite come località discrete o come serie di località lungo un percorso. Questa richiesta, ad esempio, esegue query sull'elevazione per il centro di Denver, in Colorado, specificando un valore restituito 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'elevazione per le coordinate fornite. Interpola anche l'elevazione di 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 seguente tabella riassume le risorse disponibili tramite l'API Elevation insieme ai dati che restituisce.

Risorse di dati Dati restituiti Formato del reso
Coordinate di latitudine/longitudine

Puoi fornire i dati come un insieme di una o più località o come una serie lungo un percorso. Puoi anche fornire coordinate codificate. 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 valori positivi o negativi, come indicato di seguito:

  • I valori positivi indicano le posizioni sopra SGAL, incluse le posizioni della superficie o il fondo di laghi ad alta quota.
  • I valori negativi indicano le posizioni al di sotto di SGAL, incluse le posizioni 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 Preparati. Inizia con Configura il tuo progetto Google Cloud e completa le istruzioni di configurazione che seguono.
2 Prova una richiesta di altitudine Dopo aver ottenuto una chiave API, puoi iniziare a testare l'API Elevation direttamente dal tuo browser. Per maggiori dettagli, consulta Richieste di esempio nella Guida introduttiva.
3 Scrivere una richiesta più complessa Dopo aver configurato un progetto, prova una richiesta che fornisca dati sulla località lungo un percorso. Per maggiori dettagli, consulta la sezione Specifica dei percorsi .
4 Informazioni di base sulle risposte Esplora le risposte dei dati sull'altitudine per prepararti a utilizzare questi dati per la tua app. Consulta Risposte sull'altitudine per i dettagli.
5 Incorpora i dati sull'altitudine nella tua app. Puoi utilizzare i dati sull'altitudine per migliorare le app basate sulla posizione, ad esempio quelle per le attività sportive o per i dati dei sondaggi.

Librerie client disponibili

Chiama questa API nel linguaggio di tua scelta tramite una delle seguenti librerie client:

I client Java, Python, Go e Node.js per i servizi Google Maps sono librerie client supportate dalla community e open source previste dalla licenza Apache 2.0. Scaricali da GitHub, dove puoi anche trovare istruzioni per l'installazione e codice di esempio.

Passaggi successivi