Omówienie interfejsu Distance Matrix API

Interfejs DISTANCE Matrix API to usługa, która akceptuje żądania HTTPS zawierające informacje o miejscach początkowych i docelowych 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

Za pomocą interfejsu DISTANCE Matrix API możesz określić najbardziej efektywne trasy podróży między różnymi możliwymi punktami początkowymi i miejscami 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

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. samochodem, rowerem, transportem publicznym lub pieszo, a także środki transportu, takie jak autobus, metro, pociąg, tramwaj lub kolej.

Interfejs DISTANCE Matrix API dostarcza informacji 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. 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 żą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

Ten przykład przedstawia żądanie dwóch punktów początkowych: Waszyngton, D.C. i Boston z jednym miejscem docelowym, Nowy Jork (Nowy Jork), 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 przez interfejs DISTANCE Matrix API oraz danych, 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 szerokości i długości geograficznej.

  • Odległość i czas podróży między miejscem wylotu a miejscem docelowym
  • Czas trwania w korku, jeśli masz określony tryb samochodowy i godzinę odjazdu
  • JSON
  • XML

Jak korzystać z interfejsu Reach 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 Po uzyskaniu klucza 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 parametrach opcjonalnych, które ograniczają obliczenia, takich jak określony czas odjazdu lub ograniczenia trasy. Patrz parametry opcjonalne w przewodniku na temat żądań i odpowiedzi macierzy odległości.
4 Podstawowe informacje o odpowiedziach 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 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 wybranym języku, używając jednej z tych bibliotek klienta:

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

Co dalej