Omówienie interfejsu Distance Matrix API

Interfejs Distance Matrix API to usługa, która akceptuje żądanie HTTPS zawierające punkty początkowe i docelowe dla danego środka transportu. W przypadku każdej kombinacji miejsca początkowego i miejsca docelowego zwraca odległość i czas podróży.

Dlaczego warto korzystać z interfejsu Distance Matrix API

Możesz użyć interfejsu Distance Matrix API, aby określić najbardziej efektywne trasy podróży między wieloma możliwymi punktami początkowymi i docelowymi. Na przykład, których pracowników wysłać na strony z ofertami pracy lub z których magazynów wysłać paczki.

Co można robić za pomocą interfejsu Distance Matrix API

Dzięki interfejsowi Distance Matrix API możesz podać odległość i czas podróży dla macierzy miejsc wyjazdu i miejsc docelowych. Możesz określić kilka opcji, w tym: środek transportu (samochód, rower, transport publiczny lub pieszo) oraz rodzaj transportu publicznego (autobus, metro, pociąg, tramwaj lub kolej).

Interfejs Distance Matrix API udostępnia informacje na podstawie zalecanej trasy między punktem początkowym a końcowym. Możesz poprosić o te rodzaje danych o odległości:

  • Odległość dla wybranego środka transportu
  • Dystans w kilometrach lub milach
  • Szacowany czas podróży w korku

mapę pokazującą punkty początkowe i docelowe na mapie oraz w odpowiedzi interfejsu API;

Jak działa interfejs Distance Matrix API

Interfejs Distance Matrix API korzysta z dowolnej liczby miejsc początkowych (punktów początkowych) i miejsc docelowych, a także zwraca odległość i czas podróży między każdym miejscem początkowym a wszystkimi żądanymi miejscami docelowymi, zaczynając od pierwszego miejsca początkowego w żądaniu i przechodząc krok po kroku do kolejnych.

Jeśli na przykład w Twoim żądaniu jako punkty wyjścia są określone punkty A i B, a jako punkty docelowe – punkty C i D, zwracane są odległości i czas podróży w tej kolejności:

  • A do C
  • A–D
  • B do C
  • B do D

Ten przykład pokazuje żądanie dotyczące 2 miejsc odjazdu: Washington, DC i Boston, z jednym miejscem docelowym, Nowy Jork, NY, w formacie JSON:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=New%20York%20City%2C%20NY
  &origins=Washington%2C%20DC%7CBoston
  &units=imperial
  &key=YOUR_API_KEY

Zasoby

Tabela poniżej zawiera podsumowanie zasobów dostępnych za pomocą interfejsu Distance Matrix API wraz z zwracanymi przez niego danymi.

Zasoby danych Zwrócone dane Format zwracanej wartości
Macierz odległości

Podaj punkty początkowe i docelowe w postaci identyfikatorów miejsc, adresów lub współrzędnych szerokości i długości geograficznej.

  • odległość i czas podróży między każdym miejscem wylotu a miejscem docelowym;
  • Czas spędzony w korkach, jeśli wybrano tryb jazdy i czas wyjazdu.
  • JSON
  • XML

Jak korzystać z interfejsu Distance Matrix API

1 Konfigurowanie. Zacznij od sekcji Konfigurowanie projektu Google Cloud i wykonaj podane tam instrukcje.
2 Wypróbuj żądanie dotyczące macierzy odległości Gdy masz klucz interfejsu API, możesz zacząć testować interfejs Distance Matrix API bezpośrednio w przeglądarce. Przykłady przykładowych żądań znajdziesz w przewodniku dla początkujących.
3 Tworzenie bardziej złożonego zgłoszenia Wypróbuj żądanie, które zawiera wiele miejsc początkowych i miejsc docelowych. Dowiedz się więcej o opcjonalnych parametrach, które umożliwiają ograniczenie zakresu obliczeń, np. określony czas wyjazdu lub ograniczenia dotyczące trasy. Informacje o parametrach opcjonalnych znajdziesz w przewodniku Zgłoszenie i odpowiedź Distance Matrix.
4 Podstawy udzielania odpowiedzi Przejrzyj odpowiedzi, aby przygotować się do korzystania z danych z tabeli odległości w swojej aplikacji. Więcej informacji znajdziesz w artykule Odpowiedzi dotyczące tabeli odległości.
5 Włącz dane z matrycy odległości do swojej aplikacji. Na podstawie tych danych możesz obliczyć odległość i czas podróży.

Dostępne biblioteki klienta

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

Biblioteki klienta Java, Python, Go i Node.js do obsługi Usług Google Maps są obsługiwane przez społeczność i udostępniane na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.

Co dalej?