Per iniziare

L'API Elevation fornisce dati sull'altitudine per tutte le località sulla superficie terrestre, incluse quelle di profondità nel 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 i servizi Google Maps.

Esempio di richiesta e risposta

Puoi accedere all'API Elevation tramite un'interfaccia HTTP, con richieste create come stringa URL e che utilizzano le coordinate di latitudine e 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, in Colorado, nel "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

URL

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, espressa 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 dello sviluppatore per saperne di più sulla creazione di URL di richiesta e parametri disponibili e sulla comprensione della 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>

Specifica OpenAPI

La specifica OpenAPI è pubblicata per questa API e disponibile su GitHub.

Scarica 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 dei servizi web di Google Maps fornendo semplici implementazioni native di attività comuni, come l'autenticazione, la limitazione delle richieste e i tentativi automatici. L'API Elevation è disponibile nei 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 abilitarla e ottenere le credenziali di autenticazione corrette. Per maggiori informazioni, consulta la guida introduttiva a Google Maps Platform.

Quote e prezzi

Consulta la pagina relativa a utilizzo e fatturazione per i dettagli sulle quote e sui prezzi impostati per l'API Elevation.

Criteri

L'utilizzo dell'API Elevation deve essere conforme alle norme relative alle API.

Scopri di più

Puoi fare di più con l'API Elevation, come la richiesta di dati sull'altitudine 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 dispositivi mobili che vogliono utilizzare i dati di elevazione nelle mappe fornite da una API di Google Maps Platform. Fornisce un'introduzione all'uso dell'API e del materiale di riferimento sui parametri disponibili.