Method: projects.locations.optimizeTours

string (Duration format)

Jeśli ten limit czasu jest ustawiony, serwer zwraca odpowiedź przed upływem limitu czasu lub przed osiągnięciem terminu 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.

object (ShipmentModel)

Model dostawy do rozwiązania.

enum (SolvingMode)

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

enum (SearchMode)

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

object (ShipmentRoute)

Pomóż algorytmowi optymalizacji znaleźć pierwsze rozwiązanie podobne do poprzedniego.

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

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

• W przypadku wszystkich tras wartość vehicleIndex musi mieścić się w zakresie i nie może być zduplikowana.
• w przypadku wszystkich wizyt wartości shipmentIndex i visitRequestIndex muszą mieścić się w zakresie.
• przesyłka może być powiązana tylko z jedną trasą.
• odbiór przesyłki z odbiorem i dostawą musi nastąpić przed dostawą.
• można zrealizować nie więcej niż 1 alternatywną opcję odbioru lub dostawy przesyłki.
• w przypadku wszystkich tras czas się wydłuża (np. vehicleStartTime <= visits[0].start_time <= visits[1].start_time ... <= vehicleEndTime).
• Przesyłkę można zrealizować tylko w przypadku pojazdu, który jest dozwolony. Pojazd jest dozwolony, jeśli pole Shipment.allowed_vehicle_indices jest puste lub jego vehicleIndex znajduje się w Shipment.allowed_vehicle_indices.

Jeśli wstrzyknięte rozwiązanie jest niewykonalne, niekoniecznie zwracany jest błąd weryfikacji. Zamiast tego może zostać zwrócony błąd wskazujący na niewykonalność.

object (InjectedSolutionConstraint)

Ogranicz algorytm optymalizacji, aby znaleźć rozwiązanie końcowe podobne do poprzedniego. Może to być na przykład używane do zamrażania części tras, które zostały już ukończone lub które mają zostać ukończone, ale nie mogą być modyfikowane.

Jeśli wstrzyknięte rozwiązanie jest niewykonalne, niekoniecznie zwracany jest błąd weryfikacji. Zamiast tego może zostać zwrócony błąd wskazujący na niewykonalność.

object (ShipmentRoute)

Jeśli nie jest pusta, podane trasy zostaną odświeżone bez modyfikowania ich podstawowej sekwencji wizyt ani czasów podróży: zaktualizowane zostaną tylko inne szczegóły. Nie rozwiązuje to modelu.

Od listopada 2020 r. wypełnia ona tylko linie łamane niepustych tras i wymaga, aby wartość populatePolylines była równa „true”.

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

Tego pola nie można używać razem z atrybutami injectedFirstSolutionRoutes lub injectedSolutionConstraint.

Shipment.ignore i Vehicle.ignore nie mają wpływu na to działanie. Linie łamane 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 ma wartość prawda:

• używa ShipmentRoute.vehicle_label zamiast vehicleIndex, aby dopasować trasy w rozwiązaniu wstrzykniętym do pojazdów w żądaniu; ponownie wykorzystuje mapowanie pierwotnego ShipmentRoute.vehicle_index na nowy ShipmentRoute.vehicle_index, aby zaktualizować ConstraintRelaxation.vehicle_indices, jeśli nie jest pusty, ale mapowanie musi być jednoznaczne (tzn. wiele ShipmentRoute nie może współdzielić tego samego pierwotnego vehicleIndex).
• używa symbolu ShipmentRoute.Visit.shipment_label zamiast shipmentIndex, aby dopasować wizyty w wstrzykniętym rozwiązaniu do przesyłek w żądaniu;
• używa symbolu SkippedShipment.label zamiast SkippedShipment.index, aby dopasować pominięte przesyłki w wstrzykniętym rozwiązaniu do przesyłek w żądaniu.

Ta interpretacja dotyczy pól injectedFirstSolutionRoutes, injectedSolutionConstraint i refreshDetailsRoutes. Może być używana, gdy indeksy przesyłek lub pojazdów w żądaniu uległy zmianie od czasu utworzenia rozwiązania, np. z powodu usunięcia lub dodania przesyłek lub pojazdów.

Jeśli tak, etykiety w tych kategoriach muszą pojawiać się w swojej kategorii co najwyżej raz:

• Vehicle.label w żądaniu;
• Shipment.label w żądaniu;
• ShipmentRoute.vehicle_label w roztworze do wstrzykiwań;
• SkippedShipment.label i ShipmentRoute.Visit.shipment_label we wstrzykniętym rozwiązaniu (z wyjątkiem par wizyt związanych z odbiorem lub dostawą, w których shipmentLabel musi wystąpić 2 razy).

Jeśli vehicleLabel w wstrzykniętym rozwiązaniu nie odpowiada pojazdowi z żądania, odpowiednia trasa jest usuwana z rozwiązania wraz z wizytami. Jeśli shipmentLabel w rozwiązaniu nie odpowiada przesyłce z prośbą, odpowiednia wizyta jest usuwana z rozwiązania. Jeśli SkippedShipment.label w roztworze wstrzykiwanym nie odpowiada przesyłce z prośbą, SkippedShipment jest usuwany z roztworu.

Usunięcie wizyt na trasie lub całych tras z wstrzykniętego rozwiązania może wpłynąć na domniemane ograniczenia, co może spowodować zmianę rozwiązania, błędy weryfikacji lub niemożność jego zastosowania.

UWAGA: dzwoniący musi się upewnić, że każdy znak Vehicle.label (odpowiednio Shipment.label) jednoznacznie identyfikuje pojazd (lub przesyłkę) użyty w 2 odpowiednich żądaniach: w żądaniu z przeszłości, które wygenerowało OptimizeToursResponse użyte w wstrzykniętym rozwiązaniu, oraz w bieżącym żądaniu, które zawiera wstrzyknięte rozwiązanie. Opisane powyżej kontrole unikalności nie wystarczą, aby zagwarantować spełnienie tego wymagania.

boolean

Przy obliczaniu pól ShipmentRoute Transition.travel_duration, Visit.start_time i vehicleEndTime, ustawianiu pola ShipmentRoute.has_traffic_infeasibilities oraz obliczaniu pola OptimizeToursResponse.total_cost weź pod uwagę szacunkową liczbę wizyt.

boolean

Jeśli ma wartość Prawda, w odpowiedziach ShipmentRoute będą wypełniane polilinie.

boolean

Jeśli ma wartość Prawda, w odpowiedzi ShipmentRoute.transitions zostaną wypełnione linie łamane i tokeny trasy.

boolean

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

boolean

Jeśli wartość to „prawda”, odległości podróży będą obliczane na podstawie odległości geodezyjnych zamiast odległości w Mapach Google, a czasy podróży będą obliczane na podstawie odległości geodezyjnych z prędkością określoną przez parametr geodesicMetersPerSecond.

string

Etykieta, która może służyć do identyfikowania tego żądania i jest zwracana w parametrze OptimizeToursResponse.request_label.

number

Gdy wartość useGeodesicDistances to „true”, to pole musi być ustawione i określa prędkość używaną do obliczania czasu podróży. Jej wartość musi wynosić co najmniej 1,0 m/s.

integer

Obcina liczbę zwracanych błędów weryfikacji. Błędy te 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 solvingMode=VALIDATE_ONLY: patrz pole OptimizeToursResponse.validation_errors. Domyślna wartość to 100,a maksymalna to 10 000.