Package google.maps.routeoptimization.v1

int32

Liczba zrealizowanych przesyłek. Pamiętaj, że para „odbiór” i „dostawa” jest liczona tylko raz.

Duration

Łączny czas podróży na danej trasie lub w ramach danego rozwiązania.

Duration

Łączny czas oczekiwania na trasę lub rozwiązanie.

Duration

Łączny czas opóźnienia na trasie lub w rozwiązaniu.

Duration

Łączny czas przerwy na trasie lub w rozwiązaniu.

Duration

Łączny czas trwania wizyty na trasie lub w ramach rozwiązania.

Duration

Łączny czas trwania powinien być równy sumie wszystkich czasów trwania powyżej. W przypadku tras odpowiada ona też:

[ShipmentRoute.vehicle_end_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_end_time] - [ShipmentRoute.vehicle_start_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_start_time]

double

Całkowita odległość do przebycia na trasie lub w ramach rozwiązania.

map<string, VehicleLoad>

Maksymalne obciążenie osiągnięte na całej trasie (odpowiednio: w rozwiązaniu) dla każdej ilości na tej trasie (odpowiednio: w rozwiązaniu) obliczone jako maksimum wszystkich Transition.vehicle_loads (odpowiednio: ShipmentRoute.metrics.max_loads.

string

Wymagane. Wybierz projekt i lokalizację, aby wykonać połączenie.

Format: * projects/{project-id} * projects/{project-id}/locations/{location-id}

Jeśli nie określisz lokalizacji, region zostanie wybrany automatycznie.

AsyncModelConfig

Wymagane. Informacje wejściowe/wyjściowe dotyczące każdego modelu zakupu, takie jak ścieżki plików i formaty danych.

string

Opcjonalnie: Nazwa modelu zdefiniowana przez użytkownika, która może być używana jako alias do śledzenia modeli.

InputConfig

Wymagane. Informacje o modelu wejściowym.

OutputConfig

Wymagane. Informacje o chcianej lokalizacji wyjściowej.

BreakRequest

Sekwencja przerw. Zobacz wiadomość BreakRequest.

FrequencyConstraint

Mogą obowiązywać różne FrequencyConstraint. Wszystkie te warunki muszą być spełnione w ciągu BreakRequest tego BreakRule. Zobacz FrequencyConstraint.

Timestamp

Wymagane. Dolna granica (włącznie) na początku przerwy.

Timestamp

Wymagane. Górna granica (włącznie) na początku przerwy.

Duration

Wymagane. Minimalny czas trwania przerwy. Musi być dodatni.

Duration

Wymagane. Minimalny czas trwania przerwy dla tego ograniczenia. Nieujemna. Zobacz opis FrequencyConstraint.

Duration

Wymagane. Maksymalny dozwolony przedział czasu na trasie, który nie obejmuje co najmniej częściowej przerwy duration >= min_break_duration. Musi być dodatni.

int64

twardy limit ograniczający odległość do maksymalnie max_metrów. Limit nie może być liczbą ujemną.

int64

miękki limit, który nie narzuca maksymalnego limitu odległości, ale w przypadku jego naruszenia powoduje koszt, który jest dodawany do innych kosztów zdefiniowanych w modelu, z tą samą jednostką.

Jeśli parametr soft_max_meters jest zdefiniowany, musi być mniejszy niż max_meters i nie może być liczbą ujemną.

double

Koszty na kilometr, które mogą wzrosnąć do soft_max_meters, według formuły:

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

Te koszty nie są obsługiwane w route_distance_limit.

double

Koszt za kilometr, jeśli odległość przekracza limit soft_max_meters. Jeśli odległość jest mniejsza od limitu, dodatkowy koszt wynosi 0. W przeciwnym razie koszt jest obliczany według tego wzoru:

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

Koszt musi być nieujemny.

string

Wymagane. Identyfikator URI obiektu w Google Cloud Storage.

string

Wymagane. Identyfikator URI obiektu w Google Cloud Storage w formacie gs://bucket/path/to/object.

ShipmentRoute

Trasy, którymi roztwór ma być podawany. Niektóre trasy mogą zostać pominięte w początkowym rozwiązaniu. Trasy i przesyłki pominięte muszą spełniać podstawowe założenia oparte na injected_first_solution_routes.

SkippedShipment

Pominięte przesyłki rozwiązania do wstrzyknięcia. Niektóre z nich mogą zostać pominięte w pierwotnym rozwiązaniu. Zapoznaj się z polem routes.

ConstraintRelaxation

W przypadku co najmniej 1 grupy pojazdów określa, kiedy i w jakim stopniu można złagodzić ograniczenia. Jeśli to pole jest puste, wszystkie niepuste trasy pojazdów są w pełni ograniczone.

Relaxation

Wszystkie łagodniejsze ograniczenia dotyczące wizyt, które będą obowiązywać w przypadku wizyt na trasach z pojazdami w vehicle_indices.

int32

Określa indeksy pojazdów, do których ma zastosowanie ograniczenie wizyt relaxations. Jeśli pole jest puste, jest ono uważane za domyślne, a relaxations dotyczy wszystkich pojazdów, które nie są określone w innych constraint_relaxations. Może być maksymalnie 1 wartość domyślna, czyli maksymalnie 1 pole z opcją zniesienia ograniczenia może być puste vehicle_indices. Indeks pojazdu może być wymieniony tylko raz, nawet w kilku constraint_relaxations.

Indeks pojazdu jest mapowany tak samo jak ShipmentRoute.vehicle_index, jeśli interpret_injected_solutions_using_labels ma wartość true (patrz komentarz fields).

Level

Poziom zniesienia ograniczenia, który ma zastosowanie, gdy warunki na poziomie threshold_time LUB PO threshold_time są spełnione.threshold_visit_count

Timestamp

Czas, w którym lub po którym można zastosować level.

int32

Liczba wizyt, po których można zastosować level. Jeśli wartość threshold_visit_count to 0 (lub nie jest określona), wartość level może zostać zastosowana bezpośrednio po uruchomieniu pojazdu.

Jeśli jest to route.visits_size() + 1, level może być stosowany tylko w przypadku pojazdu. Jeśli jest większa niż route.visits_size() + 1, level nie jest w ogóle stosowana na tej trasie.

DataFormat

Wymagane. Format danych wejściowych.

GcsSource

lokalizacja w Google Cloud Storage, Musi to być pojedynczy obiekt (plik).

LatLng

Współrzędne geograficzne punktu drogi.

int32

Kierunek kompasu związany z kierunkiem ruchu. Ta wartość służy do określenia strony drogi, z której ma nastąpić odbiór i zwrot. Wartości kierunku mogą wynosić od 0 do 360, gdzie 0 to kierunek na północ, 90 to kierunek na wschód itd.

string

Wymagane. Wybierz projekt lub lokalizację, do których chcesz zadzwonić.

Format: * projects/{project-id} * projects/{project-id}/locations/{location-id}

Jeśli nie określisz lokalizacji, region zostanie wybrany automatycznie.

Duration

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.

ShipmentModel

Model dostawy do rozwiązania.

SolvingMode

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

SearchMode

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

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 vehicle_index musi mieścić się w zakresie i nie może być powielany.
• w przypadku wszystkich wizyt wartości shipment_index i visit_request_index 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. vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time).
• dostawa może być realizowana tylko w pojazdach dozwolonych. Pojazd jest dozwolony, jeśli Shipment.allowed_vehicle_indices jest pusty lub jego vehicle_index 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.

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.

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 populate_polylines miał wartość Prawda.

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

