Dlaczego warto korzystać z interfejsu Distance Matrix API
Możesz użyć interfejsu Distance Matrix API, aby pomóc w określeniu najefektywniejszych tras podróży między wieloma możliwymi miejscami docelowymi i miejscami docelowymi. Na przykład określa, które pracownicy wysyłają do miejsc pracy lub z których magazynów wysyłają paczki.
Do czego służy interfejs Distance Matrix API
Za pomocą interfejsu Distance Matrix API możesz podać odległość i czas podróży dla macierzy miejsc początkowych i docelowych. Możesz określić kilka opcji, w tym środek transportu, np. samochód, rower, transport publiczny lub pieszo, oraz środki transportu publicznego, takie jak autobus, metro, pociąg, tramwaj lub pociąg.
Interfejs Distance Matrix API dostarcza informacje na podstawie zalecanej trasy między punktem początkowym a końcowym. Możesz prosić o tego rodzaju dane o odległości:
- Odległość dla wybranego środka transportu
- Dystans w kilometrach lub milach
- Szacowany czas podróży przy obecnym natężeniu ruchu
Jak działa interfejs Distance Matrix API
Interfejs Distance Matrix API używa dowolnej liczby punktów początkowych i miejsc docelowych. Zwraca odległość i czas podróży między miejscem wylotu a wszystkich żądanymi miejscami docelowymi, zaczynając od pierwszego punktu początkowego w żądaniu i przechodząc do kolejnego.
Jeśli na przykład w żądaniu określono A i B jako punkt początkowy, a miejsca docelowe C i D, funkcja zwraca odległości i czas podróży w tej kolejności:
- A do C
- A–D
- B do C
- B do D
Ten przykład przedstawia żądanie dotyczące 2 miejsc wylotu: Waszyngton, D.C i Boston z jednym celem podróży 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 Distance Matrix API oraz zwracane przez nie dane.
Zasoby danych | Zwrócone dane | Format zwracanych |
---|---|---|
Macierz odległości
Podaj miejsca początkowe i miejsca 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 | Przygotuj się | Zacznij od konfiguracji projektu Google Cloud i wykonaj podane niżej instrukcje konfiguracji. |
2 | Wypróbuj żądanie macierzy odległości | Gdy masz klucz 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 wysłać żądanie, które dostarcza wiele miejsc wylotu i przylotu. Dowiedz się więcej o opcjonalnych parametrach, które ograniczają obliczenia, takich jak określony czas odjazdu czy ograniczenia trasy. Zapoznaj się z parametrami opcjonalnymi w przewodniku żądania i odpowiedzi macierzy odległości. |
4 | Podstawowe informacje o odpowiedziach | Przejrzyj odpowiedzi danych, aby przygotować się do korzystania z danych macierzy odległości w aplikacji. 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:
- Klient Java dla usług Map Google
- Klient Pythona dla usług Map Google
- Klient Go dla usług Map Google
- Klient Node.js dla usług Map Google
Klienty Java, Python, Go i Node.js dla usług Map Google to obsługiwane przez społeczność biblioteki klienckie udostępniane na licencji open source na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.
Co dalej
- Zacznij korzystać z macierzy odległości: przejdź do sekcji Pierwsze kroki.
- Zacznij od przykładowych żądań i odpowiedzi: przeczytaj artykuł na temat żądania i odpowiedzi macierzy odległości.
- Zastosuj sprawdzone metody: przeczytaj artykuł ze sprawdzonymi metodami dotyczącymi usług internetowych.