Dlaczego warto korzystać z interfejsu Routes API
Dzięki interfejsowi Routes API możesz uzyskiwać dokładne trasy i informacje o podróżach na podstawie szczegółów transportu, aktualnych informacji o natężeniu ruchu i warunkach na drodze oraz ustawień trasy:
Rodzaj i możliwości różnych środków transportu
Kierunek, w którym zmierza pojazd
Pobocze drogi do tego celu
Warunki drogowe i zamknięte drogi
kwestie bezpieczeństwa, takie jak unikanie niebezpiecznych obszarów lub zapewnianie bezpiecznych obszarów odbioru;
Zrównoważ czas oczekiwania, jakość i koszty w przypadku różnych tras, korzystając z opcjonalnych funkcji, takich jak opłaty za przejazd i metadane podróży, np. czas i odległość oraz spalanie
Możesz też wyznaczać najbardziej efektywne trasy na potrzeby planowania wysyłki, na przykład:
Jak najlepiej przypisać zbiór instancji roboczych do odbierania serii pakietów
Ustal najlepszy magazyn, z którego chcesz wysłać paczki do miejsca docelowego.
Do czego służy interfejs Routes API?
Interfejs Routes API udostępnia 2 główne kategorie informacji o routingu:
trasy z lokalizacji do jednego lub wielu miejsc docelowych,
Tablica możliwych tras między wieloma lokalizacjami początkowymi i końcowymi.
Wyznaczaj trasy do jednego lub wielu miejsc docelowych
Metoda Compute Routes
interfejsu Routes API pozwala obliczać dane między lokalizacjami:
Wyznacz trasę dojazdu na różne sposoby oraz w przypadku jednego lub wielu miejsc docelowych:
Środki transportu, w tym transport publiczny, samochodem, pojazdami dwukołowymi, pieszo lub rowerem.
Szereg punktów pośrednich, które można zoptymalizować pod kątem najefektywniejszego sposobu ich dotarcia.
Wiele sposobów określania punktu początkowego, docelowego i punktów pośrednich:
Ciągi tekstowe. Na przykład: „Chicago, IL”, „Darwin, NT, Australia”, „1800 Amphitheatre Parkway, Mountain View, CA 94043” lub „CWF6+FWX Mountain View, California”.
Identyfikatory miejsc
Długość i szerokość geograficzna, opcjonalnie z kierunkiem pojazdu
Dostosowywanie opcji tras do swoich potrzeb i celów:
Wybierz trasy z najniższym spalaniem lub energią dla danego typu silnika: Diesel, elektryczny, hybrydowy, gaz. Więcej informacji znajdziesz w artykule o wyznaczaniu tras przyjaznych dla środowiska.
Ustaw szczegółowe opcje obliczania ruchu, co pozwoli Ci podejmować decyzje dotyczące jakości i opóźnienia. Więcej informacji znajdziesz w sekcji Określanie, czy i w jaki sposób uwzględniać dane o ruchu.
Ustaw kierunek pojazdu (kierunek podróży) i informacje o boku drogi, aby zwiększyć dokładność szacowanego czasu dotarcia na miejsce. Więcej informacji znajdziesz w sekcji Określanie kierunku i strony drogi.
Określ miejsca docelowe oraz końcowe i bezpieczne miejsca postoju. Więcej informacji znajdziesz w artykułach Ustawianie przystanku na trasie i Ustawianie punktu, przez który przebiega trasa.
Poproś o informacje o opłatach, a także odległość trasy i szacowany czas dotarcia na miejsce. Więcej informacji znajdziesz w sekcji Obliczanie opłat drogowych na danej trasie.
Kontroluj czas oczekiwania i jakość, wysyłając żądania tylko do tych danych, których potrzebujesz. Za pomocą maski pola możesz uniknąć niepotrzebnego czasu przetwarzania i wyższych opłat za żądania. Szczegółowe informacje znajdziesz w sekcji Wybieranie informacji do zwrócenia.
Pobierz macierz możliwych tras
Metoda Compute Route Matrix
interfejsu Routes API dostarcza informacji o zalecanych trasach między wieloma punktami początkowymi i końcowymi, w tym odległość i szacowany czas przyjazdu, aby pomóc Ci wybrać najlepsze miejsca wylotu i miejsca docelowe zgodnie z Twoimi potrzebami biznesowymi. 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
Dzięki danym o odległości możesz określić najwydajniejszy sposób kierowania pasażerów, przesyłki lub pracowników między różnymi miejscami wylotu i docelowym.
Możesz przesyłać strumieniowo elementy odpowiedzi, zanim cała macierz zostanie obliczona, co zmniejszy czas oczekiwania na odpowiedź.
Możesz określić wiele punktów początkowych i miejsc docelowych w żądaniu po stronie serwera przez liczbę punktów początkowych pomnożoną przez liczbę miejsc docelowych wynoszącą maksymalnie 625.
Jak działa interfejs Routes API
Interfejs Routes API ma 2 metody: ComputeRoutes
i ComputeRouteMatrix
.
ComputeRoutes
Metoda ComputeRoutes
interfejsu Routes API akceptuje żądanie HTTP POST z treścią żądania JSON, która zawiera szczegóły żądania. Wymagane są atrybuty punktu początkowego, docelowego, podróżnego i maska pola, które określają, które pola mają zostać zwrócone.
Przykład
curl -X POST -d '{ "origin": { "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043" }, "destination": { "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132" }, "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Usługa oblicza następnie żądaną trasę i zwraca żądane pola.
ComputeRouteMatrix
Interfejs Routes API ComputeRouteMatrix
akceptuje żądanie HTTP POST z treścią żądania JSON, która zawiera szczegóły żądania. Wymagane są co najmniej 1 źródło, co najmniej 1 miejsce docelowe, TravelMode i maska pola, które określają, które pola mają zostać zwrócone.
Przykład
curl -X POST -d '{ "origins": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420761, "longitude": -122.081356 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.403184, "longitude": -122.097371 } } } } ], "destinations": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420999, "longitude": -122.086894 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.383047, "longitude": -122.044651 } } } } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \ 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
Odpowiedź zawiera możliwe trasy połączenia wszystkich punktów na trasie wylotu i docelowego.
Zasoby
W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych w ramach interfejsu Routes API wraz z danymi zwróconymi przez nie.
Zasoby danych | Zwrócone dane | Format zwracanych |
---|---|---|
ComputeRoutes | Zwraca w razie potrzeby trasy, etapy i kroki trasy z alternatywnymi trasami. | JSON |
ComputeRouteMatrix | Zwraca tablicę tras z jednego punktu na trasie wylotu do jednego docelowego punktu na trasie. |
Jak korzystać z interfejsu Routes API
1 | Skonfiguruj | Zacznij od konfigurowania projektu Google Cloud i postępuj zgodnie z poniższymi instrukcjami. |
2 | Obliczanie trasy i sprawdzanie odpowiedzi | Więcej informacji znajdziesz w sekcjach Wyznaczanie trasy i Przeglądanie odpowiedzi na pytania dotyczące trasy. |
3 | Obliczanie macierzy tras i sprawdzanie odpowiedzi | Więcej informacji znajdziesz w sekcjach Uzyskiwanie macierzy tras i Sprawdzanie odpowiedzi macierzy tras. |
Dostępne biblioteki klienta
Listę dostępnych bibliotek klienta dla interfejsu Routes API znajdziesz w artykule Biblioteki klienta.