Omówienie interfejsu Distance Matrix API (starsza wersja)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wprowadzenie

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

Dlaczego warto korzystać z Distance Matrix API (Legacy)

Distance Matrix API (Legacy) może pomóc w określeniu najbardziej efektywnych tras podróży między wieloma możliwymi punktami 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ą Distance Matrix API (Legacy)

Za pomocą Distance Matrix API (Legacy) możesz podać odległość i czas podróży dla macierzy punktów początkowych i 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.

Distance Matrix API (Legacy) podaje informacje na podstawie zalecanej trasy między punktem początkowym a 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 ruchu

mapa pokazująca punkty początkowe i docelowe na mapie i w odpowiedzi interfejsu API;

Jak działa Distance Matrix API (Legacy)

Distance Matrix API (Legacy) używa dowolnej liczby punktów początkowych i docelowych oraz zwraca odległość i czas podróży między każdym punktem początkowym a wszystkimi żądanymi punktami docelowymi, zaczynając od pierwszego punktu początkowego w żądaniu i przechodząc krok po kroku do następnego.

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

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

Ten przykład przedstawia żądanie dotyczące 2 punktów początkowych: Waszyngtonu i Bostonu, z 1 punktem docelowym, Nowym Jorkiem, 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 za pomocą Distance Matrix API (Legacy) oraz zwracanych przez nie danych.

Zasoby danych Zwracane dane Format zwracanych danych
Macierz odległości

Podaj punkty 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 punktem początkowym a każdym punktem docelowym
  • Czas trwania w ruchu, jeśli określono tryb Prowadzenie samochodu i godzinę wyjazdu
  • JSON
  • XML

Jak korzystać z Distance Matrix API (Legacy)

1 Konfiguracja Zacznij od skonfigurowania projektu Google Cloud i wykonaj kolejne instrukcje konfiguracji.
2 Wypróbuj żądanie macierzy odległości Gdy masz już klucz interfejsu API, możesz zacząć testować Distance Matrix API (Legacy) bezpośrednio w przeglądarce. Przykłady znajdziesz w sekcji Przykładowe żądania w przewodniku Pierwsze kroki.
3 Utwórz bardziej złożone żądanie Wypróbuj żądanie, które zawiera wiele punktów początkowych i docelowych. Dowiedz się o parametrach opcjonalnych, które ograniczają obliczenia, np. o określonej godzinie wyjazdu lub ograniczeniach trasy. Więcej informacji znajdziesz w sekcji Parametry opcjonalne w przewodniku Żądanie i odpowiedź macierzy odległości (Legacy).
4 Podstawowe informacje o odpowiedziach Zapoznaj się z odpowiedziami na dane, aby przygotować się do używania danych macierzy odległości w aplikacji. Więcej informacji znajdziesz w sekcji Odpowiedzi macierzy odległości.
5 Włącz dane macierzy odległości do swojej aplikacji. Możesz użyć tych danych do obliczenia odległości i czasu podróży.

Dostępne biblioteki klienta

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

Java Client, Python Client, Go Client i Node.js Client for Mapy Google Services to biblioteki klienta 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?