Omówienie interfejsu Distance Matrix API

Interfejs Distance Matrix API to usługa, która akceptuje żądanie HTTPS dotyczące informacji o miejscach początkowych i miejscach docelowych w przypadku danego środka transportu. W przypadku każdej kombinacji miejsca wylotu 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 pomóc w określeniu najefektywniejszych tras podróży między wieloma możliwymi miejscami docelowymi i miejscami docelowymi. Na przykład określa, które pracownicy wysyłają do miejsc pracy lub z których magazynów wysyłają 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 miejsc początkowych i docelowych. Możesz określić 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 pociąg.

Interfejs Distance Matrix API dostarcza informacje na podstawie zalecanej trasy między punktem początkowym a końcowym. Możesz prosić o tego rodzaju dane o odległości:

  • Odległość dla wybranego środka transportu
  • Dystans w kilometrach lub milach
  • Szacowany czas podróży przy obecnym natężeniu ruchu

mapa pokazująca miejsce 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 miejsc docelowych. Zwraca odległość i czas podróży między miejscem wylotu a wszystkich żą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 punkt początkowy, a miejsca docelowe C i D, funkcja zwraca 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 przedstawia żądanie dotyczące 2 miejsc wylotu: Waszyngton, D.C i Boston z jednym celem podróży 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 początkowe 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 natężenia ruchu po określeniu trybu samochodowego i godziny wyjazdu
  • JSON
  • XML

Jak korzystać z interfejsu Distance Matrix API

1 Przygotuj się Zacznij od konfiguracji projektu Google Cloud i wykonaj podane niżej instrukcje konfiguracji.
2 Wypróbuj żądanie macierzy odległości Gdy masz 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ć żądanie, które dostarcza wiele miejsc wylotu i przylotu. Dowiedz się więcej o opcjonalnych parametrach, które ograniczają obliczenia, takich jak określony czas odjazdu czy ograniczenia trasy. Zapoznaj się z parametrami opcjonalnymi w przewodniku żądania i odpowiedzi macierzy odległości.
4 Podstawowe informacje o odpowiedziach Przejrzyj odpowiedzi danych, aby przygotować się do korzystania z danych macierzy odległości w aplikacji. Więcej informacji znajdziesz w sekcji Odpowiedzi macierzy odległości.
5 Umieść dane macierzy odległości 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 za pomocą jednej z tych bibliotek klienta:

Klienty 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