Per iniziare

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 Postman

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 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 OpenAPI

Collezione Postman

La specifica OpenAPI è disponibile anche come raccolta Postman.

Esegui in Postman

Inizia 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.