Omówienie interfejsu Distance Matrix API (starsza wersja)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wprowadzenie

Distance Matrix API (starsza wersja) 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 używać interfejsu Distance Matrix API (starsza wersja)

Za pomocą interfejsu Distance Matrix API (starsza wersja) możesz określać najbardziej efektywne trasy podróży między wieloma możliwymi miejscami rozpoczęcia i zakończenia podróży. Na przykład, których pracowników wysłać do miejsc pracy lub z których magazynów wysłać paczki.

Co możesz zrobić za pomocą interfejsu Distance Matrix API (starsza wersja)

Dzięki interfejsowi Distance Matrix API (starsza wersja) możesz podawać odległość i czas podróży dla macierzy miejsc rozpoczęcia i zakończenia podróży. 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.

Interfejs Distance Matrix API (starsza wersja) dostarcza informacji na podstawie zalecanej trasy między punktem początkowym i 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 ulicznym,

mapa pokazująca miejsce początkowe i miejsca docelowe na mapie oraz w odpowiedzi interfejsu API.

Jak działa interfejs Distance Matrix API (starsza wersja)

Interfejs Distance Matrix API (starsza wersja) 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 miejsca początkowe, a C i D jako miejsca docelowe, odległości i czas podróży zostaną zwrócone w tej kolejności:

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

Poniższy przykład pokazuje żądanie dotyczące 2 miejsc początkowych: Waszyngtonu i Bostonu oraz jednego miejsca docelowego: Nowego Jorku 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 w interfejsie Distance Matrix API (starsza wersja) oraz zwracanych przez niego danych.

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

Podaj miejsca początkowe i docelowe 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 każdym miejscem wylotu a każdym celem podróży;
  • czas przejazdu w ruchu ulicznym, jeśli określono tryb Prowadzenie samochodu i czas wyjazdu;
  • JSON
  • XML

Jak korzystać z interfejsu Distance Matrix API (starsza wersja)

1 Konfiguracja Zacznij od skonfigurowania projektu Google Cloud i postępuj zgodnie z instrukcjami konfiguracji.
2 Wypróbuj żądanie macierzy odległości Gdy masz już klucz interfejsu API, możesz zacząć testować interfejs Distance Matrix API (starsza wersja) bezpośrednio w przeglądarce. Przykłady znajdziesz w sekcji Przykładowe żądania w przewodniku dla początkujących.
3 Tworzenie bardziej złożonej prośby Spróbuj wysłać żądanie, które zawiera wiele miejsc rozpoczęcia i zakończenia podróży. Dowiedz się więcej o opcjonalnych parametrach ograniczających obliczenia, takich jak określony czas odjazdu lub ograniczenia trasy. Zobacz Parametry opcjonalne w przewodniku Żądanie i odpowiedź macierzy odległości (starsza wersja).
4 Podstawowe informacje o odpowiedziach Przeanalizuj odpowiedzi z danymi, aby przygotować się do użycia danych macierzy odległości w aplikacji. Szczegółowe informacje znajdziesz w artykule Odpowiedzi macierzy odległości.
5 Uwzględnij dane z macierzy odległości we własnej 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, korzystając z jednej z tych bibliotek klienta:

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

Co dalej?