Omówienie Directions API

Interfejs Directions API to usługa, która przyjmuje żądanie HTTP i zwraca wskazówki dojazdu między lokalizacjami w formacie JSON lub XML.

Dlaczego warto korzystać z interfejsu Directions API

Dzięki interfejsowi Directions API możesz wyznaczać trasy różnymi środkami transportu, np. transportem publicznym, samochodem, pieszo lub rowerem.

Co można robić za pomocą interfejsu Directions API?

Dzięki interfejsowi Directions API możesz obliczać trasy między lokalizacjami, uwzględniając te szczegóły:

  • wskazówki dotyczące różnych środków transportu, w tym transportu publicznego, jazdy samochodem, chodzenia lub jazdy na rowerze;
  • Wskazówki dojazdu w kilku częściach z użyciem serii punktów pośrednich.
  • Początki, cele i punkty pośrednie można określać na różne sposoby, m.in. jako ciągi tekstowe (np. „Chicago, IL” lub „Darwin, NT, Australia”), identyfikatory miejsc lub współrzędne geograficzne.

Jak działa interfejs Directions API

Interfejs Directions API zwraca najbardziej efektywne trasy podczas obliczania kierunków. Podczas określania najskuteczniejszej trasy usługa uwzględnia te elementy podróży:

  • Czas podróży (główny)
  • Odległość
  • Liczba zwojów

Ten przykładowy żądanie zwraca w formacie JSON wskazówki dojazdu z Toronto w prowincji Ontario do Montrealu w prowincji Quebec:

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

Zasoby

Tabela poniżej zawiera podsumowanie zasobów dostępnych w interfejsie Directions API wraz z danymi, które zwraca.

Zasoby danych Zwrócone dane Format zwracanej wartości
Trasa

Podaj punkty początkowe i docelowe w postaci identyfikatorów miejsc, adresów lub współrzędnych szerokości i długości geograficznej. Więcej informacji znajdziesz w sekcji Parametry wymagane.

szczegółowe wskazówki podzielone na trasy, etapy i kroki; Więcej informacji znajdziesz w artykule Odpowiedzi na pytania dotyczące trasy.
  • JSON
  • XML

Jak korzystać z interfejsu Directions API

1 Konfigurowanie. Zacznij od sekcji Konfigurowanie projektu Google Cloud i wykonaj podane tam instrukcje.
2 Wypróbuj wersję demonstracyjną Gdy masz klucz interfejsu API i projekt w chmurze, możesz bezpłatnie wypróbować demonstrację wskazówek. Zobacz prezentację Directions API.
3 Tworzenie prośby Zobacz przykładowe żądania i dowiedz się więcej o dostępnych opcjach, które możesz podać, takich jak tryby podróży, punkty pośrednie i ograniczenia trasy. Zobacz przykłady tras.
4 Podstawy udzielania odpowiedzi Zapoznaj się z odpowiedziami na dane, aby przygotować się do używania danych o trasach w aplikacji. Więcej informacji znajdziesz w artykule Odpowiedzi na dane o trasach.
5 Wprowadź dane o kierunkach do swojej aplikacji. Na podstawie tych danych możesz obliczyć odległość i czas podróży.

Dostępne biblioteki klienta

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

Biblioteki klienta Java, Python, Go i Node.js do obsługi Usług Google Maps są obsługiwane przez społeczność i udostępniane na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.

Co dalej?