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 dojazdu różnymi środkami transportu, w tym transportem publicznym, samochodem, pieszo lub rowerem;
  • Wskazówki dojazdu w kilku częściach z użyciem serii punktów pośrednich.
  • Punkty początkowe, docelowe i przelotne 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 Directions API

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

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

Ten przykładowy kod 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 za pomocą interfejsu Directions API wraz z zwracanymi przez niego danymi.

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 sekcji Odpowiedzi na pytania o kierunek.
  • JSON
  • XML

Jak korzystać z interfejsu Directions API

1 Skonfiguruj konto. Zacznij od skonfigurowania projektu Google Cloud i wykonaj podane niżej instrukcje konfiguracji.
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 żądania 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 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 pytania o trasy.
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 Map Google są bibliotekami klienta obsługiwanymi przez społeczność, które są dostępne jako oprogramowanie open source na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.

Co dalej?