Omówienie interfejsu Directions API (starsza wersja)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

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

Dzięki Directions API (Legacy) możesz uzyskiwać wskazówki dojazdu różnymi środkami transportu, np. transportem publicznym, samochodem, pieszo lub rowerem.

Co możesz robić za pomocą Directions API (Legacy)?

Za pomocą Directions API (Legacy) możesz obliczać trasy między lokalizacjami, w tym:

  • wskazówki dojazdu różnymi środkami transportu, np. transportem publicznym, samochodem, pieszo lub rowerem;
  • wskazówki dojazdu z wieloma punktami pośrednimi;
  • określanie punktów początkowych, miejsc docelowych i punktów pośrednich na różne sposoby, np. jako ciągi tekstowe (np. „Chicago, IL” lub „Darwin, NT, Australia”), identyfikatory miejsc lub współrzędne geograficzne.

Jak działa Directions API (Legacy)

Podczas obliczania trasy Directions API (Legacy) zwraca najbardziej efektywne trasy. Podczas określania najbardziej efektywnej trasy usługa uwzględnia te elementy podróży:

  • czas podróży (podstawowy);
  • odległość;
  • liczba zwojów.

Ten przykładowy request zwraca wskazówki dojazdu samochodem 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 Directions API (Legacy) oraz zwracanych przez nie danych.

Zasoby danych Zwracane dane Format zwracanych danych
Trasa

Podaj punkty początkowe i miejsca docelowe w postaci identyfikatorów miejsc, adresów, lub współrzędnych geograficznych. Szczegółowe informacje znajdziesz w sekcji Wymagane parametry.

Szczegółowe wskazówki dojazdu podzielone na trasy, odcinki i kroki. Szczegółowe informacje znajdziesz w sekcji Odpowiedzi Directions.
  • JSON
  • XML

Jak korzystać z Directions API (Legacy)

1 Konfiguracja Zacznij od skonfigurowania projektu Google Cloud i wykonaj kolejne instrukcje konfiguracji.
2 Wypróbuj wersję demonstracyjną Gdy masz klucz interfejsu API i projekt w chmurze, możesz bezpłatnie wypróbować wersję demonstracyjną wskazówek dojazdu. Zobacz wersję demonstracyjną Directions API (Legacy).
3 Utwórz żądanie Zapoznaj się z przykładowymi żądaniami i dostępnymi opcjami, takimi jak środki transportu, punkty pośrednie i ograniczenia trasy. Zobacz przykłady Directions.
4 Podstawowe informacje o odpowiedziach Zapoznaj się z odpowiedziami na żądania danych, aby przygotować się do korzystania z danych o trasach w aplikacji. Szczegółowe informacje znajdziesz w sekcji Odpowiedzi Directions.
5 Zintegruj dane o trasach z własną aplikacją Możesz użyć tych danych do obliczenia odległości i czasu podróży.

Dostępne biblioteki klienta

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

Java Client, Python Client, Go Client i Node.js Client for Google Maps Services to biblioteki klienta obsługiwane przez społeczność, udostępnione na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.

Co dalej?