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 docelowego zwraca odległość i czas podróży.

Dlaczego warto używać 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 punktami początkowymi i docelowymi. Możesz na przykład określić, które instancje robocze mają wysyłać do miejsc wykonywania zadań, a które magazyny mają wysyłać paczki.

Co można zrobić przy użyciu 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 podać kilka opcji, w tym środek transportu, np. samochodem, rowerem, transportem publicznym lub pieszo, a także środki transportu, 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 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

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 używa dowolnej liczby punktów początkowych (punktów początkowych) i miejsc docelowych. Zwraca odległość i czas podróży między każdym ź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 Twoje żądanie określa punkty A i B jako punkty wyjścia, a punkty C i D jako miejsca docelowe, zwracane są odległości i czas podróży w tej kolejności:

  • A do C
  • A–D
  • B to 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 zwrotu
Macierz odległości

Podaj miejsca wylotu i przylotu w formie 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 Rozpocznij konfigurację. Zacznij od skonfigurowania projektu Google Cloud i wykonaj podane niżej instrukcje konfiguracji.
2 Spróbuj wysłać żą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 poprosić o wiele miejsc wylotu i miejsc docelowych. Dowiedz się więcej o opcjonalnych parametrach, które ograniczają obliczenia, takich jak określony czas wyjazdu lub ograniczenia trasy. Informacje o parametrach opcjonalnych znajdziesz w przewodniku Zgłoszenie i odpowiedź Distance Matrix.
4 Podstawy odpowiedzi Przejrzyj odpowiedzi danych, aby przygotować się do użycia danych macierzy odległości w aplikacji. Więcej informacji znajdziesz w artykule o odpowiedziach macierzy 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 Map Google są bibliotekami klienta obsługiwanymi przez społeczność, które są dostępne jako oprogramowanie open source na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.

Co dalej?