Interfejs Elevation API udostępnia dane wysokościowe 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 po stronie klienta w ramach interfejsu Maps JavaScript API lub po stronie serwera za pomocą klienta Java, klienta Python, klienta Go i klienta Node.js dla usług Map Google.
Przykładowe żądanie i odpowiedź
Dostęp do interfejsu Elevation API uzyskujesz przez interfejs HTTP, a żądania są tworzone jako ciąg znaków w adresie URL. Do identyfikowania lokalizacji lub wierzchołków ścieżki służą współrzędne szerokości i długości geograficznej. Żądania muszą zawierać Twój klucz interfejsu API.
W tym przykładzie żądamy wysokości w Denver w Kolorado, czyli w „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'
Możesz to przetestować, wpisując adres URL w przeglądarce (pamiętaj, aby zastąpić YOUR_API_KEY prawdziwym kluczem interfejsu API).
Odpowiedź zawiera wysokość w danym punkcie w metrach oraz wartość rozdzielczości (maksymalna odległość między punktami danych, z których interpolowano wysokość, w metrach).
Aby dowiedzieć się więcej o tworzeniu adresów URL żądań i dostępnych parametrach oraz o interpretowaniu odpowiedzi, zapoznaj się z przewodnikiem dla programistów.
Poniżej znajduje się 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ć z naszych bibliotek klienta
Biblioteki klienta ułatwiają tworzenie aplikacji korzystających z interfejsów API usługi internetowej Map Google dzięki prostej, natywnej implementacji typowych zadań, takich jak uwierzytelnianie, ograniczanie liczby żądań i automatyczne ponowne próby. Interfejs Elevation API jest dostępny w kliencie Java, kliencie Python, kliencie Go i kliencie 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 logowania. Więcej informacji znajdziesz w artykule Pierwsze kroki z Google Maps Platform.
Limity i ceny
Zapoznaj się ze stroną Korzystanie i rozliczenia, aby dowiedzieć się więcej o limitach i opłatach związanych z interfejsem Elevation API.
Zasady
Korzystanie z interfejsu Elevation API musi być zgodne z zasadami dotyczącymi interfejsu API.
Więcej informacji
Interfejs Elevation API umożliwia też inne działania, np. wysyłanie żądań o dane dotyczące rzeźby terenu z wielu lokalizacji. Więcej przykładów i innych szczegółów znajdziesz w przewodniku dla programistów interfejsu Elevation API.
Przewodnik dla deweloperów interfejsu Elevation API jest przeznaczony dla deweloperów witryn internetowych i aplikacji mobilnych, którzy chcą używać danych o wysokości w mapach udostępnianych przez jeden z interfejsów API Google Maps Platform. Znajdziesz w nim wprowadzenie do korzystania z interfejsu API oraz materiały referencyjne dotyczące dostępnych parametrów.