Nie można używać tego pola razem z polem injected_first_solution_routes ani injected_solution_constraint.

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.

bool

Jeśli wartość to prawda:

• używa ShipmentRoute.vehicle_label zamiast vehicle_index 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 vehicle_index).
• używa ShipmentRoute.Visit.shipment_label zamiast shipment_index 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 injected_first_solution_routes, injected_solution_constraint i refresh_details_routes. 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 shipment_label musi się pojawiać dwukrotnie).

Jeśli vehicle_label w wstrzykniętym rozwiązaniu nie odpowiada pojazdowi w żądaniu, odpowiednia trasa wraz z wizytami jest usuwana z rozwiązania. Jeśli shipment_label 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.

bool

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

bool

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

bool

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

bool

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.

bool

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 geodesic_meters_per_second.

string

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

double

Gdy use_geodesic_distances 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.

int32

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

ShipmentRoute

Trasy obliczone dla każdego pojazdu; i-ta trasa odpowiada i-temu pojazdowi w modelu.

string

Kopia OptimizeToursRequest.label, jeśli w żądaniu podano etykietę.

SkippedShipment

Lista wszystkich pominiętych przesyłek.

OptimizeToursValidationError

Lista wszystkich błędów weryfikacji, które udało nam się wykryć. Więcej informacji o komunikacie OptimizeToursValidationError znajdziesz w sekcji „WIELE BŁĘDÓW”. W przypadku wartości solving_mode DEFAULT_SOLVE zamiast błędów będą wyświetlane ostrzeżenia.

Metrics

Dane o czasie trwania, odległości i użytkowaniu tego rozwiązania.

AggregatedMetrics

Dane zbiorcze dotyczące tras. Każde dane to suma (lub wartość maksymalna w przypadku obciążeń) we wszystkich polach ShipmentRoute.metrics o tej samej nazwie.

int32

Liczba pominiętych przesyłek obowiązkowych.

int32

Liczba używanych pojazdów. Uwaga: jeśli trasa pojazdu jest pusta, a wartość atrybutu Vehicle.used_if_route_is_empty to Prawda, pojazd jest uważany za używany.

Timestamp

Najwcześniejszy czas rozpoczęcia używania pojazdu, obliczony jako minimalny dla wszystkich używanych pojazdów ShipmentRoute.vehicle_start_time.

Timestamp

Najpóźniejszy czas zakończenia dla używanego pojazdu, obliczony jako maksymalny dla wszystkich używanych pojazdów ShipmentRoute.vehicle_end_time.

map<string, double>

Koszt rozwiązania z podziałem według pól żądania związanych z kosztami. Klucze to ścieżki proto, odnoszące się do wejścia OptimizeToursRequest, np. „model.shipments.pickups.cost”, a wartości to łączny koszt wygenerowany przez odpowiednie pole kosztu, zsumowany w całym rozwiązaniu. Inaczej mówiąc, costs[„model.shipments.pickups.cost”] to suma wszystkich kosztów odbioru w ramach rozwiązania. Wszystkie koszty zdefiniowane w modelu są tutaj szczegółowo raportowane, z wyjątkiem kosztów związanych z atributem TransitionAttributes, które od 1 stycznia 2022 r. są raportowane tylko w sposób zagregowany.

double

Łączny koszt rozwiązania. Suma wszystkich wartości w mapie kosztów.

int32

Błąd weryfikacji jest zdefiniowany przez parę (code, display_name), która jest zawsze obecna.

Pola w sekcji po tej sekcji zawierają więcej informacji o błędzie.

WIELE BŁĘDÓW: gdy występuje wiele błędów, proces weryfikacji próbuje wygenerować kilka z nich. Podobnie jak w przypadku kompilatorów, jest to proces niedoskonały. Niektóre błędy weryfikacji będą „krytyczne”, co oznacza, że zatrzymają cały proces weryfikacji. Dotyczy to m.in. błędów display_name="UNSPECIFIED". Niektóre błędy mogą spowodować pominięcie innych błędów podczas procesu weryfikacji.

STABILNOŚĆ: code i display_name powinny być bardzo stabilne. Z czasem mogą jednak pojawić się nowe kody i nazwy wyświetlania, co może spowodować, że dana (nieprawidłowa) prośba zwróci inną parę (code, display_name), ponieważ nowy błąd zastąpi stary. Przykład: „WIELE BŁĘDÓW”.

string

Wyświetlana nazwa błędu.

FieldReference

Kontekst błędu może obejmować 0, 1 (najczęściej) lub więcej pól. Na przykład pierwszy odbiór pojazdu 4 w ramach dostawy 2 można wykonać w ten sposób:

fields { name: "vehicles" index: 4}
fields { name: "shipments" index: 2 sub_field {name: "pickups" index: 0} }

Pamiętaj jednak, że liczba elementów fields nie powinna się zmieniać w przypadku danego kodu błędu.

string

Zrozumiały dla człowieka ciąg tekstowy opisujący błąd. Wartości code i error_message są ze sobą powiązane 1:1 (gdy kod nie jest równy „UNSPECIFIED”).

STAŁOŚĆ: niestabilna: komunikat o błędzie powiązany z danym code może z czasem ulec zmianie (miejmy nadzieję, że na lepsze). Zamiast tego użyj zasad display_name i code.

string

Może zawierać wartości pól. Ta opcja nie jest zawsze dostępna. Nie należy się na niego w żaden sposób opierać. Należy go używać tylko do ręcznego debugowania modelu.

string

Nazwa pola, np. „vehicles”.

FieldReference

W razie potrzeby rekurencyjnie zagnieżdżone podpole.

int32

Indeks pola, jeśli jest powtarzany.

string

klucz, jeśli pole jest mapą;

DataFormat

Wymagane. Format danych wyjściowych.

GcsDestination

Lokalizacja w Google Cloud Storage, w której mają być zapisywane dane wyjściowe.

bool

Określa, czy w uzasadnionych przypadkach należy unikać dróg płatnych. Preferowane będą trasy nieobejmujące dróg płatnych. Dotyczy to tylko pojazdów mechanicznych.

bool

Określa, czy w uzasadnionych przypadkach ma być unikana jazda autostradami. Preferowane będą trasy nieobejmujące autostrad. Dotyczy to tylko pojazdów mechanicznych.

bool

Określa, czy w uzasadnionych przypadkach ma być unikana przeprawa promowa. Preferowane będą trasy nieobejmujące przejazdów promem. Dotyczy to tylko pojazdów mechanicznych.

bool

Opcjonalnie: Określa, czy w uzasadnionych przypadkach ma być unikana nawigacja wewnątrz budynków. Preferowane będą trasy nieobejmujące nawigacji wewnątrz budynków. Dotyczy tylko trybu podróży WALKING.

string

Zdefiniowana przez użytkownika nazwa wyświetlana przesyłki. Może on zawierać maksymalnie 63 znaki i znaki UTF-8.

