Omówienie interfejsu Distance Matrix API

Interfejs DISTANCE Matrix API to usługa, która akceptuje żądanie HTTPS zawierające miejsca wylotu i przylotu danego środka transportu. Dla każdej wartości kombinacji miejsca wylotu i celu podróży, zwraca odległość i czas trwania.

Dlaczego warto korzystać z interfejsu DISTANCE Matrix API

Interfejs DISTANCE Matrix API ułatwia określenie najkorzystniejszej tras podróży między różnymi możliwymi punktami początkowymi i docelowymi. Dla: na przykład, którzy pracownicy mają wysyłać do miejsc pracy albo z których magazynów należy przesyłek.

Co można zrobić przy użyciu interfejsu DISTANCE Matrix API

Za pomocą interfejsu DISTANCE Matrix API możesz podać czas podróży i odległość macierz punktów początkowych i docelowych. Możesz określić kilka opcji, w tym środki transportu, takie jak samochód, jazda na rowerze, transport publiczny lub piesze, a także środki transportu, takie jak autobusy, metro, pociągi, tramwaje lub pociągi.

Interfejs DISTANCE Matrix API dostarcza informacje na podstawie zalecanej trasy między punktem początkowym i końcowym. Możesz prosić o te rodzaje danych o odległości:

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

mapa pokazująca miejsce wylotu i przylotu na mapie i w odpowiedzi interfejsu API

Jak działa interfejs DISTANCE Matrix API

Interfejs DISTANCE Matrix API używa dowolnej liczby punktów początkowych (punktów początkowych) i miejsc docelowych oraz zwraca odległość i czas podróży między każdym z nich miejsce wylotu i wszystkie żądane miejsca docelowe, zaczynając od pierwszego miejsca wylotu w i przechodź do kolejnych kroków.

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

  • Od A do C
  • Od A do D
  • Od B do C
  • Od B do D

Poniżej znajduje się przykład żądania dotyczącego 2 źródeł: Waszyngton, D.C. i Boston z jednym miejscem docelowym, czyli Nowy Jork (Nowy Jork), Format 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 interfejsu DISTANCE Matrix API wraz z danymi, które zwraca.

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

Podaj miejsca wylotu i przylotu w formie identyfikatorów miejsc, adresów, lub współrzędnych geograficznych.

  • odległość i czas podróży między miejscem wylotu a każdym z nich; miejsce docelowe
  • Czas trwania w korku, jeśli określisz tryb samochodowy i godzina wyjazdu
  • JSON
  • XML

Jak korzystać z interfejsu Reach Matrix API

1 Rozpocznij konfigurację. Zacznij od skonfigurowania Projekt Google Cloud i dokończ konfigurację. z podanych instrukcji.
2 Spróbuj wysłać żądanie macierzy odległości Po uzyskaniu klucza interfejsu API możesz zacząć testować interfejs DISTANCE Matrix API bezpośrednio w przeglądarce. Zobacz przykładowe żądania. znajdziesz w artykule Pierwsze kroki.
3 Tworzenie bardziej złożonego żądania Spróbuj poprosić o wiele miejsc wylotu i miejsc docelowych. Ucz się o parametrach opcjonalnych ograniczających obliczenia, takich jak określony czasu odjazdu czy ograniczeń trasy. Zobacz Parametry opcjonalne w przewodniku Matrycy odległości – żądania i odpowiedzi.
4 Podstawowe informacje o odpowiedziach Przeanalizuj odpowiedzi danych, aby przygotować się do korzystania z danych macierzy odległości w swojej aplikacji. Zobacz Odpowiedzi macierzy odległości .
5 Włącz dane macierzy odległości do swojej aplikacji. Można ich używać do obliczania odległości i czasu podróży.

Dostępne biblioteki klienta

Wywołaj ten interfejs API w języku możesz wybrać za pomocą jednej z tych bibliotek klienta:

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

Co dalej?