Interfejs Elevation API udostępnia dane o wysokości dla wszystkich lokalizacji na powierzchni Ziemi, w tym głębokości na dnie oceanu (które zwracają wartości ujemne).
Ta usługa jest też dostępna w ramach interfejsu Maps JavaScript API po stronie klienta oraz do użytku po stronie serwera za pomocą klienta Java, Python, Go i Node.js do usług Map Google.
Przykładowe żądanie i odpowiedź
Dostęp do interfejsu Elevation API uzyskuje się przez interfejs HTTP, gdzie żądania mają postać ciągu adresu URL. Przy użyciu współrzędnych szerokości i długości geograficznej identyfikują lokalizacje lub wierzchołki ścieżki. Żądania muszą zawierać klucz interfejsu API.
Ten przykład prosi o podanie wysokości Denver w stanie Kolorado, czyli „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'
Aby to sprawdzić, wpisz adres URL w przeglądarce (pamiętaj, aby zastąpić YOUR_API_KEY właściwym kluczem interfejsu API).
Odpowiedź zawiera wysokość w tym punkcie podaną w metrach oraz wartość rozdzielczości (maksymalna odległość między punktami danych, z których miała miejsce interpolacja wysokości, wyrażona w metrach).
Więcej informacji o tworzeniu adresów URL żądań i dostępnych parametrach oraz o 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>
Zacznij kodować za pomocą naszych bibliotek klienta
Biblioteki klienta ułatwiają programowanie za pomocą interfejsów API usług internetowych Map Google, udostępniając proste, natywne implementacje typowych zadań, takich jak uwierzytelnianie, ograniczanie żądań i automatyczne ponawianie. Interfejs Elevation API jest dostępny dla klientów Java, Python, Go i Node.js dla usług Map Google.
Uwierzytelnianie, limity, ceny i zasady
Uwierzytelnianie
Aby korzystać z interfejsu Elevation API, musisz najpierw go włączyć i uzyskać odpowiednie dane uwierzytelniające. Więcej informacji znajdziesz w artykule o pierwszych krokach z Google Maps Platform.
Limity i ceny
Sprawdź stronę użytkowania i płatności, aby uzyskać szczegółowe informacje o limitach i cenach interfejsu Elevation API.
Zasady
Korzystanie z interfejsu Elevation API musi być zgodne z zasadami interfejsu API.
Więcej informacji
Interfejs Elevation API zapewnia jeszcze więcej możliwości, na przykład żądanie danych o wysokości z wielu lokalizacji. Więcej przykładów i inne informacje znajdziesz w przewodniku dla programistów interfejsu Elevation API.
Przewodnik dla programistów interfejsu Elevation API dla programistów jest przeznaczony dla programistów witryn i aplikacji mobilnych, którzy chcą używać danych o wysokości na mapach udostępnianych przez jeden z interfejsów API Google Maps Platform. Zawiera wprowadzenie do korzystania z interfejsu API oraz materiały referencyjne na temat dostępnych parametrów.