VisitRequest

Zestaw alternatyw odbioru powiązanych z przesyłką. Jeśli nie określono inaczej, pojazd musi tylko odwiedzić lokalizację odpowiadającą dostawom.

VisitRequest

Zestaw alternatyw dostawy powiązanych z przesyłką. Jeśli nie wskażesz lokalizacji, pojazd musi tylko odwiedzić lokalizację odpowiadającą odbiorowi.

map<string, Load>

wymagania dotyczące ładunku (np. waga, objętość, liczba palet itp.); Klucze w mapie powinny być identyfikatorami, które opisują typ odpowiadającego im obciążenia. W idealnej sytuacji powinny też zawierać jednostki. Na przykład: „weight_kg”, „volume_gallons”, „pallet_count” itp. Jeśli dany klucz nie pojawia się na mapie, odpowiadający mu ładunek jest uważany za pusty.

int32

Zestaw pojazdów, które mogą wykonać tę dostawę. Jeśli pole jest puste, wszystkie pojazdy mogą je wykonać. Pojazdy są identyfikowane przez ich numer na liście ShipmentModel vehicles.

double

Określa koszt poniesiony podczas dostawy przesyłki przez dany pojazd. Jeśli jest podany, musi zawierać 1 z tych elementów:

• zawierać taką samą liczbę elementów jak costs_per_vehicle_indices. costs_per_vehicle[i] odpowiada pojazdowi costs_per_vehicle_indices[i] w przypadku modelu.
• taką samą liczbę elementów, jak pojazdów w modelu. I-ty element odpowiada pojazdowi o numerze i w danym modelu.

Te koszty muszą być wyrażone w tych samych jednostkach co penalty_cost i nie mogą być ujemne. Jeśli nie ma takich kosztów, pozostaw to pole puste.

int32

Indeksy pojazdów, do których ma zastosowanie costs_per_vehicle. Jeśli nie jest pusta, musi zawierać taką samą liczbę elementów jak costs_per_vehicle. Indeksu pojazdu nie można określić więcej niż raz. Jeśli pojazd jest wykluczony z costs_per_vehicle_indices, jego koszt wynosi 0.

Duration

Określa maksymalny bezwzględny czas objazdu w porównaniu z najkrótszą ścieżką od odbioru do dostawy. Jeśli jest podany, musi być dodatni, a przesyłka musi zawierać co najmniej odbiór i dostawę.

Niech na przykład t będzie najkrótszym czasem potrzebnym na dotarcie z wybranego miejsca odbioru bezpośrednio do wybranego miejsca dostawy. Ustawienie pickup_to_delivery_absolute_detour_limit powoduje:

start_time(delivery) - start_time(pickup) <=
t + pickup_to_delivery_absolute_detour_limit

Jeśli w przypadku jednej przesyłki są określone zarówno względne, jak i bezwzględne limity, w przypadku każdej możliwej pary odbioru/dostawy stosuje się bardziej restrykcyjny limit. Od października 2017 r. objazdy są obsługiwane tylko wtedy, gdy czas podróży nie zależy od pojazdu.

Duration

Określa maksymalny czas od rozpoczęcia odbioru do rozpoczęcia dostawy przesyłki. Jeśli jest podany, musi być dodatni, a przesyłka musi zawierać co najmniej odbiór i dostawę. Nie zależy to od tego, które opcje odbioru i dostawy są wybrane ani od prędkości pojazdu. Można je określić razem z ograniczeniami maksymalnego objazdu: rozwiązanie będzie uwzględniać obie specyfikacje.

string

Niepusty ciąg znaków określający „typ” przesyłki. Za pomocą tej funkcji można definiować niezgodności lub wymagania dotyczące shipment_types (patrz shipment_type_incompatibilities i shipment_type_requirements w ShipmentModel).

Różnica w porównaniu z visit_types, który jest określony dla pojedynczej wizyty: wszystkie odbiory i dostawy należące do tej samej przesyłki mają ten sam shipment_type.

string

Określa etykietę dla tej przesyłki. Ta etykieta jest raportowana w odpowiedzi w shipment_label odpowiedniego ShipmentRoute.Visit.

bool

Jeśli wartość to prawda, pomiń tę dostawę, ale nie stosuj penalty_cost.

Ignorowanie dostawy powoduje błąd weryfikacji, jeśli w modelu występują jakiekolwiek shipment_type_requirements.

Ignorowanie dostawy realizowanej w ramach injected_first_solution_routes lub injected_solution_constraint jest dozwolone; Solver usuwa powiązane wizyty odbioru/dostawy z trasy. precedence_rules, które odwołują się do ignorowanych przesyłek, również zostaną zignorowane.

double

Jeśli przesyłka nie zostanie dostarczona, ta kara zostanie dodana do łącznego kosztu tras. Przesyłka jest uważana za ukończoną, jeśli wybrano jedną z dostępnych opcji odbioru lub dostawy. Koszt może być wyrażony w tych samych jednostkach co wszystkie inne pola związane z kosztami w modelu i musi być dodatni.

WAŻNE: jeśli nie określisz tej kary, zostanie ona uznana za nieskończoną, co oznacza, że przesyłka musi zostać zrealizowana.

double

Określa maksymalny czas objazdu w porównaniu z najkrótszą ścieżką od odbioru do dostawy. Jeśli jest podany, musi być dodatni, a przesyłka musi zawierać co najmniej odbiór i dostawę.

Niech na przykład t będzie najkrótszym czasem potrzebnym na dotarcie z wybranego miejsca odbioru bezpośrednio do wybranego miejsca dostawy. Ustawienie pickup_to_delivery_relative_detour_limit powoduje:

start_time(delivery) - start_time(pickup) <=
std::ceil(t * (1.0 + pickup_to_delivery_relative_detour_limit))

Jeśli w przypadku jednej przesyłki są określone zarówno względne, jak i bezwzględne limity, w przypadku każdej możliwej pary odbioru/dostawy stosuje się bardziej restrykcyjny limit. Od października 2017 r. objazdy są obsługiwane tylko wtedy, gdy czas podróży nie zależy od pojazdów.

int64

Wartość, o którą będzie się zmieniać ładunek pojazdu podczas danej wizyty. Ponieważ jest to liczba całkowita, zalecamy wybranie odpowiedniej jednostki, aby uniknąć utraty dokładności. Wartość musi być większa lub równa 0.

LatLng

Geolokalizacja miejsca, do którego dociera pojazd podczas wykonywania tej VisitRequest. Jeśli model dostawy zawiera macierze odległości czasowej, nie można podać parametru arrival_location.

Waypoint

Punkt orientacyjny, w którym pojazd dociera podczas wykonywania tego VisitRequest. Jeśli model dostawy zawiera macierze odległości czasowej, nie można podać parametru arrival_waypoint.

LatLng

Miejsce docelowe, do którego pojazd ma dojechać po zakończeniu tego VisitRequest. Można go pominąć, jeśli jest taki sam jak arrival_location. Jeśli model dostawy zawiera macierze odległości czasowej, nie można podać parametru departure_location.

Waypoint

