Omówienie Directions API

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

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.

Do czego można użyć interfejsu Directions API?

Dzięki interfejsowi Directions API możesz obliczać wskazówki dojazdu między lokalizacjami:

  • trasy dojazdu różnymi środkami transportu, w tym transportem publicznym, samochodem, pieszo lub rowerem.
  • Wieloczęściowe wskazówki dojazdu wykorzystujące szereg punktów pośrednich.
  • Punkty początkowe, miejsca docelowe i punkty pośrednie można określać na wiele sposobów, w tym jako ciągi tekstowe (np. „Chicago, IL” lub „Darwin, NT, Australia”), identyfikatory miejsc lub współrzędne długości i szerokości geograficznej.

Jak działa Directions API

Interfejs Directions API zwraca najbardziej efektywne trasy podczas obliczania wskazówek. Określając najkorzystniejszą trasę, uwzględniamy te elementy związane z podróżą:

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

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

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

Zasoby

Poniższa tabela zawiera podsumowanie zasobów dostępnych przez interfejs Directions API oraz zwracanych przez nie danych.

Zasoby danych Zwrócone dane Format zwrotu
Wskazówki dojazdu

Podaj miejsca wylotu i przylotu w formie identyfikatorów miejsc, adresów lub współrzędnych szerokości i długości geograficznej. Szczegółowe informacje znajdziesz w sekcji Wymagane parametry.

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

Jak korzystać z interfejsu Directions API

1 Rozpocznij konfigurację. Zacznij od skonfigurowania projektu Google Cloud i wykonaj podane niżej instrukcje konfiguracji.
2 Wypróbuj Gdy masz już klucz interfejsu API i projekt w chmurze, możesz bezpłatnie wypróbować demonstrację wskazówek. Zobacz prezentację interfejsu Directions API.
3 Utwórz prośbę Zobacz przykładowe żądania i poznaj dostępne opcje, takie jak środki transportu, punkty pośrednie i ograniczenia trasy. Zobacz przykłady wskazówek.
4 Podstawowe informacje o odpowiedziach Przejrzyj odpowiedzi dotyczące danych, aby przygotować się do korzystania z danych wskazówek dojazdu w aplikacji. Więcej informacji znajdziesz w odpowiedziach na wskazówki dojazdu.
5 Umieść dane o kierunkach w swojej aplikacji. Można ich używać do obliczania odległości i czasu podróży.

Dostępne biblioteki klienta

Wywołaj ten interfejs API w wybranym języku, używając jednej z tych bibliotek klienta:

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

Co dalej