Jetzt starten

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Die Elevation API stellt Höhendaten für alle Standorte auf der Erdoberfläche bereit, einschließlich der Tiefenpositionen auf dem Meeresboden, die negative Werte zurückgeben.

Dieser Dienst ist auch als Teil der clientseitigen Maps JavaScript API oder auf Serverseite mit dem Java-Client, Python-Client, Go-Client und Node.js-Client für Google Maps-Dienste verfügbar.

Beispielanforderung und -antwort

Der Zugriff auf die Elevation API erfolgt über eine HTTP-Schnittstelle. Die Anfragen werden als URL-String erstellt und die Breiten- und Längengrade werden zur Identifizierung der Standorte oder Pfadeckpunkte verwendet. Anforderungen müssen Ihren API-Schlüssel enthalten.

Im folgenden Beispiel wird die Höhe für Denver, Colorado, die „Mile High City“ im JSON-Format angefordert:

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

Einfach loslegen (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))
}

Postbote

Die OpenAPI-Spezifikation ist auch als Postman-Sammlung verfügbar.

In Postman ausführen

Du kannst dies testen, indem du die URL in deinen Webbrowser eingibst. Achte dabei darauf, YOUR_API_KEY durch deinen tatsächlichen API-Schlüssel zu ersetzen. Die Antwort enthält die Höhe an diesem Punkt in Metern sowie den Auflösungswert (die maximale Entfernung zwischen Datenpunkten, von denen aus die Höhe interpoliert wurde, in Metern).

Weitere Informationen zum Erstellen von Anfrage-URLs und verfügbaren Parametern und zum Verstehen der Antwort finden Sie im Entwicklerleitfaden.

Hier eine Beispielantwort:

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>

OpenAPI-Spezifikation

Die OpenAPI-Spezifikation wurde für diese API veröffentlicht und auf GitHub verfügbar.

OpenAPI-Spezifikation abrufen

Postman-Sammlung

Die OpenAPI-Spezifikation ist auch als Postman-Sammlung verfügbar.

In Postman ausführen

Codierung mit unseren Clientbibliotheken

Clientbibliotheken erleichtern die Entwicklung mit den Google Maps-Webdienst-APIs und ermöglichen einfache, native Implementierungen gängiger Aufgaben wie Authentifizierung, Anfragedrosselung und automatischer Wiederholungsversuch. Die Elevation API ist im Java-, Python-, Go- und Node.js-Client für Google Maps-Dienste verfügbar.

Authentifizierung, Kontingente, Preise und Richtlinien

Authentifizierung

Wenn Sie die Elevation API verwenden möchten, müssen Sie sie zuerst aktivieren und die richtigen Authentifizierungsdaten abrufen. Weitere Informationen finden Sie unter Erste Schritte mit der Google Maps Platform.

Kontingente und Preise

Weitere Informationen zu den für die Elevation API festgelegten Kontingenten und Preisen finden Sie auf der Seite Nutzung und Abrechnung.

Richtlinien

Die Verwendung der Elevation API muss den API-Richtlinien entsprechen.

Weitere Informationen

Mit der Elevation API haben Sie noch mehr Möglichkeiten, beispielsweise können Sie Höhendaten aus verschiedenen Quellen anfordern. Weitere Beispiele und Details finden Sie im Entwicklerleitfaden für die Elevation API.

Der Entwicklerleitfaden für die Elevation API richtet sich an Entwickler von Websites und mobilen Apps, die Höhendaten in Karten verwenden möchten, die über eine der Google Maps Platform APIs bereitgestellt werden. Sie enthält eine Einführung in die Verwendung der API und des Referenzmaterials zu den verfügbaren Parametern.