Punkt orientacyjny, w którym pojazd wyrusza po zakończeniu tego VisitRequest. Można go pominąć, jeśli jest taki sam jak arrival_waypoint. Jeśli model dostawy zawiera macierze odległości czasowej, nie należy podawać parametru departure_waypoint.

string

Określa tagi dołączone do żądania wizyty. Pustych lub powtarzających się ciągów znaków nie można stosować.

TimeWindow

Okna czasowe, które ograniczają czas przybycia podczas wizyty. Pamiętaj, że pojazd może wyjechać poza oknem czasowym przyjazdu, czyli czas przyjazdu + czas trwania nie musi mieścić się w oknie czasowym. Może to spowodować oczekiwanie, jeśli pojazd dotrze przed TimeWindow.start_time.

Brak TimeWindow oznacza, że pojazd może wykonać tę wizytę w dowolnym momencie.

Okna czasowe muszą być odseparowane, co oznacza, że żadne z nich nie może się pokrywać z innym ani być sąsiadować z innym. Okna czasowe muszą być uporządkowane według rosnącej kolejności.

Wartości cost_per_hour_after_soft_end_time i soft_end_time można ustawić tylko wtedy, gdy istnieje jedno okno czasowe.

Duration

Czas trwania wizyty, czyli czas spędzony przez pojazd między przybyciem a odejściem (dodawany do możliwego czasu oczekiwania; patrz time_windows).

double

Koszt realizacji tego żądania wizyty na trasie pojazdu. Można go używać do płacenia różnych kosztów za odbiór lub dostawę przesyłki. Koszt musi być wyrażony w tych samych jednostkach co Shipment.penalty_cost i nie może być ujemny.

map<string, Load>

Wczytaj wymagania dotyczące tego żądania wizyty. To pole jest podobne do pola Shipment.load_demands, z tym że ma zastosowanie tylko do tego elementu VisitRequest, a nie do całego elementu Shipment. Wymagania wymienione tutaj są dodawane do wymagań wymienionych w Shipment.load_demands.

string

Określa typy wizyt. Może ona służyć do przydzielenia dodatkowego czasu potrzebnego pojazdowi na wykonanie tej wizyty (patrz Vehicle.extra_visit_duration_for_visit_type).

Typ może wystąpić tylko raz.

string

Określa etykietę dla tego VisitRequest. Ta etykieta jest raportowana w odpowiedzi jako visit_label w odpowiednim ShipmentRoute.Visit.

Shipment

Zestaw dostaw, które muszą być wykonane w ramach modelu.

Vehicle

Zestaw pojazdów, których można używać do wykonywania wizyt.

Timestamp

Globalny czas rozpoczęcia i zakończenia modelu: nie można uznać za prawidłowego żadnego czasu spoza tego zakresu.

Zakres czasowy modelu musi być krótszy niż rok, czyli global_end_time i global_start_time muszą być oddalone od siebie o nie więcej niż 31536 000 sekund.

Jeśli używasz pól cost_per_*hour, możesz ustawić mniejszy przedział czasu, aby zwiększyć wydajność (np. jeśli modelujesz 1 dzień, ustaw globalne limity czasowe na ten dzień). Jeśli nie zostanie ona określona, domyślnie używana jest data 1 stycznia 1970 r., godzina 00:00:00 UTC (czyli sekundy: 0, nanosekundy: 0).

Timestamp

Jeśli nie zostanie ustawiona, domyślnie używana jest data 1 stycznia 1971 r., godzina 00:00:00 UTC (czyli 31536000 sekund, 0 nanosekund).

double

„Całkowity czas trwania” ogólnego planu to różnica między najwcześniejszym skutecznym czasem rozpoczęcia a najpóźniejszym skutecznym czasem zakończenia wszystkich pojazdów. Użytkownicy mogą przypisać do tej ilości koszt za godzinę, aby na przykład zoptymalizować zadanie pod kątem jak najszybszego ukończenia. Te koszty muszą być wyrażone w tych samych jednostkach co Shipment.penalty_cost.

DurationDistanceMatrix

Określa macierze czasu trwania i odległości używane w modelu. Jeśli to pole jest puste, zamiast niego używane są odległości na mapach Google lub geodezyjne, w zależności od wartości pola use_geodesic_distances. Jeśli pole nie jest puste, use_geodesic_distances nie może być prawdą, a pole duration_distance_matrix_src_tags ani duration_distance_matrix_dst_tags nie może być puste.

Przykłady użycia:

• Istnieją 2 lokalizacje: locA i locB.
• 1 pojazd, który rozpoczyna trasę w miejscu locA i kończy w miejscu locA.
• 1 prośba o odbiór w miejscu locB.

model {
  vehicles { start_tags: "locA"  end_tags: "locA" }
  shipments { pickups { tags: "locB" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_dst_tags: "locA"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrices {
    rows {  # from: locA
      durations { seconds: 0 }   meters: 0    # to: locA
      durations { seconds: 100 } meters: 1000 # to: locB
    }
    rows {  # from: locB
      durations { seconds: 102 } meters: 990 # to: locA
      durations { seconds: 0 }   meters: 0   # to: locB
    }
  }
}

• Istnieją 3 lokalizacje: locA, locB i locC.
• 1 pojazd zaczynający trasę w miejscu locA i kończący ją w miejscu locB, korzystając z macierzy „szybka”.
• 1 pojazd zaczynający swoją trasę w locB i kończący ją w locB, korzystając z matrycy „slow”.
• 1 pojazd zaczynający trasę w miejscu locB i kończący ją w miejscu locB, korzystając z macierzy „fast”.
• 1 prośba o odbiór w miejscu: locC.

model {
  vehicles { start_tags: "locA" end_tags: "locB" start_tags: "fast" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "slow" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "fast" }
  shipments { pickups { tags: "locC" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_src_tags: "locC"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrix_dst_tags: "locC"
  duration_distance_matrices {
    vehicle_start_tag: "fast"
    rows {  # from: locA
      durations { seconds: 1000 } meters: 2000 # to: locB
      durations { seconds: 600 }  meters: 1000 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }   meters: 0    # to: locB
      durations { seconds: 700 } meters: 1200 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 702 } meters: 1190 # to: locB
      durations { seconds: 0 }   meters: 0    # to: locC
    }
  }
  duration_distance_matrices {
    vehicle_start_tag: "slow"
    rows {  # from: locA
      durations { seconds: 1800 } meters: 2001 # to: locB
      durations { seconds: 900 }  meters: 1002 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }    meters: 0    # to: locB
      durations { seconds: 1000 } meters: 1202 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 1001 } meters: 1195 # to: locB
      durations { seconds: 0 }    meters: 0    # to: locC
    }
  }
}

string

Tagi określające źródła macierzy czasu trwania i odległości; duration_distance_matrices(i).rows(j) określa czas trwania i odległości od wizyt z tagiem duration_distance_matrix_src_tags(j) do innych wizyt w macierzy i.

Tagi odpowiadają elementom VisitRequest.tags lub Vehicle.start_tags. Podany identyfikator VisitRequest lub Vehicle musi odpowiadać dokładnie 1 tagowi w tym polu. Pamiętaj, że tagi źródła, miejsca docelowego i matriksu Vehicle mogą być takie same. Podobnie tagi źródła i miejsca docelowego VisitRequest mogą być takie same. Wszystkie tagi muszą być różne i nie mogą być pustymi ciągami znaków. Jeśli to pole nie jest puste, pole duration_distance_matrices nie może być puste.

