Per iniziare

L'API Elevation fornisce dati sull'altitudine per tutte le località sulla superficie della Terra, incluse le località in profondità sul fondale oceanico (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

Puoi accedere 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 tua 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 verificarlo 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 tra i punti dati da cui è stata interpolata l'altitudine, in metri).

Consulta la guida per gli sviluppatori per saperne di più sulla creazione di URL di richiesta e sui parametri disponibili e sulla comprensione della 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>
</pre>

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 integrate di attività comuni, come l'autenticazione, la limitazione delle richieste e i nuovi tentativi automatici. 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 policy

Autenticazione

Per utilizzare l'API Elevation, devi prima abilitarla e ottenere le credenziali di autenticazione appropriate. Per saperne di più, consulta Inizia a utilizzare 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 policy relative alle API.

Scopri di più

Puoi fare di più con l'API Elevation, ad esempio richiedere dati sull'altitudine da più località. Per altri esempi e 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 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.