Omówienie interfejsu Directions API (starsza wersja)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Interfejs Directions API (starsza wersja) 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 (starszego)

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

Co możesz robić za pomocą interfejsu Directions API (starsza wersja)?

Za pomocą interfejsu Directions API (starsza wersja) możesz obliczać wskazówki dojazdu 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 (starsza wersja)

Interfejs Directions API (starsza wersja) 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 (starsza wersja) 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 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 dotyczące wskazówek dojazdu.
  • JSON
  • XML

Jak korzystać z interfejsu Directions API (starsza wersja)

1 Konfiguracja Zacznij od skonfigurowania projektu Google Cloud i postępuj zgodnie z instrukcjami konfiguracji.
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 (starszego).
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 w aplikacji danych o wskazówkach dojazdu. Więcej informacji znajdziesz w artykule Odpowiedzi dotyczące wskazówek dojazdu.
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?