string

Tagi określające miejsca docelowe macierzy czasu i odległości; duration_distance_matrices(i).rows(j).durations(k) (odpowiednio duration_distance_matrices(i).rows(j).meters(k)) określa czas trwania (odpowiednio odległość) podróży z wizytacji z tagiem duration_distance_matrix_src_tags(j) do wizytacji z tagiem duration_distance_matrix_dst_tags(k) w macierz i.

Tagi odpowiadają VisitRequest.tags lub Vehicle.start_tags. Podany identyfikator VisitRequest lub Vehicle musi odpowiadać dokładnie 1 tagowi w tym polu. Pamiętaj, że tagi źródła, miejsca docelowego i matriksu Vehicle mogą być takie same. Podobnie tagi źródła i miejsca docelowego VisitRequest mogą być takie same. Wszystkie tagi muszą być różne i nie mogą być pustymi ciągami znaków. Jeśli to pole nie jest puste, pole duration_distance_matrices nie może być puste.

TransitionAttributes

Dodano do modelu atrybuty przejścia.

ShipmentTypeIncompatibility

Zestawy niezgodnych typów dostawy (patrz ShipmentTypeIncompatibility).

ShipmentTypeRequirement

zestawy wymagań shipment_type (patrz ShipmentTypeRequirement).

PrecedenceRule

Zestaw reguł pierwszeństwa, które muszą być egzekwowane w modelu.

int32

Ogranicza maksymalną liczbę aktywnych pojazdów. Pojazd jest aktywny, jeśli jego trasa obejmuje co najmniej jedną dostawę. Można go użyć do ograniczenia liczby tras w przypadku, gdy kierowców jest mniej niż pojazdów, a flota pojazdów jest zróżnicowana. Następnie optymalizacja wybierze najlepszy podzbiór pojazdów do użycia. Musi być dodatni.

Row

Określa wiersze macierzy czasu trwania i odległości. Musi zawierać taką samą liczbę elementów jak ShipmentModel.duration_distance_matrix_src_tags.

string

Tag określający, do których pojazdów ma zastosowanie ta tablica czasu trwania i odległości. Jeśli jest pusty, ma zastosowanie do wszystkich pojazdów i może być tylko jedna matryca.

Każdy początek pojazdu musi odpowiadać dokładnie jednej macierzy, czyli dokładnie jedno z pol start_tags musi odpowiadać vehicle_start_tag macierzy (i tylko tej macierzy).

Wszystkie macierze muszą mieć inną wartość vehicle_start_tag.

Duration

Wartości czasu trwania w danym wierszu. Musi zawierać taką samą liczbę elementów jak ShipmentModel.duration_distance_matrix_dst_tags.

double

Wartości odległości w danym wierszu. Jeśli w modelu nie ma żadnych kosztów ani ograniczeń odnoszących się do odległości, można pozostawić to pole puste. W przeciwnym razie musi ono zawierać tyle elementów, co durations.

bool

Wskazuje, czy „pierwsze” zdarzenie to dostawa.

bool

Wskazuje, czy „drugie” zdarzenie to dostawa.

Duration

Odstęp między zdarzeniami „first” i „second”. Może być ujemna.

int32

Indeks dostawy „pierwszego” zdarzenia. To pole musi być określone.

int32

Indeks dostawy „drugiego” zdarzenia. To pole musi być określone.

int32

Pojazd wykonujący trasę, zidentyfikowany przez swój indeks w źródle ShipmentModel.

string

Etykieta pojazdu wykonującego tę trasę, równa ShipmentModel.vehicles(vehicle_index).label, jeśli została określona.

Timestamp

Czas rozpoczęcia przez pojazd trasy.

Timestamp

Czas, w którym pojazd kończy trasę.

Visit

Uporządkowana sekwencja wizyt reprezentująca trasę. visits[i] to i-ta wizyta na trasie. Jeśli to pole jest puste, pojazd jest uważany za nieużywany.

Transition

Uporządkowana lista przejść na trasie.

bool

Gdy OptimizeToursRequest.consider_road_traffic jest ustawione na wartość true, to pole wskazuje, że niezgodności w czasie trwania trasy są przewidywane na podstawie szacunków czasu przejazdu na podstawie natężenia ruchu. Może nie wystarczyć czasu na przebycie trasy z uwzględnieniem natężenia ruchu, opóźnień i przestojów między wizytami przed pierwszą wizytą lub po ostatniej, przy zachowaniu limitów czasu wizyty i czasu pracy pojazdu. Na przykład

  start_time(previous_visit) + duration(previous_visit) +
  travel_duration(previous_visit, next_visit) > start_time(next_visit)

Przybycie do next_visit nastąpi prawdopodobnie później niż w obecnym oknie czasowym z powodu wydłużenia szacowanego czasu podróży travel_duration(previous_visit, next_visit) z powodu korków. Przerwa może też nakładać się na wizytę z powodu wydłużenia szacowanego czasu podróży oraz ograniczeń dotyczących czasu wizyty lub przerwy.

EncodedPolyline

Zakodowana linia łamana reprezentująca trasę. To pole jest wypełniane tylko wtedy, gdy zasada OptimizeToursRequest.populate_polylines ma wartość Prawda.

Break

Przerwy zaplanowane dla pojazdu wykonującego tę trasę. Sekwencja breaks reprezentuje przedziały czasu, z których każdy zaczyna się w odpowiednim start_time i trwa duration sekund.

AggregatedMetrics

Dane dotyczące czasu trwania, odległości i obciążenia na tej trasie. Pola AggregatedMetrics są sumowane dla wszystkich elementów ShipmentRoute.transitions lub ShipmentRoute.visits, w zależności od kontekstu.

map<string, double>

Koszt trasy z podziałem na pola żądania związane z kosztami. Klucze to ścieżki proto, odnoszące się do wejścia OptimizeToursRequest, np. „model.shipments.pickups.cost”, a wartości to łączny koszt wygenerowany przez odpowiednie pole kosztu, zsumowany na całej trasie. Innymi słowy, costs["model.shipments.pickups.cost"] to suma wszystkich kosztów odbioru na trasie. Wszystkie koszty zdefiniowane w modelu są tutaj szczegółowo raportowane, z wyjątkiem kosztów związanych z atributem TransitionAttributes, które od 1 stycznia 2022 r. są raportowane tylko w postaci zagregowanej.

double

Łączny koszt trasy. Suma wszystkich kosztów na mapie kosztów.

Timestamp

Czas rozpoczęcia przerwy.

Duration

Czas trwania przerwy.

string

Ciąg znaków reprezentujący zakodowane punkty linii łamanej.

Duration

Czas trwania podróży podczas tej zmiany.

double

Odległość przebyta podczas przejścia.

bool

Gdy żądanie ruchu jest wysyłane za pomocą OptimizeToursRequest.consider_road_traffic, a nie udało się pobrać informacji o ruchu dla Transition, ta wartość logiczna jest ustawiana na Prawda. Może to być problem tymczasowy (rzadki problem na serwerach ruchu w czasie rzeczywistym) lub trwały (brak danych o tej lokalizacji).

