Interfejs Route Optimization API przypisuje zadania i trasy do floty pojazdów, optymalizując je pod kątem podanych przez Ciebie celów i ograniczeń, takich jak przedziały czasu, pojemność pojazdu, godziny pracy kierowcy i koszty. Wywołujesz go za pomocą interfejsu REST, gRPC lub bibliotek klienta, a on zwraca sekwencje wizyt, przypisania przesyłek, szacowane czasy i dane tras.
Route Optimization API: najważniejsze informacje
- Usługa: Route Optimization API
- Inne nazwy: GMPRO
- Kategoria: Trasy
- Platforma: usługa internetowa (REST)
- Działa na: serwerze (kod backendu)
- Etap uruchomienia: GA
- Cykl życia: aktywny
- Omówienie: Route Optimization API
Route Optimization API: kiedy używać
Kiedy używać Route Optimization API:
- Musisz przypisać przesyłki lub zadania do kilku pojazdów, uwzględniając przedziały czasu, pojemność pojazdów, godziny pracy kierowców i koszty.
- Potrzebujesz najlepszej sekwencji przystanków dla jednego pojazdu z kilkoma odbiorami, dostawami lub spotkaniami.
- Musisz ponownie zoptymalizować aktywne trasy pod kątem nowych zamówień (np. wysyłki na żądanie) za pomocą
injectedFirstSolutionRouteslubinjectedSolutionConstraint. - Aby przekazać do pakietu Navigation SDK, potrzebujesz tokenów trasy dla każdego etapu zoptymalizowanego planu.
Kiedy nie używać Route Optimization API:
- Potrzebujesz śledzenia na żywo sposobu, w jaki kierowcy realizują plan. Interfejs API zwraca zaplanowane linie łamane, a nie trasy pojazdów w czasie rzeczywistym. Zamiast tego użyj usługi Fleet Engine.
- Potrzebujesz szczegółowych wskazówek dojazdu w aplikacji dla kierowców na zoptymalizowanej trasie. Zamiast tego użyj pakietu Navigation SDK na Androida.
- Potrzebujesz szczegółowych wskazówek dojazdu w aplikacji dla kierowców na iOS na zoptymalizowanej trasie. Zamiast tego użyj pakietu Navigation SDK na iOS.
Route Optimization API: konfiguracja
- Usługa do włączenia:
routeoptimization.googleapis.com - Uwierzytelnianie: OAuth 2.0, konto usługi
- Pierwsze kroki: skonfiguruj Route Optimization API
- Dokumentacja: dokumentacja Route Optimization API
- Ceny: korzystanie z Route Optimization API i płatności
- Zasady: Zasady dotyczące Route Optimization API
- Informacje o wersji: informacje o wersji Route Optimization API
Oficjalne pakiety Route Optimization API:
- npm:
@googlemaps/routeoptimization - pypi:
google-maps-routeoptimization - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routeoptimization
Route Optimization API: produkty powiązane
- Często używane z: Navigation SDK na Androida, Navigation SDK na iOS, Fleet Engine Service, Maps JavaScript API
Route Optimization API: typowe błędy
- Problem: w przypadku wywołań REST do blokującego punktu końcowego
OptimizeToursdomyślny 60-sekundowy termin zastępuje każdą wartośćtimeoutw treści żądania, która jest większa niż 60 sekund. Rozwiązanie: ustaw nagłówekX-Server-Timeout(sekundy, bez sufiksu „s”), aby wydłużyć termin. Biblioteki klienta i gRPC domyślnie używają wartości 3600 sekund. Zobacz /maps/documentation/route-optimization/timeouts. - Problem: wartości
timeouti deadline są ograniczone do 1800 sekund. Rozwiązanie: ustawallowLargeDeadlineDespiteInterruptionRisknatrue, aby zezwolić na maksymalnie 3600 sekund, akceptując wyższe ryzyko błędów związanych z przerwaniem. Zobacz /maps/documentation/route-optimization/timeouts. - Problem: bez parametrów kosztów (np.
costPerHourlubcostPerKilometer) optymalizator traktuje wszystkie rozwiązania jako równe. Rozwiązanie: zdefiniuj parametry kosztów pojazdów, które odzwierciedlają koszty Twojej firmy. Zobacz /maps/documentation/route-optimization/make-first-request. - Problem: żądania uwierzytelnione za pomocą klucza interfejsu API kończą się niepowodzeniem; każde żądanie wymaga tokena OAuth. Rozwiązanie: użyj tokena OAuth z zakresem
https://www.googleapis.com/auth/cloud-platform, na przykład za pomocą domyślnego uwierzytelniania aplikacji lub konta usługi. Zobacz /maps/documentation/route-optimization/cloud-setup#create-an-oauth-token.
Co możesz zrobić za pomocą Route Optimization API
Zapoznaj się z przewodnikami po poszczególnych zadaniach, do których linki znajdziesz poniżej, lub porównaj usługi w Eksploratorze funkcji.
- Zwracaj plan dostawy z wieloma przystankami, zoptymalizowany na podstawie określonych ograniczeń dotyczących trasy, kosztów, przesyłki i pojazdu.
- Zwracaj czas rozpoczęcia i zakończenia każdego przystanku w zoptymalizowanym planie dostawy.
- Zwracaj czas podróży, opóźnienia, przerwy i oczekiwania między poszczególnymi przystankami w zoptymalizowanym planie dostawy.
- Zwracanie informacji o obciążeniu pojazdu na każdym przystanku w zoptymalizowanym planie dostawy.
- Zwracanie informacji o kosztach każdej dostawy w zoptymalizowanym planie dostawy.
- Zwracanie zakodowanej linii łamanej trasy między poszczególnymi przystankami w zoptymalizowanym planie dostawy.
- Zwracaj token trasy nawigacyjnej dla trasy między poszczególnymi przystankami w zoptymalizowanym planie dostawy.
- Zwracanie zagregowanych danych dotyczących przesyłek, pojazdów i kosztów na potrzeby zoptymalizowanego planu dostawy.
- Określ przedział czasu rozpoczęcia i zakończenia planu dostawy z wieloma przystankami.
- Określ czas rozpoczęcia i zakończenia dostępności oraz lokalizacje każdego pojazdu w planie dostawy z wieloma przystankami.
- Określ koszty czasu pojazdu dla każdego pojazdu w planie dostawy z wieloma przystankami.
- Określ parametry modelu kosztów dla planu dostawy z wieloma przystankami.
- Określ ograniczenia czasowe odbioru i czasu dostawy dla każdej przesyłki w planie dostawy z wieloma przystankami.
- Określ przypisania pojazdów w planie dostawy z wieloma przystankami.
- Określ limity obciążenia dla każdego pojazdu w planie dostawy z wieloma przystankami.
- Określ, czy w przypadku planu dostawy z wieloma przystankami mają być uwzględniane informacje o ruchu w czasie rzeczywistym.
- Przetwarzaj wsadowo żądania optymalizacji planu dostawy z wieloma przystankami i zapisuj odpowiedzi w Google Cloud Storage.
- Zarezerwuj czas na parkowanie przed dostawą.
- Ustalaj priorytety wizyt w pobliżu, aby odbywały się jedna po drugiej.
- Unikaj zawracania na trasie pojazdu z wieloma przystankami. Eksperymentalna Uwaga: funkcja eksperymentalna; podlega warunkom i ograniczeniom przed GA.
- Optymalizacja pod kątem wstępnie zdefiniowanych celów. Eksperymentalna Uwaga: funkcja eksperymentalna; podlega warunkom i ograniczeniom przed GA.
- Dostarczaj najpierw cięższe przesyłki. Eksperymentalna Uwaga: funkcja eksperymentalna; podlega warunkom i ograniczeniom dotyczącym wersji przed GA.