Per iniziare

L'API Elevation fornisce dati altimetrici relativi a tutte le località sulla superficie della Terra, inclusi i punti 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 Java Client, Python Client, Go Client e Node.js Client per i servizi Google Maps.

Esempio di richiesta e risposta

Accedi all'API Elevation tramite un'interfaccia HTTP, con richieste create come stringa URL, utilizzando le coordinate di latitudine/longitudine per identificare le località o i vertici del percorso. Le richieste devono includere la chiave API.

L'esempio seguente richiede l'elevazione di Denver, 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 testare questa operazione 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 di risoluzione (la distanza massima tra i punti dati da cui è stata interpolata l'elevazione, in metri).

Per ulteriori informazioni sulla creazione degli URL delle richieste e sui parametri disponibilie sullacomprensione della risposta , consulta laguida per gli sviluppatori.

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>
</pre>

Inizia a scrivere codice con le nostre librerie client

Le librerie client semplificano lo sviluppo con le API dei servizi web di Google Maps fornendo implementazioni integrate di attività comuni, come autenticazione, limitazione delle richieste e riprovo automatico. L'API Elevation è disponibile in Java Client, Python Client, Go Client e Node.js Client per i servizi Google Maps.

Autenticazione, quote, prezzi e norme

Autenticazione

Per utilizzare l'API Elevation, devi prima abilitarla e ottenere le credenziali di autenticazione appropriate. Per ulteriori informazioni, consulta la pagina Inizia a utilizzare Google Maps Platform.

Quote e prezzi

Consulta la pagina relativa all'utilizzo e alla fatturazione per i dettagli 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 altro con l'API Elevation, ad esempio richiedere dati altimetrici da più località. Per altri esempi e altri dettagli, consulta la Guida per gli sviluppatori dell'API Elevation.

La Guida per gli sviluppatori dell'API Elevation è destinata agli sviluppatori di siti web e app mobile che vogliono utilizzare i dati altimetrici all'interno delle mappe fornite da una delle API di Google Maps Platform. Fornisce un'introduzione all'utilizzo dell'API e materiale di riferimento sui parametri disponibili.