
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:
|
|
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 dla usług Map Google
- Klient Pythona dla usług Map Google
- Klient Go
- Klient Node.js dla usług Map Google
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?
- Zacznij korzystać z interfejsu Elevation API: przeczytaj artykuł Konfigurowanie projektu Google Cloud.
- Spróbuj pobrać dane o wysokości ścieżki oparte na ścieżkach: przejdź do sekcji Określanie ścieżek.
- Stosuj sprawdzone metody: zobacz Sprawdzone metody dotyczące usług internetowych.