Duration

Suma czasów opóźnienia zastosowanych do tego przejścia. Opóźnienie rozpoczyna się dokładnie delay_duration sekund przed następnym zdarzeniem (końcem wizyty lub pojazdu). Zobacz TransitionAttributes.delay.

Duration

Suma czasu trwania przerw, które wystąpiły podczas tego przejścia (jeśli wystąpiły). Szczegóły dotyczące czasu rozpoczęcia i długości przerwy są przechowywane w pliku ShipmentRoute.breaks.

Duration

Czas oczekiwania podczas tego przejścia. Czas oczekiwania odpowiada czasowi bezczynności i nie obejmuje przerwy. Pamiętaj też, że czas oczekiwania może być podzielony na kilka nieciągłych przedziałów.

Duration

Łączny czas trwania przejścia, podany dla wygody. Jest równe:

• następna wizyta start_time (lub vehicle_end_time, jeśli jest to ostatnia zmiana) – start_time tej zmiany;
• Jeśli ShipmentRoute.has_traffic_infeasibilities ma wartość fałsz, dodatkowo zachodzi zależność: `total_duration = travel_duration + delay_duration
• break_duration + wait_duration`.

Timestamp

Czas rozpoczęcia tego przejścia.

EncodedPolyline

Zakodowana linia łamana reprezentująca trasę przebytą podczas przemieszczania. To pole jest wypełniane tylko wtedy, gdy zasada populate_transition_polylines ma wartość Prawda.

string

Tylko dane wyjściowe. Nieprzezroczysty token, który można przekazać do Navigation SDK w celu odtworzenia trasy podczas nawigacji. W przypadku zmiany trasy token ten zachowuje pierwotny zamiar podczas tworzenia trasy. Traktuj ten token jako nieprzejrzysty blok danych. Nie porównuj wartości w różnych żądaniach, ponieważ może się ona zmieniać, nawet jeśli usługa zwróci dokładnie tę samą trasę. To pole jest wypełniane tylko wtedy, gdy zasada populate_transition_polylines ma wartość Prawda.

map<string, VehicleLoad>

Ładunki pojazdu w trakcie tego przejścia dla każdego typu, który pojawia się w Vehicle.load_limits pojazdu lub ma niezerową wartość Shipment.load_demands w przypadku jakiejś przesyłki zrealizowanej na tej trasie.

Obciążenia podczas pierwszego przejścia to obciążenia początkowe trasy pojazdu. Następnie po każdej wizycie wartości load_demands są dodawane lub odejmowane, aby uzyskać wartości ładunków dla następnego przejścia, w zależności od tego, czy wizyta była odbiorem czy dostawą.

int64

Ilość ładunku w danym pojeździe. Jednostka ładunku jest zwykle określana przez typ. Zobacz Transition.vehicle_loads.

int32

Indeks pola shipments w źródle ShipmentModel.

bool

Jeśli wartość to prawda, wizyta odpowiada odbiorowi Shipment. W przeciwnym razie odpowiada dostawie.

int32

Indeks VisitRequest w polu odbioru lub dostawy w Shipment (patrz is_pickup).

Timestamp

Czas rozpoczęcia wizyty. Pamiętaj, że pojazd może dotrzeć do miejsca wizyty wcześniej. Czasy są zgodne z ShipmentModel.

map<string, Load>

Łączna liczba wizyt, która jest sumą żądania dostawy i żądania wizyty load_demands. Jeśli wizyta to dostawa, wartości są ujemne. Zapotrzebowania są raportowane w przypadku tych samych typów co Transition.loads (patrz to pole).

Duration

Dodatkowy czas objazdu spowodowany wizytami w miejscach na trasie przed wizytą oraz potencjalny czas oczekiwania spowodowany oknami czasowymi. Jeśli wizyta to dostawa, objazd jest obliczany na podstawie odpowiedniej wizyty odbioru i jest równy:

start_time(delivery) - start_time(pickup)
- (duration(pickup) + travel duration from the pickup location
to the delivery location).

W przeciwnym razie jest obliczana na podstawie pojazdu start_location i jest równa:

start_time - vehicle_start_time - travel duration from
the vehicle's `start_location` to the visit.

string

Kopia odpowiedniej wartości Shipment.label, jeśli została ona określona w elementach Shipment.

string

Kopia odpowiedniej wartości VisitRequest.label, jeśli została ona określona w elementach VisitRequest.

string

Lista niezgodnych typów. 2 dostawy z różnymi wartościami shipment_types spośród wymienionych są „niezgodne”.

IncompatibilityMode

Tryb zastosowany do niezgodności.

string

Lista alternatywnych typów dostawy wymaganych przez dependent_shipment_types.

string

Wszystkie przesyłki z typem w polu dependent_shipment_types wymagają co najmniej 1 przesyłki typu required_shipment_type_alternatives, która ma być odwiedzona na tym samym szlaku.

UWAGA: łańcuchy wymagań, w których shipment_type zależy od siebie samego, są niedozwolone.

RequirementMode

Tryb zastosowany do wymagań.

int32

Indeks odpowiada indeksowi przesyłki w źródle ShipmentModel.

string

Kopia odpowiedniej wartości Shipment.label, jeśli została ona określona w elementach Shipment.

Reason

Lista powodów, dla których przesyłka została pominięta. Zobacz komentarz powyżej Reason. Jeśli nie będziemy w stanie ustalić, dlaczego przesyłka została pominięta, nie ustawimy przyczyn.

Code

Zapoznaj się z komentarzami w kodzie.

string

Jeśli kod powodu to DEMAND_EXCEEDS_VEHICLE_CAPACITY, dokumentuje jeden typ pojemności, który został przekroczony.

int32

Jeśli przyczyna dotyczy niezgodności przesyłki z pojazdem, to pole zawiera indeks odpowiedniego pojazdu.

Timestamp

Czas rozpoczęcia okna czasowego. Jeśli nie podasz żadnej wartości, zostanie użyta wartość ShipmentModel.global_start_time.

Timestamp

Czas zakończenia sztywnego przedziału czasu. Jeśli nie podasz żadnej wartości, zostanie użyta wartość ShipmentModel.global_end_time.

Timestamp

Czas rozpoczęcia przedziału czasu (miękki).

Timestamp

Czas zakończenia przedziału czasu (miękki).

double

Koszt na godzinę dodany do innych kosztów w modelu, jeśli zdarzenie występuje przed wartością soft_start_time, obliczany jako:

   max(0, soft_start_time - t.seconds)
                          * cost_per_hour_before_soft_start_time / 3600,
t being the time of the event.

Koszt musi być dodatni, a pole może być ustawione tylko wtedy, gdy ustawiono pole soft_start_time.

double

Koszt na godzinę dodany do innych kosztów w modelu, jeśli zdarzenie wystąpiło po soft_end_time, obliczany jako:

   max(0, t.seconds - soft_end_time.seconds)
                    * cost_per_hour_after_soft_end_time / 3600,
t being the time of the event.

Koszt musi być dodatni, a pole można ustawić tylko wtedy, gdy ustawiono soft_end_time.

