Omówienie interfejsu Distance Matrix API

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

Dlaczego warto korzystać z interfejsu Distance Matrix API

Możesz użyć interfejsu Distance Matrix API, aby pomóc w określaniu najefektywniejszych tras podróży między wieloma możliwymi miejscami wylotu i docelowym. Mogą to być na przykład informacje o tym, które pracownicy mają wysyłać do miejsc pracy lub z których magazynów mają wysyłać paczki.

Do czego służy interfejs Distance Matrix API

Za pomocą interfejsu Distance Matrix API możesz podać odległość i czas podróży dla macierzy punktów początkowych i docelowych. Możesz podać kilka opcji, w tym środek transportu, np. samochód, rower, transport publiczny lub pieszo, oraz ś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 punktem początkowym a końcowym. Możesz prosić o takie dane o odległości:

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

mapa pokazująca miejsca wylotu i miejsca docelowe na mapie oraz w odpowiedzi interfejsu API

Jak działa interfejs Distance Matrix API

Interfejs Distance Matrix API używa dowolnej liczby punktów początkowych i docelowych. Zwraca odległość i czas podróży między źródłem a wszystkimi żądanymi miejscami docelowymi, zaczynając od pierwszego punktu początkowego w żądaniu i przechodząc do kolejnego.

Jeśli na przykład w żądaniu określono A i B jako miejsca wylotu, a C i D jako miejsca docelowe, zwraca odległości i czas podróży w tej kolejności:

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

Poniższy przykład pokazuje żądanie dotyczące 2 źródeł: Waszyngton, D.C. i Boston z 1 miejscem docelowym 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

W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych w ramach interfejsu Distance Matrix API oraz zwracane przez nie dane.

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

Podaj miejsca wylotu i miejsca 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 miejscem wylotu a każdym miejscem docelowym;
  • Czas trwania w natężeniu ruchu po określeniu trybu samochodowego i czasu wyjazdu
  • JSON
  • XML

Jak korzystać z interfejsu Distance Matrix API

1 Przygotuj się Zacznij od skonfigurowania projektu Google Cloud i wykonaj podane niżej instrukcje konfiguracji.
2 Wypróbuj żądanie macierzy odległości Gdy masz już 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 Pierwsze kroki.
3 Tworzenie bardziej złożonego żądania Spróbuj wysłać prośbę obejmującą wiele miejsc początkowych i miejsc docelowych. Dowiedz się więcej o opcjonalnych parametrach ograniczających obliczenia, takich jak określony czas odjazdu czy ograniczenia trasy. Zapoznaj się z parametrami opcjonalnymi w przewodniku po żądaniach i odpowiedziach dotyczących macierzy odległości.
4 Podstawowe informacje o odpowiedziach Przeanalizuj odpowiedzi danych, aby przygotować się do użycia danych macierzy odległości w swojej aplikacji. Więcej informacji znajdziesz w odpowiedziach macierzy odległości.
5 Umieść dane macierzy odległości we własnej aplikacji. Możesz użyć tych danych do obliczenia czasu podróży i odległości do celu.

Dostępne biblioteki klienta

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

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

Co dalej?