Omówienie interfejsu Directions API (starsza wersja)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Interfejs Directions API (starszy) 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

Za pomocą interfejsu Directions API możesz uzyskiwać wskazówki dojazdu różnymi środkami transportu, np. transportem publicznym, samochodem, pieszo lub rowerem.

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

Interfejs Directions API umożliwia obliczanie tras między lokalizacjami, w tym:

  • Wskazówki dojazdu różnymi środkami transportu, w tym transportem publicznym, samochodem, pieszo lub rowerem.
  • Wskazówki dojazdu składające się z kilku części, w których wykorzystuje się serię punktów pośrednich.
  • Określaj punkty początkowe, docelowe i pośrednie na wiele sposobów, 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 wydajne trasy podczas obliczania wskazówek dojazdu. Podczas wyznaczania najbardziej efektywnej trasy usługa uwzględnia te elementy podróży:

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

Poniższy przykładowy request zwraca wskazówki dojazdu z Toronto w Ontario do Montrealu w Quebecu w formacie JSON:

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

Zasoby

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

Zasoby danych Zwrócone dane Format zwrotu
Trasa

Podaj miejsca początkowe i docelowe w postaci identyfikatorów miejsc, adresów lub współrzędnych geograficznych. Więcej informacji znajdziesz w sekcji Parametry wymagane.

Szczegółowe wskazówki podzielone na trasy, etapy i kroki. Więcej informacji znajdziesz w sekcji Odpowiedzi dotyczące wskazówek dojazdu.
  • JSON
  • XML

Jak korzystać z interfejsu Directions API

1 Skonfiguruj konto. Zacznij od sekcji Konfigurowanie projektu Google Cloud i wykonaj podane tam instrukcje.
2 Wypróbuj wersję demonstracyjną Gdy uzyskasz klucz interfejsu API i projekt w chmurze, możesz bezpłatnie wypróbować wersję demonstracyjną wskazówek dojazdu. Zobacz wersję demonstracyjną interfejsu Directions API.
3 Tworzenie żądania Zobacz przykładowe żądania i dowiedz się więcej o dostępnych opcjach, które możesz podać, takich jak środki transportu, punkty pośrednie i ograniczenia trasy. Zobacz przykłady dotyczące wskazówek.
4 Podstawowe informacje o odpowiedziach Zapoznaj się z odpowiedziami dotyczącymi danych, aby przygotować się do używania danych o kierunkach w aplikacji. Więcej informacji znajdziesz w artykule Odpowiedzi dotyczące kierunków.
5 Wprowadź dane o kierunku do własnej aplikacji! Na podstawie tych danych możesz obliczyć odległość i czas podróży.

Dostępne biblioteki klienta

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

Klient Java, klient Python, klient Go i klient Node.js dla usług Map Google to biblioteki klientów obsługiwane przez społeczność, udostępniane na licencji Apache 2.0. Możesz je pobrać z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.

Co dalej?