string

Tagi definiujące zestaw przejść (src->dst), do których mają zastosowanie te atrybuty.

Odpowiednia wizyta w źródle lub uruchomienie pojazdu jest zgodne, jeśli pole VisitRequest.tags lub Vehicle.start_tags zawiera wartość src_tag lub nie zawiera wartości excluded_src_tag (w zależności od tego, które z tych pól jest niepuste).

string

Zobacz src_tag. Dokładnie jeden z pól src_tag i excluded_src_tag musi być niepusty.

string

Odpowiednio wizyta w miejscu docelowym lub koniec podróży pasażera jest zgodny, jeśli pole VisitRequest.tags lub Vehicle.end_tags zawiera wartość dst_tag lub nie zawiera wartości excluded_dst_tag (w zależności od tego, które z tych pól jest niepuste).

string

Zobacz dst_tag. Dokładnie jeden z pól dst_tag i excluded_dst_tag musi być niepusty.

double

Określa koszt wykonania tego przejścia. Jest on podawany w tych samych jednostkach co wszystkie inne koszty w modelu i nie może być ujemny. Jest ona naliczana dodatkowo do wszystkich innych kosztów.

double

Określa koszt na kilometr zastosowany do przebytej odległości podczas wykonywania tego przejścia. Dodaje się do wszystkich Vehicle.cost_per_kilometer określonych w pojazdach.

DistanceLimit

Określa limit pokonywanej odległości podczas wykonywania tego przejścia.

Od czerwca 2021 r. obsługiwane są tylko limity miękkie.

Duration

Określa opóźnienie powstałe podczas wykonywania tego przejścia.

To opóźnienie występuje zawsze po zakończeniu wizyty źródłowej i przed rozpoczęciem wizyty docelowej.

string

Zdefiniowana przez użytkownika nazwa wyświetlana pojazdu. Może on zawierać maksymalnie 63 znaki i może zawierać znaki UTF-8.

TravelMode

Tryb podróży, który wpływa na drogi dostępne dla pojazdu i jego prędkość. Zobacz też travel_duration_multiple.

RouteModifiers

Zbiór warunków, które należy spełnić, a które wpływają na sposób obliczania tras dla danego pojazdu.

LatLng

Geograficzna lokalizacja, w której pojazd rozpoczyna przejazd przed odbiorem przesyłek. Jeśli nie określisz inaczej, pojazd rozpoczyna kurs od pierwszego odbioru. Jeśli model dostawy zawiera macierze czasu i odległości, nie należy podawać parametru start_location.

Waypoint

Punkt drogi przedstawiający lokalizację geograficzną, w której pojazd rozpoczyna przejazd przed odbiorem przesyłek. Jeśli nie określono ani właściwości start_waypoint, ani start_location, pojazd rozpoczyna działanie od pierwszego odbioru. Jeśli model dostawy zawiera macierze czasu i odległości, nie można określić parametru start_waypoint.

LatLng

Miejsce geograficzne, w którym pojazd kończy ostatnią VisitRequest. Jeśli nie zostanie określony, ShipmentRoute pojazdu kończy się natychmiast po zakończeniu ostatniego VisitRequest. Jeśli model dostawy zawiera macierze czasu i odległości, nie można określić parametru end_location.

Waypoint

Punkt drogi reprezentujący lokalizację geograficzną, w której pojazd kończy ostatnią VisitRequest. Jeśli nie określisz ani end_waypoint, ani end_location, ShipmentRoute pojazdu kończy się natychmiast po zakończeniu ostatniego VisitRequest. Jeśli model dostawy zawiera macierze czasu i odległości, nie należy podawać parametru end_waypoint.

string

Określa tagi dołączone do początku trasy pojazdu.

Pustych lub powtarzających się ciągów znaków nie można używać.

string

Określa tagi dołączone na końcu trasy pojazdu.

Pustych lub powtarzających się ciągów znaków nie można stosować.

TimeWindow

Okna czasowe, w których pojazd może opuścić miejsce początkowe. Muszą mieścić się w globalnych limitach czasowych (patrz pola ShipmentModel.global_*). Jeśli nie określisz tu żadnej wartości, nie będzie limitów poza tymi globalnymi limitami czasowymi.

Przedziały czasu należące do tego samego powtarzającego się pola muszą być rozłączne, czyli żaden z nich nie może się pokrywać z innym ani być sąsiadować z innym. Muszą być uporządkowane chronologicznie.

Wartości cost_per_hour_after_soft_end_time i soft_end_time można ustawić tylko wtedy, gdy istnieje jedno okno czasowe.

TimeWindow

Okna czasowe, w których pojazd może dotrzeć do miejsca docelowego. Muszą mieścić się w globalnych limitach czasowych (patrz pola ShipmentModel.global_*). Jeśli nie określisz tu żadnej wartości, nie będzie limitów poza tymi globalnymi limitami czasowymi.

Przedziały czasu należące do tego samego powtarzającego się pola muszą być rozłączne, czyli żaden z nich nie może się pokrywać z innym ani być sąsiadować z innym. Muszą być uporządkowane chronologicznie.

Wartości cost_per_hour_after_soft_end_time i soft_end_time można ustawić tylko wtedy, gdy istnieje jedno okno czasowe.

UnloadingPolicy

Zasady rozładunku stosowane w pojazdach.

map<string, LoadLimit>

Pojemność pojazdu (np. waga, objętość, liczba palet). Klucze na mapie to identyfikatory typu wczytania zgodne z kluczami pola Shipment.load_demands. Jeśli dany klucz nie jest obecny na tej mapie, odpowiadająca mu pojemność jest uważana za nieograniczoną.

double

Koszty pojazdu: wszystkie koszty są sumowane i muszą być wyrażone w tej samej jednostce co Shipment.penalty_cost.

Koszt godziny przejazdu pojazdu. Koszt ten jest naliczany za cały czas trwania trasy, w tym czas podróży, oczekiwania i wizyty. Używanie operatora cost_per_hour zamiast samego cost_per_traveled_hour może spowodować wydłużenie czasu oczekiwania.

double

Koszt godziny przejazdu pojazdu. Ten koszt jest stosowany tylko do czasu przejazdu po trasie (czyli podanego w ShipmentRoute.transitions) i nie obejmuje czasu oczekiwania ani czasu wizyty.

double

Koszt przejechania 1 km trasy przez pojazd. Ten koszt jest stosowany do odległości podanej w ShipmentRoute.transitions i nie dotyczy odległości przebytej z arrival_location do departure_location w ramach jednego VisitRequest.

double

Stałe koszty stosowane, jeśli pojazd jest używany do obsługi przesyłki.

bool

To pole ma zastosowanie tylko do pojazdów, których trasa nie obsługuje żadnych przesyłek. Wskazuje, czy w tym przypadku pojazd powinien być uznany za używany.

Jeśli to ustawienie ma wartość true, pojazd jedzie z miejsca początkowego do miejsca docelowego, nawet jeśli nie obsługuje żadnych przesyłek. Uwzględniane są koszty czasu i odległości wynikające z przejazdu od początku do końca.

