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ührenDu 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 abrufenPostman-Sammlung
Die OpenAPI-Spezifikation ist auch als Postman-Sammlung verfügbar.
In Postman ausführenCodierung 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.