Omówienie interfejsu Distance Matrix API

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wprowadzenie

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

Dlaczego warto korzystać z interfejsu Distance Matrix API

Interfejsu Distance Matrix API możesz używać do określania najbardziej efektywnych tras podróży między wieloma możliwymi miejscami początkowymi i docelowymi. Na przykład, których pracowników wysłać do miejsc pracy lub z których magazynów wysłać paczki.

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

Interfejs Distance Matrix API umożliwia podawanie odległości i czasu podróży dla macierzy miejsc wyjazdu i miejsc docelowych. Możesz określić kilka opcji, w tym środek transportu, np. samochód, rower, transport publiczny lub pieszo, a także środki transportu publicznego, takie jak autobus, metro, pociąg, tramwaj lub kolej.

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

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

mapa pokazująca 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 i docelowych oraz 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 następnego.

Jeśli na przykład w żądaniu podasz A i B jako punkty początkowe oraz C i D jako punkty docelowe, zwrócone zostaną odległości i czas podróży w tej kolejności:

  • A do C
  • A do D
  • B2C
  • B do D

Ten przykład pokazuje żądanie dotyczące 2 miejsc odjazdu: Waszyngtonu i Bostonu, oraz 1 miejsca docelowego: Nowego Jorku, 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 w interfejsie Distance Matrix API wraz z danymi, które zwraca.

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

Podaj miejsca początkowe i docelowe w postaci identyfikatorów miejsc, adresów lub współrzędnych geograficznych.

  • odległość i czas podróży między każdym miejscem początkowym a każdym miejscem docelowym;
  • Czas trwania podróży w ruchu, jeśli podasz tryb jazdy i godzinę wyjazdu
  • JSON
  • XML

Jak korzystać z interfejsu Distance Matrix API

1 Konfiguracja Zacznij od sekcji Konfigurowanie projektu Google Cloud i wykonaj podane tam instrukcje.
2 Wypróbuj żądanie macierzy odległości Gdy uzyskasz klucz interfejsu API, możesz zacząć testować interfejs Distance Matrix API bezpośrednio w przeglądarce. Przykłady znajdziesz w sekcji Przykładowe żądania w przewodniku Dla początkujących.
3 Tworzenie bardziej złożonych próśb Wypróbuj prośbę, która zawiera wiele miejsc początkowych i docelowych. Dowiedz się więcej o parametrach opcjonalnych, które ograniczają obliczenia, np. o określonej godzinie odjazdu lub ograniczeniach trasy. Więcej informacji znajdziesz w sekcji Parametry opcjonalne w przewodniku Żądanie i odpowiedź interfejsu Distance Matrix API.
4 Podstawowe informacje o odpowiedziach Zapoznaj się z odpowiedziami dotyczącymi danych, aby przygotować się do używania danych macierzy odległości w aplikacji. Szczegółowe informacje znajdziesz w artykule Odpowiedzi macierzy odległości.
5 Wprowadź dane z matrycy odległości 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?