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 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:

  • 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, 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 wskazówek. Podczas wyznaczania najskuteczniejszej trasy usługa uwzględnia te elementy podróży:

  • 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 zwracanej wartości
Trasa

Podaj miejsca wylotu i przylotu w postaci 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, podzielone na trasy, etapy 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 wersję demonstracyjną Gdy masz już klucz interfejsu API i projekt w chmurze, możesz bezpłatnie wypróbować demonstrację wskazówek. Zobacz prezentację Directions API.
3 Utwórz prośbę 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ładowe wskazówki dojazdu.
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 dane o trasach.
5 Umieść dane o kierunkach w swojej 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, 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?