Method: projects.locations.optimizeTours

string (Duration format)

Jeśli ten czas oczekiwania jest ustawiony, serwer zwraca odpowiedź, zanim upłynie czas oczekiwania lub termin serwera dla żądań synchronicznych, w zależności od tego, co nastąpi wcześniej.

W przypadku żądań asynchronicznych serwer wygeneruje rozwiązanie (jeśli to możliwe) przed upływem limitu czasu.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

object (ShipmentModel)

Model dostawy do rozwiązania.

enum (SolvingMode)

Domyślny tryb rozwiązywania to DEFAULT_SOLVE (0).

enum (SearchMode)

Tryb wyszukiwania użyty do rozwiązania żądania.

object (ShipmentRoute)

Pomaga algorytmowi optymalizacji w znalezieniu pierwszego rozwiązania, które jest podobne do poprzedniego.

Model jest ograniczony podczas tworzenia pierwszego rozwiązania. W pierwszym rozwiązaniu wszystkie przesyłki, które nie zostały zrealizowane na trasie, są domyślnie pomijane, ale mogą być realizowane w kolejnych rozwiązaniach.

Rozwiązanie musi spełniać podstawowe założenia dotyczące ważności:

• w przypadku wszystkich tras vehicleIndex musi mieścić się w zakresie i nie może być powielany.
• w przypadku wszystkich wizyt wartości shipmentIndex i visitRequestIndex muszą mieścić się w zakresie.
• przesyłka może być uwzględniona tylko na jednej trasie;
• odbiór przesyłki z odbiorem i dostawą musi zostać wykonany przed dostawą.
• nie można wykonać więcej niż 1 alternatywy odbioru lub dostawy przesyłki;
• w przypadku wszystkich tras czasy wydłużają się (tzn. vehicleStartTime <= visits[0].start_time <= visits[1].start_time ... <= vehicleEndTime).
• dostawa może być realizowana tylko w pojazdach dozwolonych. Pojazd jest dozwolony, jeśli Shipment.allowed_vehicle_indices jest pusty lub jego vehicleIndex jest zawarty w Shipment.allowed_vehicle_indices.

Jeśli wstrzyknięty kod nie jest wykonalny, niekoniecznie zwracany jest błąd weryfikacji. Zamiast tego może zostać zwrócony błąd wskazujący na brak możliwości wykonania.

object (InjectedSolutionConstraint)

Ograniczenie algorytmu optymalizacji do znalezienia ostatecznego rozwiązania podobnego do poprzedniego. Można go na przykład użyć do zamrożenia części tras, które zostały już ukończone lub mają zostać ukończone, ale nie mogą być modyfikowane.

Jeśli wstrzyknięty kod nie jest wykonalny, niekoniecznie zwracany jest błąd weryfikacji. Zamiast tego może zostać zwrócony błąd wskazujący na brak możliwości wykonania.

object (ShipmentRoute)

Jeśli nie jest pusty, dane trasy zostaną odświeżone bez zmiany ich sekwencji wizyt lub czasu podróży: zostaną zaktualizowane tylko inne szczegóły. Nie rozwiązuje to problemu.

Od listopada 2020 r. ta opcja wypełnia tylko linie wielokątów na niepustych trasach i wymaga, aby parametr populatePolylines miał wartość Prawda.

Pola routePolyline w przekazanych trasach mogą być niezgodne z trasą transitions.

Nie można używać tego pola razem z polem injectedFirstSolutionRoutes ani injectedSolutionConstraint.

Shipment.ignore i Vehicle.ignore nie mają wpływu na sposób działania. Linie wielowymiarowe są nadal wypełniane między wszystkimi wizytami na wszystkich niepustych trasach niezależnie od tego, czy powiązane przesyłki lub pojazdy są ignorowane.

boolean

Jeśli wartość to prawda:

• używa ShipmentRoute.vehicle_label zamiast vehicleIndex do dopasowywania tras w wstrzykniętym rozwiązaniu do pojazdów w żądaniu; ponownie używa mapowania pierwotnego ShipmentRoute.vehicle_index do nowego ShipmentRoute.vehicle_index, aby zaktualizować ConstraintRelaxation.vehicle_indices, jeśli nie jest pusty, ale mapowanie musi być jednoznaczne (tzn. wiele ShipmentRoute nie może mieć tego samego pierwotnego vehicleIndex).
• używa ShipmentRoute.Visit.shipment_label zamiast shipmentIndex do dopasowywania wizyt w wstrzykniętym rozwiązaniu do dostaw w żądaniu;
• używa SkippedShipment.label zamiast SkippedShipment.index, aby dopasować pominięte przesyłki w wstrzykniętym rozwiązaniu do przesyłek żądania.

