Panoramica dell'API Elevation

L'API Elevation è un servizio che restituisce i dati di altitudine per un luogo sulla Terra o dati di elevazione campionati lungo percorsi.

Perché utilizzare l'API Elevation

Con l'API Elevation, puoi sviluppare applicazioni per supportare i tuoi Clienti con attività sensibili all'elevazione, applicazioni di posizionamento o sondaggi con limitazioni applicazioni che includono dislivelli e dislivelli lungo i percorsi. Ad esempio: puoi fornire dati relativi alla perdita e al dislivello per migliorare un'applicazione sportiva per attività come ad esempio trekking, ciclismo o immersioni.

Cosa puoi fare con l'API Elevation

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

  • Visualizza l'altitudine di un determinato luogo.
  • Calcola le differenze di elevazione 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'elevazione del 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'elevazione per le coordinate fornite. Inoltre, esegue l'interpolazione l'altitudine per una località senza altitudine, fornendo una media restituita dai quattro località più vicine che forniscono dati di altitudine. Infine, determina il livello risoluzione del luogo.

Risorse

La tabella seguente riassume le risorse disponibili tramite API Elevation insieme ai dati che restituisce.

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

I dati possono essere forniti come un insieme di una o più località o come serie lungo un percorso. Tu può anche fornire coordinate codificate. Puoi inserire fino a 512 coordinate.

L'API Elevation fornisce l'elevazione in metri relativa al livello medio del mare locale (LMSL). L'elevazione può essere restituita come positiva valori negativi o negativi, come indicato di seguito:

  • I valori positivi indicano posizioni superiori all'SGAL, comprese le posizioni in superficie o i fondali di laghi ad alta quota.
  • I valori negativi indicano le località al di sotto del sistema SGAL, tra cui luoghi sulla superficie o sul fondale oceanico.
  • Risoluzione indica la distanza tra il punto dati e di altitudine, in metri.
  • JSON
  • XML

Come utilizzare l'API Elevation

1 Configurazione. Inizia con l'articolo Configura il tuo Progetto Google Cloud e completare la configurazione istruzioni che seguono.
2 Prova una richiesta di elevazione Una volta ottenuta una chiave API, puoi iniziare a testare l'API Elevation direttamente da nel browser. Vedi Richieste di esempio nella Guida introduttiva per maggiori dettagli.
3 Scrivere una richiesta più complessa Una volta creato un progetto, prova a effettuare una richiesta che fornisca i dati sulla posizione insieme a del tuo percorso di apprendimento. Consulta la sezione Specifica dei percorsi per maggiori dettagli.
4 Nozioni di base sulle risposte Esplora le risposte dei dati di altitudine per prepararti a utilizzare i dati di altitudine per la tua app. Consulta Risposte relative all'elevazione per maggiori dettagli.
5 Incorpora i dati di altitudine nella tua app. Puoi utilizzare i dati di altitudine per migliorare le app basate sulla posizione, come le app per lo sport attività o per i dati dei sondaggi.

Librerie client disponibili

Chiama questa API nella lingua di la tua scelta tramite una delle seguenti librerie client:

Client Java, client Python, client Go e client Node.js per Google Maps I servizi sono librerie client supportate dalla community, open source secondo Licenza Apache 2.0. Scaricale da GitHub, dove puoi trovare anche le istruzioni per l'installazione e il codice di esempio.

Passaggi successivi