Omówienie Directions API

Directions API to usługa, która przyjmuje żądania HTTP i zwraca trasy między lokalizacjami w formacie JSON lub XML.

Dlaczego warto korzystać z interfejsu Directions API

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

Co można zrobić przy użyciu interfejsu Directions API?

Za pomocą interfejsu Directions API możesz wyznaczyć trasę między lokalizacjami, uwzględniając m.in. te informacje:

  • Wskazówki dojazdu różnymi środkami transportu, w tym transportem publicznym, samochodem, pieszo lub rowerem.
  • Podziel wskazówki dojazdu za pomocą serii punktów na trasie.
  • Określ miejsca wylotu, przylotów i punktów pośrednich na wiele sposobów, w tym w postaci ciągów tekstowych (np. „Chicago, IL” lub „Darwin, NT, Australia”), identyfikatorów miejsc lub współrzędnych szerokości i długości geograficznej.

Jak działa interfejs Directions API

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

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

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

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 za pomocą interfejsu Directions API oraz zwróconych przez niego danych.

Zasoby danych Zwrócone dane Format zwracanych
Trasa

Podaj miejsca wylotu i przylotów w postaci identyfikatorów miejsc, adresów lub współrzędnych szerokości i długości geograficznej. Więcej informacji znajdziesz w sekcji Wymagane parametry.

Szczegółowe wskazówki dojazdu z podziałem na trasy, nogi i kroki. Więcej informacji znajdziesz w artykule Odpowiedzi na trasę.
  • JSON
  • XML

Jak korzystać z interfejsu Directions API

1 Skonfiguruj konto. Zacznij od konfigurowania projektu Google Cloud i postępuj zgodnie z poniższymi instrukcjami.
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ę interfejsu Directions API.
3 Tworzenie prośby Zobacz przykładowe żądania i poznaj dostępne opcje, takie jak środki transportu, punkty na trasie i ograniczenia trasy. Zobacz przykładowe trasy.
4 Podstawowe informacje na temat odpowiedzi Zapoznaj się z odpowiedziami na dane, aby przygotować się do korzystania z danych o trasach dojazdu w przypadku Twojej aplikacji. Więcej informacji znajdziesz w sekcji Odpowiedzi na wskazówki dojazdu.
5 Umieść wskazówki dojazdu w swojej 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:

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

Co dalej?