L'API Elevation fornisce dati altimetrici relativi a tutte le località sulla superficie della Terra, incluse le posizioni in profondità dei fondali oceanici (che restituiscono valori negativi).
Questo servizio è disponibile anche come parte dell'API Maps JavaScript lato client o per l'utilizzo lato server con il client Java, il client Python, il client Go e il client Node.js per i servizi Google Maps.
Richiesta e risposta di esempio
Accedi all'API Elevation tramite un'interfaccia HTTP, con richieste costruite come stringa URL, utilizzando le coordinate di latitudine/longitudine per identificare le posizioni o i vertici del percorso. Le richieste devono includere la tua chiave API.
L'esempio seguente richiede l'elevazione di Denver, in Colorado, la "città a un'altitudine di 1000 metri", 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 testarlo inserendo l'URL nel browser web (assicurati di sostituire
YOUR_API_KEY con la tua chiave API effettiva).
La risposta include l'elevazione in quel punto, in metri, insieme al valore della risoluzione (la distanza massima tra i punti dati da cui è stata interpolata l'elevazione, in metri).
Consulta la guida per gli sviluppatori per saperne di più su come creare URL di richiesta e parametri disponibili e su come interpretarne la risposta.
Di seguito è riportata una risposta di esempio:
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 di servizio web di Google Maps fornendo implementazioni native semplici di attività comuni, come l'autenticazione, la limitazione delle richieste e il nuovo tentativo automatico. L'API Elevation è disponibile nel client Java, nel client Python, nel client Go e nel client Node.js per i servizi Google Maps.
Autenticazione, quote, prezzi e norme
Autenticazione
Per utilizzare l'API Elevation, devi prima attivarla e ottenere le credenziali di autenticazione appropriate. Per saperne di più, consulta Introduzione a Google Maps Platform.
Quote e prezzi
Consulta la pagina Utilizzo e fatturazione per informazioni dettagliate sulle quote e sui prezzi impostati per l'API Elevation.
Norme
L'utilizzo dell'API Elevation deve essere conforme alle norme dell'API.
Scopri di più
Puoi fare molto di più con l'API Elevation, ad esempio richiedere dati sull'elevazione 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 di app mobile che vogliono utilizzare i dati sull'elevazione all'interno delle mappe forniti da una delle API di Google Maps Platform. Fornisce un'introduzione all'utilizzo dell'API e materiale di riferimento sui parametri disponibili.