Omówienie interfejsu Elevation API

Interfejs Elevation API to usługa, która zwraca dane wysokości względnej dla danej lokalizacji na Ziemi lub próbkuje dane wysokości względnej wzdłuż ścieżek.

Dlaczego warto używać interfejsu Elevation API

Za pomocą interfejsu Elevation API możesz opracowywać aplikacje ułatwiające klientom reagowanie na zmiany wzniesień, pozycjonowanie lub tworzenie niskoankietowych aplikacji, które zawierają informacje o wysokości i zmianie wysokości terenu na trasie. Możesz na przykład podać dane o wzroście i utracie, aby aplikacja sportowa mogła uprawiać wędrówki piesze, rowerowe lub nurkować.

Co możesz robić za pomocą interfejsu Elevation API

Za pomocą interfejsu Elevation API możesz uwzględnić dane wysokości w aplikacjach lub na mapie. Na przykład:

  • Uzyskaj wzniesienie dla danego miejsca.
  • Oblicz różnice wzniesień wzdłuż trasy lub między 2 punktami.

Jak działa interfejs Elevation API

Interfejs Elevation API akceptuje żądanie jako zakodowany adres URL ze współrzędnymi szerokości i długości geograficznej, przedstawionymi jako osobne lokalizacje lub jako szereg lokalizacji na ścieżce. To żądanie może na przykład przesłać wysokość w środku Denver w Kolorado, określając zwrot w formacie JSON. 
  https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

Usługa unosi wysokość podanych współrzędnych. Pozwala również interpolować położenie w przypadku lokalizacji bez wzniesienia – to średnia wartość zwrócona z 4 najbliższych lokalizacji, które zapewniają dane o wysokości. Określa też ogólną rozdzielczość danej lokalizacji.

Zasoby

Poniższa tabela zawiera podsumowanie zasobów dostępnych w interfejsie API Elevation oraz danych, które są zwracane.

Zasoby danych Zwrócone dane Format zwrotu
Współrzędne geograficzne

Dane możesz podać jako zbiór danych dotyczących jednej lokalizacji lub wielu lokalizacji na ścieżce. Możesz też podać zakodowane współrzędne. Możesz podać maksymalnie 512 współrzędnych.

Interfejs Elevation API udostępnia wzniesienie w metrach względem lokalnego średniego poziomu morza (LMSL). Wysokość może być zwracana jako wartość dodatnia lub ujemna, zgodnie z poniższym opisem:

  • Wartości dodatnie wskazują lokalizacje powyżej LMSL, w tym lokalizacje na dnie lub u dołu jezior.
  • Wartości ujemne wskazują lokalizacje, które nie należą do systemu zarządzania uczeniem, w tym lokalizacje na powierzchni lub podłodze oceanu.
  • Rozdzielczość wskazuje odległość między punktami danych a wysokością w metrach.
  • JSON
  • XML

Jak korzystać z interfejsu Elevation API

1 Konfiguracja Zacznij od Skonfiguruj projekt Google Cloud i postępuj zgodnie z instrukcjami konfiguracji, które znajdziesz poniżej.
2 Wypróbuj prośbę o podniesienie Gdy masz już klucz interfejsu API, możesz zacząć testować interfejs Elevation API bezpośrednio w przeglądarce. Aby dowiedzieć się więcej, zobacz Przykładowe żądania w przewodniku Pierwsze kroki.
3 Tworzenie bardziej złożonej prośby Po skonfigurowaniu projektu spróbuj wysłać żądanie, które dostarcza dane o lokalizacji wzdłuż ścieżki. Więcej informacji znajdziesz w artykule Określanie ścieżek .
4 Podstawowe informacje o odpowiedziach Przejrzyj odpowiedzi na pytania o wysokość, by przygotować dane o wysokości, jakie może wykonać Twoja aplikacja. Więcej informacji znajdziesz w artykule Odpowiedzi na pytania o wysokość.
5 Korzystaj z danych o wysokości w swojej aplikacji. Danych o wysokości możesz używać do ulepszania aplikacji związanych z lokalizacją, takich jak aplikacje sportowe lub dane ankietowe.

Dostępne biblioteki klienta

Wywołaj ten interfejs API w wybranym przez siebie języku za pomocą jednej z tych bibliotek klienta:

Klient Java, Python, Go Client i Node.js dla Map Google to obsługiwane przez społeczność biblioteki klienta na licencji open source na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz również instrukcje instalacji i przykładowy kod.

Co dalej?