Krótkie podsumowanie Route Optimization API

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ą injectedFirstSolutionRoutes lub injectedSolutionConstraint.
  • 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

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: typowe błędy

  • Problem: w przypadku wywołań REST do blokującego punktu końcowego OptimizeTours domyślny 60-sekundowy termin zastępuje każdą wartość timeout w treści żądania, która jest większa niż 60 sekund. Rozwiązanie: ustaw nagłówek X-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 timeout i deadline są ograniczone do 1800 sekund. Rozwiązanie: ustaw allowLargeDeadlineDespiteInterruptionRisk na true, 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. costPerHour lub costPerKilometer) 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.