Omówienie interfejsu Directions API (starsza wersja)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Directions API (starsza wersja) to usługa, która akceptuje żądanie HTTP i zwraca wskazówki dojazdu między lokalizacjami w formacie JSON lub XML.

Dlaczego warto używać interfejsu Directions API (starsza wersja)

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

Co możesz zrobić 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 te szczegóły:

  • 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 i wykorzystujące serię punktów orientacyjnych.
  • Określaj punkty początkowe, miejsca docelowe i punkty pośrednie na różne sposoby, m.in. jako ciągi tekstowe (np. „Chicago, IL” lub „Darwin, NT, Australia”), identyfikatory miejsc lub współrzędne szerokości i długości geograficznej.

Jak działa interfejs Directions API (starsza wersja)

Interfejs Directions API (starsza wersja) zwraca najbardziej efektywne trasy podczas obliczania wskazówek dojazdu. Podczas wyznaczania najbardziej efektywnej trasy usługa uwzględnia te elementy podróży:

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

Przykładowe żądanie poniżej 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) oraz zwracanych przez niego danych.

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 Wymagane parametry.

Szczegółowe wskazówki dojazdu podzielone na trasy, odcinki i kroki. Szczegółowe informacje 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 masz już klucz interfejsu API i projekt w chmurze, możesz bezpłatnie wypróbować wersję demonstracyjną wskazówek dojazdu. Zobacz wersję demonstracyjną interfejsu Directions API (starsza wersja).
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 wskazówek dojazdu.
4 Podstawowe informacje o odpowiedziach Przeanalizuj odpowiedzi z danymi, aby przygotować się do korzystania z danych o trasach w aplikacji. Szczegółowe informacje znajdziesz w artykule Odpowiedzi dotyczące tras.
5 Dodaj dane o trasie do własnej aplikacji. 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, korzystając z jednej z tych bibliotek klienta:

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

Co dalej?