Ta interpretacja dotyczy pól injectedFirstSolutionRoutes, injectedSolutionConstraint i refreshDetailsRoutes. Można go użyć, gdy indeksy przesyłek lub pojazdów w prośbie uległy zmianie od czasu utworzenia rozwiązania, np. dlatego, że przesyłki lub pojazdy zostały usunięte z prośby lub dodane do niej.

Jeśli ma wartość true, etykiety w tych kategoriach mogą się pojawiać maksymalnie raz w danej kategorii:

• Vehicle.label w prośbie;
• Shipment.label w prośbie;
• ShipmentRoute.vehicle_label w roztworze wstrzykniętym;
• SkippedShipment.label i ShipmentRoute.Visit.shipment_label w wstrzykniętym rozwiązaniu (z wyjątkiem par wizyt odbioru/dostawy, których shipmentLabel musi się pojawiać dwukrotnie).

Jeśli vehicleLabel w wstrzykniętym rozwiązaniu nie odpowiada pojazdowi w żądaniu, odpowiednia trasa wraz z wizytami jest usuwana z rozwiązania. Jeśli shipmentLabel w wstrzykniętym rozwiązaniu nie odpowiada wysyłce żądania, odpowiednia wizyta zostaje usunięta z rozwiązania. Jeśli SkippedShipment.label w rozwiązaniu wstrzykniętym do rozwiązania nie odpowiada dostawie żądania, SkippedShipment zostaje usunięty z rozwiązania.

Usunięcie wizyt na trasie lub całych tras z wstrzykniętego rozwiązania może mieć wpływ na implikowane ograniczenia, co może spowodować zmianę rozwiązania, błędy walidacji lub niemożliwość jego wykonania.

UWAGA: osoba dzwoniąca musi się upewnić, że każda wartość Vehicle.label (odpowiednio Shipment.label) jednoznacznie identyfikuje element pojazdu (odpowiednio przesyłki) używany w 2 odpowiednich żądaniach: poprzednim żądaniu, które wygenerowało OptimizeToursResponse użyte w wstrzykniętym rozwiązaniu, oraz bieżącym żądaniu, które zawiera wstrzyknięte rozwiązanie. Opisane powyżej kontrole unikalnych treści nie wystarczają do spełnienia tego wymagania.

boolean

Warto uwzględnić prognozę ruchu podczas obliczania pól ShipmentRoute Transition.travel_duration, Visit.start_time i vehicleEndTime, ustawiania pola ShipmentRoute.has_traffic_infeasibilities oraz obliczania pola OptimizeToursResponse.total_cost.

boolean

Jeśli ma wartość Prawda, w odpowiedzi ShipmentRoute zostaną wypełnione ścieżki poliliniowe.

boolean

Jeśli ma wartość Prawda, w odpowiedzi ShipmentRoute.transitions zostaną wypełnione tokeny ścieżek i wielolinii.

boolean

Jeśli ta opcja jest ustawiona, żądanie może mieć termin (patrz https://grpc.io/blog/deadlines) do 60 minut. W przeciwnym razie maksymalny termin to tylko 30 minut. Pamiętaj, że w przypadku długotrwałych żądań występuje znacznie większe (choć nadal niewielkie) ryzyko przerwania.

boolean

Jeśli to ustawienie ma wartość true, odległości przebycia zostaną obliczone na podstawie odległości geodezyjnych zamiast odległości w Mapach Google, a czasy przejazdu zostaną obliczone na podstawie odległości geodezyjnych przy prędkości określonej przez parametr geodesicMetersPerSecond.

string

Etykieta, która może służyć do identyfikowania tego żądania, zgłoszonego w formularzu OptimizeToursResponse.request_label.

number

Gdy useGeodesicDistances ma wartość true, to pole musi być ustawione i określa szybkość stosowaną do obliczania czasu podróży. Jego wartość musi wynosić co najmniej 1,0 m/s.

integer

Obcina zwracaną liczbę błędów weryfikacji. Te błędy są zwykle dołączane do ładunku błędu INVALID_ARGUMENT jako szczegóły błędu BadRequest (https://cloud.google.com/apis/design/errors#error_details), chyba że parametr solvingMode=VALIDATE_ONLY: patrz pole OptimizeToursResponse.validation_errors. Domyślna wartość to 100,a maksymalna – 10 tys.