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
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. |
|
|
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:
- 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 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?
- Zacznij korzystać z macierzy odległości: przejdź do sekcji Pierwsze kroki.
- Zacznij korzystać z przykładowych żądań i odpowiedzi: przeczytaj artykuł o żądaniach i odpowiedziach macierzy odległości.
- Postępuj zgodnie ze sprawdzonymi metodami: zapoznaj się ze sprawdzonymi metodami dotyczącymi usług internetowych.