Interfejs Elevation API udostępnia dane o wysokości wszystkich lokalizacji na powierzchni Ziemi, w tym głębokość lokalizacji na dnie oceanu (które zwracają wartości ujemne).
Ta usługa jest również dostępna w ramach interfejsu API JavaScript Map Google lub po stronie serwera z użyciem klientów Java, Python, Go i Node.js dla Map Google.
Przykładowe żądanie i odpowiedź
Dostęp do interfejsu Elevation API możesz uzyskać za pomocą interfejsu HTTP z żądaniami utworzonymi w postaci ciągu URL z wykorzystaniem współrzędnych geograficznych do określania lokalizacji lub wierzchołków ścieżek. Żądania muszą zawierać klucz interfejsu API.
W tym przykładzie podano wysokość w formacie JSON w Denver, Kolorado i "Mile High City" w formacie 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)) }
Postmana
Specyfikacja OpenAPI jest też dostępna jako kolekcja Postman.
Uruchom w PostmanAby to sprawdzić, wpisz adres URL w przeglądarce (zastąp ciąg YOUR_API_KEY
rzeczywistym kluczem interfejsu API).
Odpowiedź obejmuje wysokość wyrażoną w metrach i wartość rozdzielczości (maks. odległość między punktami danych, w której wysokość jest interpolowana, w metrach).
Więcej informacji o tworzeniu adresów URL żądań i dostępnych parametrach oraz interpretowaniu odpowiedzi znajdziesz w przewodniku dla programistów.
Oto przykładowa odpowiedź:
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>
Specyfikacja OpenAPI
Specyfikacja OpenAPI została opublikowana dla tego interfejsu API i dostępna w GitHub.
Pobranie specyfikacji OpenAPIKolekcja Postman
Specyfikacja OpenAPI jest też dostępna jako kolekcja Postman.
Uruchom w PostmanZacznij kodować z naszymi bibliotekami klienta
Biblioteki klienta ułatwiają programowanie za pomocą interfejsów API usługi internetowej Map Google, zapewniając proste, natywne implementacje typowych zadań, takich jak uwierzytelnianie, ograniczanie żądań czy automatyczna ponowna próba. Interfejs Elevation API jest dostępny w klientach Java, Python, Go Client i Node.js dla Map Google.
Uwierzytelnianie, limity, ceny i zasady
Uwierzytelnianie
Aby korzystać z interfejsu Elevation API, musisz najpierw go włączyć i uzyskać prawidłowe dane uwierzytelniające. Więcej informacji znajdziesz w artykule Pierwsze kroki z Google Maps Platform.
Limity i ceny
Szczegóły na temat limitów i cen ustawionych w interfejsie Elevation API znajdziesz na stronie użytkowania i rozliczeń.
Zasady
Korzystanie z interfejsu API Elevation musi być zgodne z zasadami interfejsu API.
Więcej informacji
Interfejs API Elevation API oferuje więcej możliwości, na przykład żądanie danych o wysokości z wielu lokalizacji. Więcej przykładów i inne szczegóły znajdziesz w przewodniku dla programistów interfejsu API Elevation.
Przewodnik dla programistów korzystających z interfejsu Elevation API jest przeznaczony dla deweloperów witryn i urządzeń mobilnych, którzy chcą korzystać z danych o wysokości w mapach udostępnianych przez jeden z interfejsów API Google Maps Platform. Wprowadzenie do korzystania z interfejsu API i materiałów referencyjnych na temat dostępnych parametrów.