L'API Elevation fornisce dati sull'altitudine per tutte le località della superficie terrestre, incluse le posizioni di 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 client Java, client Python, client Go e client Node.js per Google Maps Services.
Esempio di richiesta e risposta
Accedi all'API Elevation tramite un'interfaccia HTTP, con richieste create come stringa URL, che utilizzano 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 per Denver, in Colorado, "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'
JavaScript
var axios = require('axios'); var config = { method: 'get', url: 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY', headers: { } }; axios(config) .then(function (response) { console.log(JSON.stringify(response.data)); }) .catch(function (error) { console.log(error); });
Python
import requests url = "https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY" payload={} headers = {} response = requests.request("GET", url, headers=headers, data=payload) print(response.text)
Java
OkHttpClient client = new OkHttpClient().newBuilder() .build(); MediaType mediaType = MediaType.parse("text/plain"); RequestBody body = RequestBody.create(mediaType, ""); Request request = new Request.Builder() .url("https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY") .method("GET", body) .build(); Response response = client.newCall(request).execute();
Ruby
require "uri" require "net/http" url = URI("https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY") https = Net::HTTP.new(url.host, url.port) https.use_ssl = true request = Net::HTTP::Get.new(url) response = https.request(request) puts response.read_body
Go
package main import ( "fmt" "net/http" "io/ioutil" ) func main() { url := "https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536,-104.9847034&key=YOUR_API_KEY" method := "GET" client := &http.Client { } req, err := http.NewRequest(method, url, nil) if err != nil { fmt.Println(err) return } res, err := client.Do(req) if err != nil { fmt.Println(err) return } defer res.Body.Close() body, err := ioutil.ReadAll(res.Body) if err != nil { fmt.Println(err) return } fmt.Println(string(body)) }
Postino
La specifica OpenAPI è disponibile anche come raccolta Postman.
Esegui in PostmanPuoi 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 ulteriori informazioni sulla creazione di URL di richiesta e i 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>
Specifica OpenAPI
La specifica OpenAPI è pubblicata per questa API ed è disponibile su GitHub.
Specifica la specifica OpenAPICollezione Postman
La specifica OpenAPI è disponibile anche come raccolta Postman.
Esegui in PostmanInizia a programmare con le nostre librerie client
Le librerie client semplificano lo sviluppo con le API del servizio 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 nel client Java, client Python, client Go e client Node.js per i servizi Google Maps.
Autenticazione, quote, prezzi e criteri
Autenticazione
Per utilizzare l'API Elevation, devi prima attivarla e ottenere le credenziali di autenticazione corrette. Per ulteriori informazioni, consulta la pagina Inizia a utilizzare Google Maps Platform.
Quote e prezzi
Consulta la pagina Utilizzo e 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 API.
Scopri di più
Puoi fare molto di più con l'API Elevation, come richiedere dati relativi all'altitudine provenienti da più località. Per altri esempi e altri dettagli, consulta la guida per gli sviluppatori dell'API Elevation.
La guida per gli sviluppatori di Elevation API è rivolta agli sviluppatori di siti web e dispositivi mobili che vogliono utilizzare i dati di elevazione all'interno delle mappe fornite da una delle API di Google Maps Platform. Fornisce un'introduzione all'utilizzo dell'API e del materiale di riferimento per i parametri disponibili.