L'API Elevation fornisce dati altimetrici relativi a tutte le località sulla superficie terrestre, inclusi i punti in profondità dei fondali oceanici (che restituiscono valori negativi).
Questo servizio è disponibile anche nell'ambito dell'API Maps JavaScript lato client o per l'utilizzo lato server con Client Java, Python Client, Go Client e Node.js Client per i servizi Google Maps.
Esempio di richiesta e risposta
Puoi accedere all'API Elevation tramite un'interfaccia HTTP, con le richieste create come stringa URL, utilizzando le coordinate di latitudine/longitudine per identificare le posizioni o i vertici del percorso. Le richieste devono includere la chiave API.
L'esempio seguente richiede l'altitudine di Denver, in Colorado, la "Mile High City", in formato JSON:
URL
https://maps.googleapis.com/maps/api/elevation/json ?locations=39.7391536%2C-104.9847034 &key=YOUR_API_KEY
cURL
curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'
Puoi verificare inserendo l'URL nel browser web (assicurati di sostituire YOUR_API_KEY con la tua chiave API effettiva).
La risposta include l'altitudine in quel punto in metri, insieme al valore di risoluzione (la distanza massima in metri tra i punti dati da cui è stata interpolata l'altitudine).
Consulta la guida per gli sviluppatori per ulteriori informazioni sulla creazione di URL di richieste di creazione e sui parametri disponibili e per comprendere la risposta.
Di seguito è riportato un esempio di risposta:
JSON
{
"results":
[
{
"elevation": 1608.637939453125,
"location": { "lat": 39.7391536, "lng": -104.9847034 },
"resolution": 4.771975994110107,
},
],
"status": "OK",
}XML
<ElevationResponse> <status>OK</status> <result> <location> <lat>39.7391536</lat> <lng>-104.9847034</lng> </location> <elevation>1608.6379395</elevation> <resolution>4.7719760</resolution> </result> </ElevationResponse>
Inizia a programmare con le nostre librerie client
Le librerie client semplificano lo sviluppo con le API dei servizi web di Google Maps fornendo implementazioni semplici e native di attività comuni, come autenticazione, limitazione delle richieste e nuovi tentativi automatici. L'API Elevation è disponibile in Client Java, Python Client, Go Client e Node.js per i servizi Google Maps.
Autenticazione, quote, prezzi e criteri
Autenticazione
Per utilizzare l'API Elevation, devi prima abilitarla e ottenere le credenziali di autenticazione corrette. Per maggiori informazioni, consulta la guida introduttiva a Google Maps Platform.
Quote e prezzi
Consulta la pagina relativa a utilizzo e fatturazione per i dettagli sulle quote e sui prezzi impostati per l'API Elevation.
Criteri
L'utilizzo dell'API Elevation deve essere conforme alle norme dell'API.
Scopri di più
Puoi fare di più con l'API Elevation, come richiedere dati sull'altitudine da più località. Per ulteriori esempi e altri dettagli, consulta la guida per gli sviluppatori dell'API Elevation.
La guida per gli sviluppatori dell'API Elevation è rivolta agli sviluppatori di siti web e dispositivi mobili che vogliono utilizzare i dati sull'altitudine all'interno di mappe fornite da una delle API Google Maps Platform. Fornisce un'introduzione all'utilizzo dell'API e materiale di riferimento sui parametri disponibili.