Omówienie interfejsu Distance Matrix API

Interfejs DISTANCE Matrix API to usługa, która akceptuje żądania HTTPS zawierające źródła i miejsca docelowe 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 Range Matrix API

Możesz użyć interfejsu Odległość Matrix API, aby wyznaczyć najefektywniejsze trasy podróży między wieloma możliwymi punktami początkowymi i miejscami docelowymi. Mogą to być na przykład informacje o tym, którzy pracownicy wysyłają paczki do miejsc pracy lub z których magazynów mają to zrobić.

Do czego służy interfejs Range Matrix API

Za pomocą interfejsu Odległość Matrix API możesz podać odległość i czas podróży w przypadku macierzy punktów początkowych i celów podróży. Możesz określić kilka opcji, w tym środek transportu, np. do samochodu, rower, transport publiczny czy pieszo, oraz środki transportu publicznego, takie jak autobus, metro, pociąg, tramwaj czy kolej.

Interfejs Odległość Matrix API dostarcza informacji na podstawie zalecanej trasy między punktem początkowym a końcowym. Możesz prosić o dostęp do następujących danych o odległości:

  • Odległość w przypadku wybranego środka transportu
  • Dystans w kilometrach lub milach
  • Szacowany czas podróży przy korku

mapa pokazująca miejsca wylotu i docelowe na mapie oraz w odpowiedzi interfejsu API

Jak działa interfejs Range Matrix API

Interfejs Odległość Matrix API używa dowolnej liczby punktów początkowych i miejsc docelowych. Zwraca odległość i czas podróży między miejscem początkowym a wszystkimi żądanymi miejscami docelowymi, zaczynając od pierwszego punktu początkowego w żądaniu i przechodząc krok do następnego.

Jeśli na przykład w żądaniu określono A i B jako punkt początkowy, a C i D jako miejsca docelowe, odległość i czas podróży zostaną podane w następującej kolejności:

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

Poniższy przykład przedstawia żądanie dotyczące 2 miejsc pochodzenia: 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 w ramach interfejsu Range Matrix API oraz zwracanych przez nie danych.

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

Podaj miejsca wylotu i przylotów 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 w korkach, jeśli określisz tryb samochodowy i godzinę wyjazdu
  • JSON
  • XML

Jak korzystać z interfejsu Range Matrix API

1 Skonfiguruj konto. Zacznij od konfigurowania projektu Google Cloud i postępuj zgodnie z poniższymi instrukcjami.
2 Wypróbuj żądanie macierzy odległości Gdy będziesz już mieć klucz interfejsu API, możesz zacząć testować interfejs Range 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 informacje o wielu miejscach odjazdów i miejsc docelowych. Dowiedz się więcej o opcjonalnych parametrach ograniczających obliczenia, takich jak określony czas odjazdu czy ograniczenia trasy. Więcej informacji znajdziesz w sekcji Parametry opcjonalne w przewodniku Żądanie i odpowiedź tablicy odległości.
4 Podstawowe informacje na temat odpowiedzi Przejrzyj odpowiedzi danych, aby przygotować się do korzystania w aplikacji z danych macierzy odległości. 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 na potrzeby usług Map Google to obsługiwane przez społeczność biblioteki klienckie udostępniane na licencji open source licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.

Co dalej?