Dlaczego warto korzystać z interfejsu Distance Matrix API
Interfejsu Distance Matrix API możesz używać do określania najbardziej wydajnych tras podróży między wieloma możliwymi punktami początkowymi i docelowymi. Na przykład, których pracowników wysłać na strony z ofertami pracy lub z których magazynów wysłać paczki.
Co można robić za pomocą interfejsu Distance Matrix API
Dzięki interfejsowi Distance Matrix API możesz podać odległość i czas podróży dla macierzy miejsc wyjazdu i miejsc 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 korzysta z dowolnej liczby miejsc początkowych (punktów początkowych) i miejsc docelowych, a następnie zwraca odległość i czas podróży między każdym miejscem początkowym a wszystkimi żądanymi miejscami docelowymi, zaczynając od pierwszego miejsca początkowego w żądaniu i stopniowo przechodząc 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 punkty docelowe, zwracane są odległości i czas podróży w tej kolejności:
- A–C
- A–D
- B to C
- B do D
Ten przykład pokazuje żądanie dotyczące 2 miejsc odjazdu: Waszyngton i Boston, z jednym miejscem docelowym, 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
Tabela poniżej zawiera podsumowanie zasobów dostępnych za pomocą interfejsu Distance Matrix API wraz z zwracanymi przez niego danymi.
Zasoby danych | Zwrócone dane | Format zwracanej wartości |
---|---|---|
Macierz odległości
Podaj punkty początkowe i docelowe w postaci identyfikatorów miejsc, adresów lub współrzędnych szerokości i długości geograficznej. |
|
|
Jak korzystać z interfejsu Distance Matrix API
1 | Konfiguracja | Zacznij od skonfigurowania projektu Google Cloud i wykonaj podane niżej instrukcje konfiguracji. |
2 | Wyślij prośbę o macierz odległości | Gdy masz klucz interfejsu API, możesz zacząć testować interfejs Distance Matrix API bezpośrednio w przeglądarce. Przykłady przykładowych żądań znajdziesz w przewodniku dla początkujących. |
3 | Tworzenie bardziej złożonego zgłoszenia | Wyślij żądanie zawierające wiele punktów początkowych i docelowych. Dowiedz się więcej o opcjonalnych parametrach, które ograniczają obliczenia, takich jak określony czas wyjazdu lub ograniczenia trasy. Informacje o parametrach opcjonalnych znajdziesz w przewodniku Zgłoszenie i odpowiedź Distance Matrix. |
4 | Podstawy odpowiedzi | Przejrzyj odpowiedzi z danymi, aby przygotować się do korzystania z danych macierzy odległości w aplikacji. Więcej informacji znajdziesz w artykule Odpowiedzi z macierzy odległości. |
5 | Włącz dane z matrycy odległości do swojej aplikacji. | Na podstawie tych danych możesz obliczyć odległość i czas 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 Client for Google Maps Services
- Go Client do usług Map Google
- Node.js Klient usług Map Google
Biblioteki klienta Java, Python, Go i Node.js do obsługi Usług Google Maps są obsługiwane przez społeczność i udostępniane na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.
Co dalej?
- Zacznij korzystać z Distance Matrix: kliknij Pierwsze kroki.
- Pierwsze kroki z przykładowymi żądaniami i odpowiedziami: otwórz żądanie i odpowiedź dotyczącą funkcji Distance Matrix.
- Stosuj sprawdzone metody: zapoznaj się ze sprawdzonymi metodami dotyczącymi usług internetowych.