Omówienie interfejsu Elevation API

Elevation API to usługa, która zwraca dane o wysokości dla określonego miejsca na Ziemi lub próbkowane dane o wysokości wzdłuż ścieżek.

Dlaczego warto korzystać z interfejsu Elevation API

Za pomocą interfejsu Elevation API możesz tworzyć aplikacje ułatwiające klientom wykonywanie czynności wymagających uwagi związanych z wysokością, aplikacji do pozycjonowania lub niskobudżetowych pomiarów obejmujących wysokość i zmiany wysokości wzdłuż tras. Możesz na przykład podać dane o wzniesieniu i utracie wysokości, aby ulepszyć aplikację sportową do takich aktywności jak piesze wędrówki, jazda na rowerze czy nurkowanie.

Do czego służy interfejs Elevation API

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

  • Wyznacz wysokość danego miejsca.
  • Oblicz różnice wysokości na trasie lub między 2 punktami.

Jak działa interfejs Elevation API

Interfejs Elevation API akceptuje żądanie w postaci zakodowanego adresu URL ze współrzędnymi szerokości i długości geograficznej, zarówno w postaci dyskretnych lokalizacji, jak i jako serii lokalizacji na ścieżce. To żądanie, na przykład, wysyła zapytanie o wysokości w centrum 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 określa wysokość dla podanych współrzędnych. Interpoluje również wysokość w przypadku lokalizacji bez wysokości, dostarczając średnią z 4 najbliższych lokalizacji, które udostępniają dane o wysokości. Wreszcie określa ono ogólną rozdzielczość danej lokalizacji.

Zasoby

Tabela poniżej zawiera podsumowanie zasobów dostępnych za pomocą interfejsu Elevation API oraz zwracanych przez nią danych.

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

Dane możesz podać w postaci zbioru lokalizacji lub wielu lokalizacji albo w postaci serii na ścieżce. Możesz też podać zakodowane współrzędne. Przekazuj do 512 współrzędnych.

Interfejs Elevation API podaje wysokość w metrach w stosunku do średniego poziomu morza (LMSL). Wysokość może być zwrócona jako wartość dodatnia lub ujemna, jak w tym przykładzie:

  • Wartości dodatnie wskazują lokalizacje nad systemem zarządzania uczeniem, w tym lokalizacje na powierzchni lub dno jezior wysokogórskich.
  • Wartości ujemne wskazują lokalizacje poniżej Systemu zarządzania uczeniem, w tym lokalizacje na powierzchni i dniu oceanu.
  • Rozdzielczość wskazuje odległość między punktem danych a wysokością w metrach.
  • JSON
  • XML

Jak korzystać z interfejsu Elevation API

1 Przygotuj się Zacznij od konfiguracji projektu Google Cloud i wykonaj podane niżej instrukcje konfiguracji.
2 Poproś o podniesienie uprawnień Po uzyskaniu klucza interfejsu API możesz zacząć testować interfejs Elevation API bezpośrednio w przeglądarce. Więcej informacji znajdziesz w sekcji Przykładowe żądania w przewodniku Pierwsze kroki.
3 Tworzenie bardziej złożonego żądania Po skonfigurowaniu projektu spróbuj wysłać żądanie, które dostarcza dane o lokalizacji na ścieżce. Więcej informacji znajdziesz w sekcji Określanie ścieżek .
4 Podstawowe informacje o odpowiedziach Zapoznaj się z odpowiedziami na dane o wysokości, aby przygotować się do użycia w aplikacji danych o wysokości. Szczegóły znajdziesz w artykule Reakcje dotyczące wysokości względnej.
5 Umieść dane o wysokości w swojej aplikacji. Danych o wysokości możesz używać do ulepszania aplikacji związanych z lokalizacją (np. do uprawiania sportu) lub do zbierania danych ankietowych.

Dostępne biblioteki klienta

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

Klienty Java, Python, Go i Node.js dla usług Map Google to obsługiwane przez społeczność biblioteki klienckie udostępniane na licencji open source na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.

Co dalej