Dlaczego warto używać interfejsu Distance Matrix API
Interfejs DISTANCE Matrix API ułatwia określenie najkorzystniejszej tras podróży między różnymi możliwymi punktami początkowymi i docelowymi. Na przykład, których pracowników wysłać na miejsca pracy lub z których magazynów wysłać paczki.
Co można zrobić za pomocą interfejsu Distance Matrix API
Za pomocą interfejsu DISTANCE Matrix API możesz podać czas podróży i odległość macierz 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, np. 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 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 korku
Jak działa interfejs Distance Matrix API
Interfejs Distance Matrix API obsługuje dowolną liczbę miejsc początkowych (punktów początkowych) i miejsc docelowych. Zwraca odległość i czas podróży między każdym miejscem początkowym a wszystkimi miejscami docelowymi, zaczynając od pierwszego miejsca początkowego w żądaniu i przechodząc krok po kroku do kolejnych.
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, zwraca odległości i czas podróży w tej kolejności:
- Od A do C
- Od A do D
- Od B do C
- B do D
Poniżej znajduje się przykład żądania dotyczącego 2 źródeł: Waszyngton, D.C. i Boston z jednym celem podróży, Nowy Jork (Nowy Jork) w Format 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 interfejsu DISTANCE Matrix API wraz z danymi, 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 geograficznych. |
|
|
Jak korzystać z interfejsu Distance Matrix API
1 | Skonfiguruj konto. | Zacznij od skonfigurowania Projekt Google Cloud i dokończ konfigurację. z podanych instrukcji. |
2 | Wypróbuj żądanie dotyczące macierzy odległości | Po uzyskaniu klucza interfejsu API możesz zacząć testować interfejs DISTANCE Matrix API bezpośrednio w przeglądarce. Zobacz przykładowe żądania. znajdziesz w artykule Pierwsze kroki. |
3 | Tworzenie bardziej złożonego zgłoszenia | 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. Zobacz Parametry opcjonalne w przewodniku Matrycy odległości – żądania i odpowiedzi. |
4 | Podstawy odpowiedzi | Przejrzyj odpowiedzi na pytania dotyczące danych, aby przygotować się do korzystania z danych macierzy odległości w swojej aplikacji. Zobacz Odpowiedzi macierzy odległości . |
5 | Włącz dane z matrycy 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łuj ten interfejs API w wybranym języku za pomocą jednej z tych bibliotek klienta:
- Java Client for Google Maps Services
- Python. Klient usług Map Google
- Go Client for Google Maps Services
- Node.js Klient usług Map Google
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?
- Zaczynaj korzystać z Distance Matrix: kliknij Pierwsze kroki.
- Pierwsze kroki z przykładowymi żądaniami i odpowiedziami: otwórz żądanie i odpowiedź dotyczącą macierzy odległości.
- Stosuj sprawdzone metody: zapoznaj się ze sprawdzonymi metodami dotyczącymi usług internetowych.