W przeciwnym razie pojazd nie przemieszcza się z punktu początkowego do końcowego i nie ma dla niego zaplanowanego break_rule ani opóźnienia (z TransitionAttributes). W takim przypadku ShipmentRoute pojazdu nie zawiera żadnych informacji oprócz indeksu i oznaczenia pojazdu.

DurationLimit

Limit zastosowany do łącznego czasu trwania trasy pojazdu. W danym OptimizeToursResponse czas trwania trasy pojazdu to różnica między jego vehicle_end_time a vehicle_start_time.

DurationLimit

Ograniczenie czasu trwania przejazdu na trasie pojazdu. W danym OptimizeToursResponse czas przejazdu trasy jest sumą wszystkich transitions.travel_duration.

DistanceLimit

Ograniczenie stosowane do całkowitej odległości przebytej przez pojazd. W danym OptimizeToursResponse odległość trasy jest sumą wszystkich transitions.travel_distance_meters.

map<string, Duration>

Określa mapę od ciągów znaków visit_types do czasów trwania. Czas trwania to czas dodatkowy do VisitRequest.duration, który należy uwzględnić w wizytach z określonym visit_types. Ten dodatkowy czas wizyty zwiększa koszty, jeśli ustawiono parametr cost_per_hour. Klucze (np. visit_types) nie mogą być pustymi ciągami znaków.

Jeśli prośba o wizytę ma kilka typów, na mapie zostanie dodany czas trwania dla każdego z nich.

BreakRule

Opisuje harmonogram przerw, który ma być stosowany w tym pojeździe. Jeśli pole jest puste, dla tego pojazdu nie będą planowane żadne przerwy.

string

Określa etykietę tego pojazdu. Ta etykieta jest raportowana w odpowiedzi jako vehicle_label odpowiadającego ShipmentRoute.

bool

Jeśli wartość used_if_route_is_empty ma być ustawiona na prawda, musisz ustawić wartość used_if_route_is_empty na fałsz, a samochód pozostanie nieużywany.

Jeśli przesyłka jest realizowana przez pojazd ignorowany w sekcji injected_first_solution_routes, jest pomijana w pierwszym rozwiązaniu, ale może być realizowana w odpowiedzi.

Jeśli dostawa jest realizowana przez pojazd ignorowany w injected_solution_constraint, a wszelkie powiązane odbiory/dostawy są ograniczone do pozostania w pojeździe (czyli nie są rozluźnione do poziomu RELAX_ALL_AFTER_THRESHOLD), są one pomijane w odpowiedzi. Jeśli przesyłka ma niepuste pole allowed_vehicle_indices, a wszystkie dozwolone pojazdy są ignorowane, jest ona pomijana w odpowiedzi.

double

Określa współczynnik mnożenia, który może być używany do zwiększania lub zmniejszania czasu przejazdu tego pojazdu. Ustawienie tej wartości na 2,0 oznacza, że pojazd jest wolniejszy i czas podróży jest dwukrotnie dłuższy niż w przypadku standardowych pojazdów. Ten współczynnik nie wpływa na długość wizyty. Wpływa na koszt, jeśli określono cost_per_hour lub cost_per_traveled_hour. Musi mieścić się w zakresie [0,001, 1000,0]. Jeśli nie zostanie ustawiony, pojazd jest standardowy, a wielokrotność jest uważana za 1,0.

OSTRZEŻENIE: czasy przejazdu zostaną zaokrąglone do najbliższej sekundy po zastosowaniu tego wielokrotnego, ale przed wykonaniem jakichkolwiek operacji numerycznych, dlatego małe wielokrotne może spowodować utratę dokładności.

Zobacz też extra_visit_duration_for_visit_type poniżej.

Duration

Stały limit ograniczający czas trwania do max_duration.

Duration

miękki limit, który nie narzuca maksymalnego czasu trwania, ale w przypadku jego naruszenia powoduje powstanie kosztu trasy; Ten koszt jest sumowany z innymi kosztami zdefiniowanymi w modelu, przy użyciu tej samej jednostki.

Jeśli jest zdefiniowana, wartość soft_max_duration musi być nieujemna. Jeśli zdefiniowano też parametr max_duration, wartość soft_max_duration musi być mniejsza niż max_duration.

Duration

Miękki limit, który nie narzuca maksymalnego czasu trwania, ale w przypadku jego przekroczenia powoduje, że trasa powoduje koszt proporcjonalny do kwadratu czasu. Ten koszt jest sumowany z innymi kosztami zdefiniowanymi w modelu, przy użyciu tej samej jednostki.

Jeśli jest zdefiniowana, wartość quadratic_soft_max_duration musi być nieujemna. Jeśli zdefiniowana jest też wartość max_duration, wartość quadratic_soft_max_duration musi być mniejsza od wartości max_duration, a różnica nie może być większa niż jeden dzień:

max_duration - quadratic_soft_max_duration <= 86400 seconds

double

Koszt na godzinę, jeśli zostanie przekroczony próg soft_max_duration. Jeśli czas trwania jest poniżej progu, dodatkowy koszt wynosi 0. W innych przypadkach koszt zależy od czasu trwania w następujący sposób:

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

Koszt musi być nieujemny.

double

Koszt za godzinę kwadratową, który jest naliczany, gdy przekroczony zostanie próg quadratic_soft_max_duration.

Jeśli czas trwania jest poniżej progu, dodatkowy koszt wynosi 0. W innych przypadkach koszt zależy od czasu trwania w następujący sposób:

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

Koszt musi być nieujemny.

int64

Miękki limit obciążenia. Zobacz cost_per_unit_above_soft_max.

double

Jeśli ładunek przekroczy wartość soft_max_load na trasie tego pojazdu, zostanie zastosowana następująca kara za koszty (tylko raz na pojazd): (load - soft_max_load) * cost_per_unit_above_soft_max. Wszystkie koszty są sumowane i muszą być wyrażone w tej samej jednostce co Shipment.penalty_cost.

Interval

Dopuszczalny przedział ładowania pojazdu na początku trasy.

Interval

Dopuszczalny przedział ładowania pojazdu na końcu trasy.

int64

Maksymalny dopuszczalny ładunek.

int64

minimalny dopuszczalny ładunek; Wartość musi być większa lub równa 0. Jeśli oba parametry są określone, wartość min musi być mniejsza lub równa wartości max.

int64

Maksymalny dopuszczalny ładunek. Wartość musi być większa lub równa 0. Jeśli nie podasz maksymalnego obciążenia, wiadomość nie będzie nakładać żadnych ograniczeń. Jeśli oba parametry są określone, wartość min musi być mniejsza lub równa wartości max.

bool

Opcjonalnie: Wskazuje, że lokalizacja tego punktu kontrolnego ma być preferowaną lokalizacją dla pojazdu, aby zatrzymał się on po konkretnej stronie drogi. Gdy ustawisz tę wartość, trasa będzie przebiegać przez lokalizację, aby pojazd mógł się zatrzymać po tej stronie drogi, po której znajduje się ta lokalizacja, z dala od środka jezdni. Ta opcja nie działa w przypadku trybu „Chodzenie”.

Location

Punkt określony za pomocą współrzędnych geograficznych, w tym opcjonalnego nagłówka.

string

Identyfikator miejsca docelowego powiązany z punktem drogi.