Package google.maps.routeoptimization.v1

int32

Liczba zrealizowanych przesyłek. Pamiętaj, że para odbioru i dostawy jest liczona tylko raz.

Duration

Całkowity czas podróży na trasie lub w przypadku 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 trwania przerw na trasie lub w rozwiązaniu.

Duration

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

Duration

Całkowity czas trwania powinien być równy sumie wszystkich powyższych czasów trwania. W przypadku tras odpowiada 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ść podróży na trasie lub w rozwiązaniu.

map<string, VehicleLoad>

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

int32

Liczba zrealizowanych przesyłek obowiązkowych.

Eksperymentalne: działanie lub istnienie tego pola może się w przyszłości zmienić.

double

Suma Shipment.penalty_cost zrealizowanych przesyłek.

Eksperymentalne: działanie lub istnienie tego pola może się w przyszłości zmienić.

string

Wymagane. Projekt docelowy i lokalizacja, z której chcesz zadzwonić.

Format:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

Jeśli nie podasz lokalizacji, region zostanie wybrany automatycznie.

AsyncModelConfig

Wymagane. Informacje o wejściu/wyjściu 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 docelowej lokalizacji wyjściowej.

BreakRequest

Kolejność przerw. Zobacz komunikat BreakRequest.

FrequencyConstraint

Może obowiązywać kilka FrequencyConstraint. Wszystkie te warunki muszą zostać spełnione do BreakRequest BreakRule. Zobacz FrequencyConstraint.

Timestamp

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

Timestamp

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

Duration

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

Duration

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

Duration

Wymagane. Maksymalny dozwolony czas trwania dowolnego przedziału czasu na trasie, który nie obejmuje co najmniej częściowo przerwy trwającej duration >= min_break_duration. Musi być dodatnia.

int64

Limit bezwzględny ograniczający odległość do maksymalnie max_meters. Limit nie może być liczbą ujemną.

int64

Miękki limit, który nie wymusza maksymalnej odległości, ale w przypadku przekroczenia powoduje naliczenie kosztu, który jest dodawany do innych kosztów zdefiniowanych w modelu, w tej samej jednostce.

Jeśli zdefiniowano parametr soft_max_meters, musi on być mniejszy niż max_meters i nie może być ujemny.

double

Koszt na kilometr, który wzrasta do soft_max_meters, obliczany według wzoru:

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

Ten koszt nie jest obsługiwany w regionie route_distance_limit.

double

Koszt za kilometr, jeśli odległość przekracza limit soft_max_meters. Jeśli odległość jest mniejsza niż limit, 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

Drogi podania roztworu. Niektóre trasy mogą zostać pominięte w oryginalnym rozwiązaniu. Trasy i pominięte przesyłki muszą spełniać podstawowe założenia dotyczące ważności wymienione w przypadku injected_first_solution_routes.

SkippedShipment

Pominięte dostawy rozwiązania do wstrzyknięcia. Niektóre mogą zostać pominięte w oryginalnym rozwiązaniu. Sprawdź pole routes.

ConstraintRelaxation

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

Relaxation

Wszystkie złagodzenia ograniczeń wizyt, które będą miały zastosowanie do wizyt na trasach z pojazdami w vehicle_indices.

int32

Określa indeksy pojazdów, do których ma zastosowanie ograniczenie wizyty relaxations. Jeśli to pole jest puste, jest to wartość domyślna, a relaxations mają zastosowanie do wszystkich pojazdów, które nie są określone w innych constraint_relaxations. Może być co najwyżej 1 wartość domyślna, czyli co najwyżej 1 pole ograniczenia może być puste vehicle_indices. Indeks pojazdów 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 złagodzenia ograniczeń, który obowiązuje, gdy warunki w momencie threshold_time ORAZ co najmniej threshold_visit_count są spełnione.

Timestamp

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

int32

Liczba wizyt, po której lub w przypadku której może zostać zastosowane złagodzenie level. Jeśli wartość threshold_visit_count wynosi 0 (lub nie jest ustawiona), level może zostać zastosowany bezpośrednio po uruchomieniu pojazdu.

Jeśli jest to route.visits_size() + 1, level można zastosować tylko do końca 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 pośredniego.

int32

Kierunek na kompasie powiązany z kierunkiem ruchu. Ta wartość służy do określania strony drogi, z której ma nastąpić odbiór lub na której ma nastąpić wysadzenie. Wartości kierunku mogą wynosić od 0 do 360, gdzie 0 oznacza kierunek północny, 90 – wschodni itd.

string

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

Format:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

Jeśli nie podasz lokalizacji, region zostanie wybrany automatycznie.

Duration

Jeśli ten czas oczekiwania jest ustawiony, serwer zwraca odpowiedź przed upływem czasu oczekiwania 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.

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

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

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

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

• W przypadku wszystkich tras wartość vehicle_index musi mieścić się w zakresie i nie może być zduplikowana.
• W przypadku wszystkich wizyt wartości shipment_index i visit_request_index 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 (tzn. vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time).
• 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 vehicle_index 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ść.

InjectedSolutionConstraint

Ogranicz algorytm optymalizacji, aby znaleźć rozwiązanie końcowe podobne do poprzedniego. Może to być na przykład przydatne do zamrażania części tras, które zostały już ukończone lub 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ść.

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ść populate_polylines była ustawiona na „prawda”.

Pola route_polyline przekazanych tras mogą być niespójne z trasą transitions.

Tego pola nie można używać razem z polami injected_first_solution_routes ani injected_solution_constraint.

Zasady Shipment.ignore i Vehicle.ignore nie mają wpływu na to zachowanie. 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.

bool

Jeśli ma wartość prawda:

• używa ShipmentRoute.vehicle_label zamiast vehicle_index, aby dopasować trasy w wstrzykniętym rozwiązaniu do pojazdów w żądaniu; ponownie wykorzystuje mapowanie pierwotnego ShipmentRoute.vehicle_index na nowe ShipmentRoute.vehicle_index, aby zaktualizować ConstraintRelaxation.vehicle_indices, jeśli nie jest puste, ale mapowanie musi być jednoznaczne (tzn. wiele ShipmentRoute nie może współdzielić tego samego pierwotnego vehicle_index).
• używa symbolu ShipmentRoute.Visit.shipment_label zamiast shipment_index, aby dopasować wizyty w rozwiązaniu wstrzykiwanym do dostaw 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 injected_first_solution_routes, injected_solution_constraint i refresh_details_routes. Może być używany, 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 ma wartość true, etykiety w tych kategoriach mogą pojawiać się w swojej kategorii co najwyżej raz:

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

Jeśli vehicle_label w wstrzykniętym rozwiązaniu nie odpowiada pojazdowi z prośby, odpowiednia trasa jest usuwana z rozwiązania wraz z wizytami. Jeśli shipment_label w rozwiązaniu nie odpowiada przesyłce z żądaniem, odpowiednia wizyta jest usuwana z rozwiązania. Jeśli SkippedShipment.label w wstrzykniętym rozwiązaniu nie odpowiada przesyłce z prośbą, SkippedShipment jest usuwany z rozwiązania.

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żliwość jego zastosowania.

UWAGA: dzwoniący musi zapewnić, że każdy Vehicle.label (odpowiednio Shipment.label) jednoznacznie identyfikuje pojazd (lub przesyłkę) 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 unikalności nie wystarczą, aby zagwarantować spełnienie tego wymagania.

bool

W obliczeniach pól ShipmentRoute, Transition.travel_duration, Visit.start_time i vehicle_end_time, w ustawianiu pola ShipmentRoute.has_traffic_infeasibilities oraz w obliczeniach pola OptimizeToursResponse.total_cost uwzględniaj szacunkową liczbę wizyt.

bool

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

bool

Jeśli ma wartość true, w odpowiedzi ShipmentRoute.transitions będą wypełnione polilinie i tokeny trasy.

bool

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

bool

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

string

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

double

Jeśli wartość use_geodesic_distances to „true”, to pole musi być ustawione i określa szybkość stosowaną do obliczania czasu podróży. Jej wartość musi wynosić co najmniej 1,0 m/s.

int32

Obcina liczbę zwracanych 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 solving_mode=VALIDATE_ONLY: patrz pole OptimizeToursResponse.validation_errors. Domyślna wartość to 100,a maksymalna to 10 000.

ShipmentRoute

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

string

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

SkippedShipment

Lista wszystkich pominiętych przesyłek.

OptimizeToursValidationError

Lista wszystkich błędów weryfikacji, które udało nam się wykryć niezależnie. Wyjaśnienie komunikatu OptimizeToursValidationError znajdziesz w sekcji „MULTIPLE ERRORS”. Zamiast błędów będą tu uwzględniane ostrzeżenia, jeśli solving_mode ma wartość DEFAULT_SOLVE.

OptimizeToursRequest

W niektórych przypadkach modyfikujemy przychodzące żądanie przed jego rozwiązaniem, np. dodając koszty. Jeśli solving_mode == TRANSFORM_AND_RETURN_REQUEST, zmodyfikowane żądanie jest zwracane tutaj.

Eksperymentalne: więcej informacji znajdziesz na stronie https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request.

Metrics

Czas trwania, odległość i statystyki użytkowania tego rozwiązania.

AggregatedMetrics

Zagregowane na trasach. Każda wartość to suma (lub maksymalna wartość w przypadku wczytań) wszystkich pól ShipmentRoute.metrics o tej samej nazwie.

int32

Liczba pominiętych obowiązkowych przesyłek.

int32

Liczba używanych pojazdów. Uwaga: jeśli trasa pojazdu jest pusta, a wartość Vehicle.used_if_route_is_empty to „prawda”, pojazd jest uznawany za używany.

Timestamp

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

Timestamp

Najpóźniejsza godzina zakończenia dla używanego pojazdu, obliczona jako maksimum ze wszystkich używanych pojazdów ShipmentRoute.vehicle_end_time.

map<string, double>

Koszt rozwiązania podzielony według pól żądań związanych z kosztami. Kluczami są ścieżki protokołu, względne w stosunku do wejściowego OptimizeToursRequest, np. „model.shipments.pickups.cost”, a wartościami są łączne koszty wygenerowane przez odpowiednie pole kosztu, zagregowane 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ą tu szczegółowo raportowane, z wyjątkiem kosztów związanych z atrybutami przejścia, które od 2022 r. są raportowane tylko w formie zagregowanej.

double

Całkowity koszt rozwiązania. Suma wszystkich wartości na mapie kosztów.

string

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

Format:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

Jeśli nie podasz lokalizacji, region zostanie wybrany automatycznie.

Uri

Wymagane. Identyfikator URI obiektu Cloud Storage zawierającego OptimizeToursRequest.

Uri

Wymagane. Identyfikator URI obiektu Cloud Storage, który będzie zawierać OptimizeToursResponse.

Uri

Opcjonalnie: Identyfikator URI obiektu Cloud Storage zawierającego OptimizeToursResponse zakodowany jako JSON lub textproto. Jeśli obiekt został zakodowany jako JSON, rozszerzenie nazwy obiektu będzie miało postać .json. Jeśli obiekt został zakodowany jako textproto, rozszerzenie nazwy obiektu będzie miało postać .txtpb.

crc32_checksum zasobu można użyć do sprawdzenia, czy zawartość zasobu nie została zmodyfikowana.

int32

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

Pola w sekcji poniżej zawierają więcej informacji o błędzie.

MULTIPLE ERRORS: jeśli występuje wiele błędów, proces weryfikacji próbuje wyświetlić kilka z nich. Podobnie jak w przypadku kompilatora 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ą powodować pomijanie innych błędów w procesie weryfikacji.

STABILNOŚĆ: wartości code i display_name powinny być bardzo stabilne. Z czasem mogą jednak pojawić się nowe kody i nazwy wyświetlane, co może spowodować, że dane (nieprawidłowe) żądanie zwróci inną parę (code, display_name), ponieważ nowy błąd ukrył stary. Na przykład zobacz sekcję „WIELOKROTNE BŁĘDY”.

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 odniesienie się do pierwszego odbioru pojazdu 4 i dostawy 2 może wyglądać tak:

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

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

string

Zrozumiały dla człowieka ciąg tekstowy opisujący błąd. Istnieje mapowanie 1:1 między code a error_message (gdy kod != „UNSPECIFIED”).

STABILNOŚĆ: niestabilna: komunikat o błędzie powiązany z danym code może się z czasem zmienić (mamy nadzieję, że na bardziej zrozumiały). Zamiast tego polegaj na zasadach display_name i code.

string

Może zawierać wartości pól. Nie zawsze jest to możliwe. Nie należy na nim polegać i należy go używać tylko do ręcznego debugowania modelu.

string

Nazwa pola, np. „vehicles”.

FieldReference

W razie potrzeby zagnieżdżone rekurencyjnie pole podrzędne.

int32

Indeks pola, jeśli jest powtarzane.

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 rozsądnych przypadkach należy unikać dróg płatnych. Preferowane będą trasy bez dróg płatnych. Dotyczy to tylko zmotoryzowanych środków transportu.

bool

Określa, czy w miarę możliwości unikać autostrad. Preferowane będą trasy bez autostrad. Dotyczy to tylko zmotoryzowanych środków transportu.

bool

Określa, czy w miarę możliwości unikać promów. Preferowane będą trasy, które nie obejmują podróży promem. Dotyczy to tylko zmotoryzowanych środków transportu.

bool

Opcjonalnie: Określa, czy należy unikać nawigacji w pomieszczeniach, jeśli jest to możliwe. Priorytet będą miały trasy, które nie zawierają nawigacji w pomieszczeniach. Dotyczy to tylko trybu podróży WALKING.

string

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

VisitRequest

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

VisitRequest

Zestaw alternatywnych opcji dostawy powiązanych z przesyłką. Jeśli nie określono inaczej, pojazd musi tylko odwiedzić lokalizację odpowiadającą odbiorom.

map<string, Load>

Wymagania dotyczące załadunku (np. waga, objętość, liczba palet itp.). Klucze w mapie powinny być identyfikatorami opisującymi typ odpowiedniego obciążenia, najlepiej z uwzględnieniem jednostek. Na przykład: „weight_kg”, „volume_gallons”, „pallet_count” itp. Jeśli danego klucza nie ma na mapie, odpowiedni ładunek jest uznawany za pusty.

int32

Zestaw pojazdów, które mogą zrealizować tę dostawę. Jeśli to pole jest puste, wszystkie pojazdy mogą wykonać to działanie. Pojazdy są podawane według indeksu na liście ShipmentModelvehicles.

double

Określa koszt poniesiony w przypadku dostawy przesyłki każdym pojazdem. Jeśli jest określony, musi mieć JEDNĄ z tych wartości:

• taką samą liczbę elementów jak costs_per_vehicle_indices. costs_per_vehicle[i] odpowiada pojazdowi costs_per_vehicle_indices[i] w modelu.
• zawierać tyle samo elementów, ile jest pojazdów w modelu. i-ty element odpowiada pojazdowi nr i w modelu.

Koszty te muszą być podane w tej samej jednostce 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 odnosi się costs_per_vehicle. Jeśli nie jest puste, 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 zero.

Duration

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

Niech t będzie najkrótszym czasem potrzebnym na przejazd z wybranej alternatywnej lokalizacji odbioru bezpośrednio do wybranej alternatywnej lokalizacji dostawy. Następnie ustawienie pickup_to_delivery_absolute_detour_limit wymusza:

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

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

Duration

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

string

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

Różni się od 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ę przesyłki. Ta etykieta jest zgłaszana w odpowiedzi w polu shipment_label odpowiedniego obiektu ShipmentRoute.Visit.

bool

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

Zignorowanie dostawy powoduje błąd weryfikacji, jeśli w modelu znajdują się jakiekolwiek shipment_type_requirements.

Ignorowanie przesyłki realizowanej w injected_first_solution_routes lub injected_solution_constraint jest dozwolone. Rozwiązanie usuwa powiązane wizyty odbioru/dostawy z realizowanej trasy. precedence_rules, które odwołują się do zignorowanych przesyłek, również będą ignorowane.

double

Jeśli przesyłka nie zostanie zrealizowana, ta kara zostanie dodana do ogólnego kosztu tras. Przesyłka jest uznawana za zrealizowaną, jeśli odwiedzono jedną z jej alternatywnych lokalizacji odbioru lub dostawy. Koszt może być wyrażony w tej samej jednostce, która jest używana w przypadku wszystkich innych pól związanych z kosztami w modelu, i musi być dodatni.

WAŻNE: jeśli ta kara nie jest określona, uważa się ją za nieskończoną, tzn. dostawa musi zostać zrealizowana.

double

Określa maksymalny względny czas objazdu w porównaniu z najkrótszą trasą od miejsca odbioru do miejsca dostawy. Jeśli jest określony, musi być nieujemny, a przesyłka musi zawierać co najmniej odbiór i dostawę.

Niech t będzie najkrótszym czasem potrzebnym na przejazd z wybranej alternatywnej lokalizacji odbioru bezpośrednio do wybranej alternatywnej lokalizacji dostawy. Następnie ustawienie pickup_to_delivery_relative_detour_limit wymusza:

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

Jeśli w przypadku tej samej dostawy określono zarówno limity względne, jak i bezwzględne, w przypadku każdej możliwej pary odbioru/dostawy stosowany jest 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ę różnić obciążenie pojazdu podczas odpowiedniej wizyty. Jest to liczba całkowita, więc zalecamy użytkownikom wybranie odpowiedniej jednostki, aby uniknąć utraty precyzji. Wartość musi być ≥ 0.

LatLng

Lokalizacja geograficzna, do której pojazd dociera podczas wykonywania tej VisitRequest. Jeśli model dostawy zawiera macierze odległości i czasu trwania, nie można określić wartości arrival_location.

Waypoint

Punkt pośredni, do którego pojazd dociera podczas wykonywania tego VisitRequest. Jeśli model dostawy zawiera macierze odległości i czasu trwania, nie można określić wartości arrival_waypoint.

LatLng

Lokalizacja geograficzna, z której pojazd odjeżdża po zakończeniu tego VisitRequest. Można pominąć, jeśli jest taki sam jak arrival_location. Jeśli model dostawy zawiera macierze odległości i czasu trwania, nie można określić wartości departure_location.

Waypoint

Punkt pośredni, z którego pojazd odjeżdża po zakończeniu tego VisitRequest. Można pominąć, jeśli jest taki sam jak arrival_waypoint. Jeśli model dostawy zawiera macierze odległości i czasu trwania, nie można określić wartości departure_waypoint.

string

Określa tagi dołączone do żądania wizyty. Puste lub zduplikowane ciągi znaków są niedozwolone.

TimeWindow

Przedziały czasowe, które ograniczają czas przyjazdu do miejsca wizyty. Pamiętaj, że pojazd może odjechać poza przedziałem czasu przyjazdu, tzn. czas przyjazdu + czas trwania nie muszą mieścić się w przedziale czasu. Jeśli pojazd przyjedzie przed TimeWindow.start_time, może to spowodować czas oczekiwania.

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

Przedziały czasu muszą być rozłączne, tzn. żaden przedział czasu nie może nakładać się na inny ani z nim sąsiadować, a także muszą być podane w kolejności rosnącej.

Wartości cost_per_hour_after_soft_end_time i soft_end_time można ustawić tylko wtedy, gdy jest dostępne jedno okno czasowe.

Duration

Czas trwania wizyty, czyli czas spędzony przez pojazd między przyjazdem a odjazdem (do dodania do ewentualnego czasu oczekiwania; patrz time_windows).

double

Koszt obsługi tego żądania wizyty na trasie pojazdu. Możesz go użyć do zapłaty różnych kosztów za każdy alternatywny odbiór lub dostawę przesyłki. Koszt musi być podany w tej samej jednostce co Shipment.penalty_cost i nie może być ujemny.

map<string, Load>

Wczytaj wymagania tego żądania wizyty. Działa to tak samo jak pole Shipment.load_demands, z tym że dotyczy tylko tego VisitRequest, a nie całego Shipment. Wymagania wymienione tutaj są dodawane do wymagań wymienionych w Shipment.load_demands.

string

Określa typy wizyt. Może to służyć do przydzielenia dodatkowego czasu potrzebnego pojazdowi na ukończenie 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 zgłaszana w odpowiedzi jako visit_label w odpowiednim polu ShipmentRoute.Visit.

bool

Określa, czy na trasach dojazdu w tej lokalizacji należy unikać zawracania. Unikanie zawracania jest realizowane w miarę możliwości, ale nie gwarantujemy, że zawracanie zostanie całkowicie wyeliminowane. To funkcja eksperymentalna, a jej działanie może ulec zmianie.

Eksperymentalne: więcej informacji znajdziesz na stronie https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request.

Shipment

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

Vehicle

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

Objective

Zbiór celów dla tego modelu, które przekształcimy w koszty. Jeśli model wejściowy nie jest pusty, musi być bezpłatny. Aby uzyskać zmodyfikowane żądanie, użyj funkcji solving_mode = TRANSFORM_AND_RETURN_REQUEST. Pamiętaj, że w takim przypadku zgłoszenie nie zostanie rozwiązane. Zobacz odpowiednią dokumentację.

Eksperymentalne: więcej informacji znajdziesz na stronie https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request.

Timestamp

Globalny czas rozpoczęcia i zakończenia modelu: żadne czasy poza tym zakresem nie mogą być uznane za prawidłowe.

Okres, którego dotyczy model, musi być krótszy niż rok, tzn. wartości global_end_time i global_start_time muszą różnić się od siebie o mniej niż 31 536 000 sekund.

Jeśli używasz pól cost_per_*hour, możesz ustawić mniejszy przedział, aby zwiększyć skuteczność (np. jeśli modelujesz jeden dzień, ustaw globalne limity czasu na ten dzień). Jeśli nie zostanie ustawiona, 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 określona, domyślnie używana jest data 1 stycznia 1971 r., godzina 00:00:00 UTC (czyli sekundy: 31536000, nanosekundy: 0).

double

„Globalny czas trwania” całego planu to różnica między najwcześniejszą godziną rozpoczęcia a najpóźniejszą godziną zakończenia wszystkich pojazdów. Użytkownicy mogą przypisać do tej ilości koszt za godzinę, aby na przykład zoptymalizować czas ukończenia zadania. Koszt musi być podany w tej samej jednostce co Shipment.penalty_cost.

DurationDistanceMatrix

Określa macierze czasu trwania i odległości używane w modelu. Jeśli to pole jest puste, używane są odległości w Mapach Google lub odległości geodezyjne, w zależności od wartości pola use_geodesic_distances. Jeśli nie jest pusta, use_geodesic_distances nie może mieć wartości „true”, a pola duration_distance_matrix_src_tags i duration_distance_matrix_dst_tags nie mogą być puste.

Przykłady użycia:

• Są 2 lokalizacje: locA i locB.
• 1 pojazd rozpoczynający i kończący trasę w lokalizacji A.
• 1 prośba o odwiedzenie punktu odbioru w lokalizacji B.

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
    }
  }
}

• Są 3 lokalizacje: locA, locB i locC.
• 1 pojazd rozpoczynający trasę w lokalizacji A i kończący ją w lokalizacji B, korzystający z macierzy „fast”.
• 1 pojazd rozpoczynający trasę w lokalizacji B i kończący ją w lokalizacji B, korzystający z macierzy „wolno”.
• 1 pojazd rozpoczynający trasę w lokalizacji B i kończący ją w lokalizacji B, korzystający z macierzy „fast”.
• 1 prośba o odwiedzenie punktu odbioru w lokalizacji C.

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ą polom VisitRequest.tags lub Vehicle.start_tags. Dany element VisitRequest lub Vehicle musi być zgodny z dokładnie jednym tagiem w tym polu. Pamiętaj, że tagi źródła, miejsca docelowego i macierzy w przypadku Vehicle mogą być takie same. Podobnie tagi źródła i miejsca docelowego w przypadku 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 trwania 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 od wizyt z tagiem duration_distance_matrix_src_tags(j) do wizyt z tagiem duration_distance_matrix_dst_tags(k) w macierzy i.

Tagi odpowiadają polom VisitRequest.tags lub Vehicle.start_tags. Dany element VisitRequest lub Vehicle musi być zgodny z dokładnie jednym tagiem w tym polu. Pamiętaj, że tagi źródła, miejsca docelowego i macierzy w przypadku Vehicle mogą być takie same. Podobnie tagi źródła i miejsca docelowego w przypadku 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

Atrybuty przejścia dodane do modelu.

ShipmentTypeIncompatibility

Zestawy niezgodnych typów dostawy (patrz ShipmentTypeIncompatibility).

ShipmentTypeRequirement

Zestawy shipment_type wymagań (patrz ShipmentTypeRequirement).

PrecedenceRule

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

WAŻNE: używanie reguł pierwszeństwa ogranicza rozmiar problemu, który można zoptymalizować. Żądania korzystające z reguł pierwszeństwa, które obejmują wiele przesyłek, mogą zostać odrzucone.

int32

Ogranicza maksymalną liczbę aktywnych pojazdów. Pojazd jest aktywny, jeśli na jego trasie zrealizowano co najmniej 1 dostawę. Może to służyć do ograniczenia liczby tras w przypadku, gdy liczba kierowców jest mniejsza niż liczba pojazdów, a flota pojazdów jest niejednorodna. Optymalizacja wybierze wtedy najlepszy podzbiór pojazdów do wykorzystania. Musi być ściśle dodatnia.

Row

Określa wiersze macierzy czasu trwania i odległości. Musi zawierać tyle elementów, ile pole ShipmentModel.duration_distance_matrix_src_tags.

string

Tag określający, do których pojazdów odnosi się ta macierz czasu trwania i odległości. Jeśli to pole jest puste, dotyczy wszystkich pojazdów i może zawierać tylko jedną macierz.

Każdy początek podróży pojazdu musi pasować do dokładnie jednej macierzy, tzn. dokładnie jedno pole start_tags musi pasować do pola vehicle_start_tag macierzy (i tylko tej macierzy).

Wszystkie macierze muszą mieć inne wartości vehicle_start_tag.

Duration

Wartości czasu trwania w danym wierszu. Musi zawierać tyle elementów, ile pole ShipmentModel.duration_distance_matrix_dst_tags.

double

Wartości odległości dla danego wiersza. Jeśli w modelu nie ma kosztów ani ograniczeń związanych z odległościami, to pole może pozostać puste. W przeciwnym razie musi zawierać tyle elementów, ile wynosi wartość durations.

Type

Typ celu.

double

Jak bardzo ten cel powinien się liczyć w porównaniu z innymi. Może to być dowolna liczba nieujemna. Wagi nie muszą sumować się do 1. Wagi domyślnie wynoszą 1,0.

bool

Wskazuje, czy zdarzenie „first” jest dostawą.

bool

Wskazuje, czy „drugie” zdarzenie to dostawa.

Duration

Przesunięcie między zdarzeniem „pierwszym” a „drugim”. Może być ujemna.

int32

Indeks przesyłki „pierwszego” zdarzenia. To pole musi być określone.

int32

Indeks przesyłki „drugiego” zdarzenia. To pole musi być określone.

int32

Pojazd realizujący trasę, zidentyfikowany przez 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

Godzina rozpoczęcia trasy przez pojazd.

Timestamp

Godzina, o której 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 uznawany za nieużywany.

Transition

Uporządkowana lista przejść na trasie.

bool

Gdy wartość OptimizeToursRequest.consider_road_traffic jest ustawiona na „true”, to pole wskazuje, że niespójności w czasach przejazdu są przewidywane na podstawie szacunków czasu podróży opartych na ruchu. Może nie być wystarczająco dużo czasu na uwzględnienie podróży z uwzględnieniem natężenia ruchu, opóźnień i przerw między wizytami, przed pierwszą wizytą lub po ostatniej wizycie, przy jednoczesnym spełnieniu przedziałów czasowych wizyt i pojazdów. Na przykład

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

Przyjazd do next_visit prawdopodobnie nastąpi później niż w obecnym przedziale czasowym ze względu na zwiększone szacunkowe natężenie ruchu travel_duration(previous_visit, next_visit). Przerwa może też zostać wymuszona, aby pokrywała się z wizytą, z powodu wzrostu szacowanego czasu dojazdu i 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 obsługującego tę trasę. Ciąg breaks reprezentuje przedziały czasu, z których każdy zaczyna się w odpowiednim momencie 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 we wszystkich ShipmentRoute.transitions lub ShipmentRoute.visits w zależności od kontekstu.

VehicleFullness

VehicleFullness do obliczania, jak blisko są ograniczone dane od odpowiednich limitów pojazdu. Jego pola to stosunki między polem danych objętych limitem (np. AggregatedMetrics.travel_distance_meters) a powiązanym limitem pojazdu (np. Vehicle.route_distance_limit).

Eksperymentalne: działanie lub istnienie tego pola może się w przyszłości zmienić.

map<string, double>

Koszt trasy z podziałem na pola żądania związane z kosztami. Kluczami są ścieżki protokołu, względne w stosunku do wejściowego żądania OptimizeToursRequest, np. „model.shipments.pickups.cost”, a wartościami są łączne koszty wygenerowane przez odpowiednie pole kosztu, zagregowane 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ą tu szczegółowo raportowane, z wyjątkiem kosztów związanych z atrybutami przejścia, które od 2022 r. są raportowane tylko w formie zagregowanej.

double

Całkowity 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ść pokonana podczas przejścia.

bool

Gdy ruch jest żądany za pomocą OptimizeToursRequest.consider_road_traffic, a informacji o ruchu nie można pobrać dla Transition, ta wartość logiczna jest ustawiona na „true”. Może to być problem tymczasowy (rzadkie zakłócenie działania serwerów ruchu w czasie rzeczywistym) lub trwały (brak danych o tej lokalizacji).

Duration

Suma opóźnień zastosowanych w tym przejściu. Opóźnienie, jeśli występuje, zaczyna się dokładnie delay_duration sekundy przed następnym zdarzeniem (wizytą lub zakończeniem przejazdu pojazdu). Zobacz TransitionAttributes.delay.

Duration

Suma czasu trwania przerw występujących podczas tego przejścia (jeśli występują). Szczegóły dotyczące godziny rozpoczęcia i czasu trwania każdej przerwy są przechowywane w ShipmentRoute.breaks.

Duration

Czas oczekiwania podczas tego przejścia. Czas oczekiwania odpowiada czasowi bezczynności i nie obejmuje czasu 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 ona równa:

• następna wizyta start_time (lub vehicle_end_time, jeśli jest to ostatnia zmiana) – start_time tej zmiany;
• jeśli wartość ShipmentRoute.has_traffic_infeasibilities to „false”, dodatkowo obowiązuje to równanie: `total_duration = travel_duration + delay_duration
• break_duration + wait_duration`.

Timestamp

Czas rozpoczęcia tej zmiany.

EncodedPolyline

Zakodowana linia łamana reprezentująca trasę pokonaną podczas przejścia. 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, aby odtworzyć trasę podczas nawigacji i w przypadku zmiany trasy uwzględnić pierwotny zamiar, gdy trasa została utworzona. Traktuj ten token jako nieprzejrzystą strukturę binarną. Nie porównuj jego wartości w różnych żądaniach, ponieważ może się ona zmieniać, nawet jeśli usługa zwraca 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 okresie przejściowym dla każdego typu, który występuje w Vehicle.load_limits tego pojazdu lub ma niezerową wartość Shipment.load_demands w przypadku niektórych przesyłek zrealizowanych na tej trasie.

Ładunki podczas pierwszego przejazdu to ładunki początkowe na trasie pojazdu. Następnie po każdej wizycie load_demands są dodawane lub odejmowane, aby uzyskać liczbę załadunków w kolejnym przejeździe, w zależności od tego, czy wizyta dotyczyła odbioru czy dostawy.

int64

Obciążenie pojazdu danego typu. Jednostka obciążenia jest zwykle wskazywana przez typ. Zobacz Transition.vehicle_loads.

int32

Indeks pola shipments w źródłowym 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

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

map<string, Load>

Łączne zapotrzebowanie na wizyty jako suma przesyłki i żądania wizyty load_demands. Jeśli wizyta jest dostawą, wartości są ujemne. Dane o popycie są raportowane w przypadku tych samych typów co w przypadku pola Transition.loads.

Duration

Dodatkowy czas objazdu wynikający z odwiedzonych przesyłek na trasie przed wizytą oraz potencjalny czas oczekiwania wynikający z przedziałów czasowych. Jeśli wizyta dotyczy dostawy, objazd jest obliczany na podstawie odpowiedniej wizyty związanej z odbiorem 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 start_location pojazdu i jest równa:

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

string

Kopia odpowiedniego elementu Shipment.label, jeśli został określony w elemencie Shipment.

string

Kopia odpowiedniego elementu VisitRequest.label, jeśli został określony w elemencie VisitRequest.

int32

Nieprzezroczysty token reprezentujący informacje o lokalizacji wizyty.

To pole może być wypełnione w przypadku wizyt na trasach wyników, gdy w przypadku tej wizyty wartość VisitRequest.avoid_u_turns została ustawiona na „true” lub gdy w żądaniu OptimizeToursRequest wartość ShipmentModel.avoid_u_turns została ustawiona na „true”.

Eksperymentalne: więcej informacji znajdziesz na stronie https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request.

string

Lista niezgodnych typów. Dwie przesyłki o różnych wartościach shipment_types na liście są „niezgodne”.

IncompatibilityMode

Tryb zastosowany w przypadku 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ą, aby na tej samej trasie odwiedzono co najmniej 1 przesyłkę typu required_shipment_type_alternatives.

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

RequirementMode

Tryb zastosowany do wymagania.

int32

Indeks odpowiada indeksowi przesyłki w źródłowym pliku ShipmentModel.

string

Kopia odpowiedniego elementu Shipment.label, jeśli został określony w elemencie Shipment.

Reason

Lista powodów, dla których przesyłka została pominięta. See comment above Reason. Jeśli nie będziemy w stanie ustalić, dlaczego przesyłka została pominięta, nie ustawimy przyczyn.

double

To kopia Shipment.penalty_cost, która ułatwia określenie, jak poważne jest pominięcie przesyłki.

Eksperymentalne: działanie lub istnienie tego pola może się w przyszłości zmienić.

double

Szacunkowy odsetek pojazdów, które nie mogą zrealizować tego transportu z co najmniej jednego z tych powodów. Uwaga: to pole jest wypełniane tylko wtedy, gdy powody dotyczą pojazdu.

Eksperymentalne: działanie lub istnienie tego pola może się w przyszłości zmienić.

Code

Zapoznaj się z komentarzami do kodu.

int32

Tak samo jak w przypadku example_vehicle_index, z tym że podajemy listę wielu zidentyfikowanych pojazdów. Lista nie jest wyczerpująca. To pole jest wypełniane tylko wtedy, gdy [fill_example_vehicle_indices_in_skipped_reasons][] ma wartość true.

Eksperymentalne: działanie lub istnienie tego pola może się w przyszłości zmienić.

string

Jeśli kod przyczyny to DEMAND_EXCEEDS_VEHICLE_CAPACITY, dokumenty przekraczają jeden typ pojemności.

int32

Jeśli przyczyną jest niezgodność przesyłki z pojazdem, to pole zawiera indeks jednego odpowiedniego pojazdu.

Timestamp

Czas rozpoczęcia okna ścisłego. Jeśli nie zostanie określona, zostanie ustawiona na ShipmentModel.global_start_time.

Timestamp

Godzina zakończenia sztywnego przedziału czasu. Jeśli nie zostanie określona, zostanie ustawiona na ShipmentModel.global_end_time.

Timestamp

Czas rozpoczęcia przedziału czasu.

Timestamp

Przybliżona godzina zakończenia przedziału czasu.

double

Koszt za godzinę dodany do innych kosztów w modelu, jeśli zdarzenie wystąpi przed czasem 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.

Ten koszt musi być dodatni, a pole można ustawić tylko wtedy, gdy ustawiono pole soft_start_time.

double

Koszt za godzinę dodany do innych kosztów w modelu, jeśli zdarzenie wystąpi 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.

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

string

Tagi określające zbiór przejść (src->dst), do których mają zastosowanie te atrybuty.

Wizyta w źródle lub uruchomienie pojazdu są zgodne, jeśli ich pole VisitRequest.tags lub Vehicle.start_tags zawiera src_tag lub nie zawiera excluded_src_tag (w zależności od tego, które z tych 2 pól nie jest puste).

string

Zobacz src_tag. Dokładnie jedno z pól src_tag i excluded_src_tag musi być niepuste.

string

Wizyta w miejscu docelowym lub zakończenie podróży pojazdem są zgodne, jeśli ich pole VisitRequest.tags lub Vehicle.end_tags zawiera dst_tag lub nie zawiera excluded_dst_tag (w zależności od tego, które z tych 2 pól nie jest puste).

string

Zobacz dst_tag. Dokładnie jedno z pól dst_tag i excluded_dst_tag musi być niepuste.

double

Określa koszt wykonania tego przejścia. Jest to ta sama jednostka co wszystkie inne koszty w modelu i nie może być ujemna. Jest ona doliczana do wszystkich innych istniejących kosztów.

double

Określa koszt za kilometr stosowany do odległości pokonanej podczas wykonywania tej zmiany. Może się sumować z dowolną wartością Vehicle.cost_per_kilometer określoną w przypadku pojazdów.

DistanceLimit

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

Od czerwca 2021 r. obsługiwane są tylko limity elastyczne.

Duration

Określa opóźnienie występujące podczas wykonywania tego przejścia.

To opóźnienie zawsze występuje po zakończeniu wizyty w źródle i przed rozpoczęciem wizyty w miejscu docelowym.

string

Identyfikator URI zasobu. Zasób może jeszcze nie istnieć.

Zawartość zasobu jest zakodowana w formacie JSON lub textproto. Obsługiwane są tylko zasoby Google Cloud Storage. Jeśli zasób jest zakodowany jako JSON, nazwa zasobu musi mieć sufiks .json. Jeśli zasób jest zakodowany jako textproto, nazwa zasobu musi mieć sufiks .txtpb. Na przykład identyfikator URI pliku zakodowanego w formacie JSON w Google Cloud Storage może wyglądać tak: gs://bucket/path/input/object.json.

string

Nazwa pojazdu zdefiniowana przez użytkownika. Może mieć maksymalnie 63 znaki i zawierać znaki UTF-8.

TravelMode

Tryb podróży, który wpływa na drogi, po których może poruszać się pojazd, oraz na jego prędkość. Zobacz też travel_duration_multiple.

RouteModifiers

Zbiór warunków, które muszą zostać spełnione i które wpływają na sposób obliczania tras dla danego pojazdu.

LatLng

Lokalizacja geograficzna, w której pojazd rozpoczyna podróż przed odebraniem przesyłek. Jeśli nie zostanie określony, pojazd rozpocznie podróż od pierwszego miejsca odbioru. Jeśli model dostawy zawiera macierze czasu trwania i odległości, nie można określić wartości start_location.

Waypoint

Punkt pośredni reprezentujący lokalizację geograficzną, w której pojazd rozpoczyna podróż przed odebraniem przesyłek. Jeśli nie określono ani start_waypoint, ani start_location, pojazd rozpoczyna przejazd od pierwszego miejsca odbioru. Jeśli model dostawy zawiera macierze czasu trwania i odległości, nie można określić wartości start_waypoint.

LatLng

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

Waypoint

Punkt pośredni reprezentujący lokalizację geograficzną, w której pojazd kończy ostatni VisitRequest. Jeśli nie podasz ani end_waypoint, ani end_location, ShipmentRoute pojazdu zakończy się natychmiast po zakończeniu ostatniego VisitRequest. Jeśli model dostawy zawiera macierze czasu trwania i odległości, nie można określić wartości end_waypoint.

string

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

Puste lub zduplikowane ciągi znaków są niedozwolone.

string

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

Puste lub zduplikowane ciągi znaków są niedozwolone.

TimeWindow

Okresy, w których pojazd może wyruszyć z lokalizacji początkowej. 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 globalnymi limitami czasu.

Przedziały czasu należące do tego samego pola powtarzanego muszą być rozłączne, tzn. żaden przedział czasu nie może nakładać się na inny ani z nim sąsiadować, a ponadto muszą być ułożone w porządku chronologicznym.

Wartości cost_per_hour_after_soft_end_time i soft_end_time można ustawić tylko wtedy, gdy jest dostępne jedno okno czasowe.

TimeWindow

Przedziały 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 globalnymi limitami czasu.

Przedziały czasu należące do tego samego pola powtarzanego muszą być rozłączne, tzn. żaden przedział czasu nie może nakładać się na inny ani z nim sąsiadować, a ponadto muszą być ułożone w porządku chronologicznym.

Wartości cost_per_hour_after_soft_end_time i soft_end_time można ustawić tylko wtedy, gdy jest dostępne jedno okno czasowe.

UnloadingPolicy

Zasady rozładunku są egzekwowane w przypadku pojazdu.

map<string, LoadLimit>

pojemność pojazdu (np. waga, objętość, liczba palet); Klucze na mapie to identyfikatory typu obciążenia, zgodne z kluczami pola Shipment.load_demands. Jeśli danego klucza nie ma na tej mapie, odpowiednia pojemność jest uznawana za nieograniczoną.

double

Koszty pojazdu: wszystkie koszty sumują się i muszą być podane w tej samej jednostce co Shipment.penalty_cost.

Koszt godzinowy trasy pojazdu. Ten koszt jest stosowany do łącznego czasu trwania trasy i obejmuje czas podróży, czas oczekiwania i czas wizyty. Używanie cost_per_hour zamiast samego cost_per_traveled_hour może powodować dodatkowe opóźnienia.

double

Koszt za godzinę przejazdu na trasie pojazdu. Ten koszt jest stosowany tylko do czasu podróży na trasie (czyli czasu podanego w ShipmentRoute.transitions) i nie obejmuje czasu oczekiwania ani czasu wizyty.

double

Koszt na kilometr trasy pojazdu. Ten koszt jest stosowany do odległości podanej w ShipmentRoute.transitions i nie dotyczy żadnej odległości przebytej w sposób dorozumiany z arrival_location do departure_location w ramach jednego VisitRequest.

double

Stały koszt stosowany, jeśli ten pojazd jest używany do obsługi przesyłki.

bool

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

Jeśli wartość to „true”, pojazd przemieszcza się z lokalizacji początkowej do końcowej, nawet jeśli nie obsługuje żadnych przesyłek, a koszty czasu i odległości wynikające z przejazdu z lokalizacji początkowej do końcowej są uwzględniane.

W przeciwnym razie pojazd nie będzie przemieszczać się z lokalizacji początkowej do końcowej i nie będzie dla niego zaplanowana żadna break_rule ani opóźnienie (od TransitionAttributes). W tym przypadku ShipmentRoute pojazdu nie zawiera żadnych informacji poza indeksem i etykietą 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

Limit stosowany do czasu trwania podróży na trasie pojazdu. W danym OptimizeToursResponse czas trwania podróży to suma wszystkich transitions.travel_duration.

DistanceLimit

Limit zastosowany do całkowitej odległości trasy pojazdu. W danym OptimizeToursResponse odległość trasy to suma wszystkich jej transitions.travel_distance_meters.

map<string, Duration>

Określa mapę ciągów znaków visit_types na czas trwania. Czas trwania to czas dodatkowy do VisitRequest.duration, który należy uwzględnić podczas wizyt z określonym elementem visit_types. Jeśli określono wartość cost_per_hour, dodatkowy czas trwania wizyty zwiększa koszt. Klucze (np. visit_types) nie mogą być pustymi ciągami znaków.

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

BreakRule

Opisuje harmonogram przerw, który ma być stosowany w przypadku tego pojazdu. Jeśli to pole jest puste, dla tego pojazdu nie będą planowane przerwy.

string

Określa etykietę tego pojazdu. Ta etykieta jest podawana w odpowiedzi jako vehicle_label odpowiedniego ShipmentRoute.

bool

Jeśli ma wartość true, atrybut used_if_route_is_empty musi mieć wartość false, a ten pojazd pozostanie nieużywany.

Jeśli dostawa jest realizowana przez zignorowany pojazd w injected_first_solution_routes, jest pomijana w pierwszym rozwiązaniu, ale może być realizowana w odpowiedzi.

Jeśli dostawa jest realizowana przez zignorowany pojazd w injected_solution_constraint, a wszelkie powiązane odbiory lub dostawy są ograniczone do tego pojazdu (tzn. nie są rozluźnione do poziomu RELAX_ALL_AFTER_THRESHOLD), są pomijane w odpowiedzi. Jeśli przesyłka ma niepuste pole allowed_vehicle_indices, a wszystkie dozwolone pojazdy są ignorowane, przesyłka jest pomijana w odpowiedzi.

double

Określa współczynnik mnożenia, który można zastosować do zwiększenia lub zmniejszenia czasu podróży tego pojazdu. Na przykład ustawienie tej wartości na 2,0 oznacza, że ten pojazd jest wolniejszy, a czas podróży jest 2 razy dłuższy niż w przypadku standardowych pojazdów. Ten mnożnik nie wpływa na czas trwania wizyt. Ma to wpływ na koszt, jeśli określono wartości 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 ten mnożnik jest traktowany jako 1,0.

OSTRZEŻENIE: czasy podróży zostaną zaokrąglone do najbliższej sekundy po zastosowaniu tego mnożnika, ale przed wykonaniem jakichkolwiek operacji numerycznych. Mały mnożnik może więc spowodować utratę precyzji.

Zobacz też extra_visit_duration_for_visit_type poniżej.

Duration

Limit bezwzględny ograniczający czas trwania do maksymalnie max_duration.

Duration

Miękki limit, który nie wymusza maksymalnego czasu trwania, ale po przekroczeniu powoduje naliczenie kosztu trasy. Ten koszt jest dodawany do innych kosztów zdefiniowanych w modelu, w tej samej jednostce.

Jeśli wartość soft_max_duration jest zdefiniowana, 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 wymusza maksymalnego czasu trwania, ale w przypadku jego przekroczenia powoduje, że trasa generuje koszt proporcjonalny do kwadratu czasu trwania. Ten koszt jest dodawany do innych kosztów zdefiniowanych w modelu, w tej samej jednostce.

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

max_duration - quadratic_soft_max_duration <= 86400 seconds

double

Koszt za godzinę w przypadku przekroczenia progu soft_max_duration. Jeśli czas trwania jest krótszy niż próg, dodatkowy koszt wynosi 0. W przeciwnym razie koszt zależy od czasu trwania w sposób opisany poniżej:

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

Koszt musi być nieujemny.

double

Koszt za godzinę kwadratową poniesiony w przypadku przekroczenia progu quadratic_soft_max_duration.

Jeśli czas trwania jest krótszy niż próg, dodatkowy koszt wynosi 0. W przeciwnym razie koszt zależy od czasu trwania w sposób opisany poniżej:

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

Koszt musi być nieujemny.

int64

Limit obciążenia. Zobacz cost_per_unit_above_soft_max.

double

Jeśli obciążenie kiedykolwiek przekroczy soft_max_load na trasie tego pojazdu, obowiązuje następująca kara (tylko raz na pojazd): (obciążenie – soft_max_load) * cost_per_unit_above_soft_max. Wszystkie koszty sumują się i muszą być podane w tej samej jednostce co Shipment.penalty_cost. Limity elastyczne można definiować tylko w przypadku typów, które w całym modelu dotyczą tylko odbiorów lub tylko dostaw.

Interval

Dopuszczalny przedział czasu załadunku pojazdu na początku trasy.

Interval

Dopuszczalny przedział czasu załadunku pojazdu na końcu trasy.

int64

Maksymalna dopuszczalna wartość obciążenia.

LoadCost

Koszt przewiezienia 1 jednostki ładunku na odległość 1 km w przypadku tego pojazdu. Może to być używane jako przybliżone zużycie paliwa: jeśli obciążenie jest wagą (w niutonach), to obciążenie × kilometr ma wymiar energii.

Eksperymentalne: więcej informacji znajdziesz na stronie https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request.

LoadCost

Koszt podróży z jednostką ładunku w ciągu godziny w przypadku tego pojazdu.

Eksperymentalne: więcej informacji znajdziesz na stronie https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request.

int64

Minimalne dopuszczalne obciążenie. Wartość musi być ≥ 0. Jeśli oba parametry są określone, wartość min musi być ≤ max.

int64

Maksymalne dopuszczalne obciążenie. Wartość musi być ≥ 0. Jeśli nie zostanie określona, maksymalne obciążenie nie będzie ograniczone przez tę wiadomość. Jeśli oba parametry są określone, wartość min musi być ≤ max.

int64

Wartość obciążenia, powyżej której koszt przeniesienia jednostki obciążenia zmienia się z cost_per_unit_below_threshold na cost_per_unit_above_threshold. Musi być >= 0.

double

Koszt przeniesienia jednostki ładunku dla każdej jednostki w zakresie od 0 do wartości progowej. Musi to być wartość skończona i >= 0.

double

Koszt przeniesienia jednostki ładunku za każdą jednostkę powyżej progu. W przypadku specjalnym, gdy próg = 0, jest to stały koszt za jednostkę. Musi to być wartość skończona i >= 0.

double

Maksymalna wartość wszystkich pozostałych pól w tej wiadomości.

double

Stosunek między AggregatedMetrics.travel_distance_meters a Vehicle.route_distance_limit. Jeśli pole Vehicle.route_distance_limit nie jest ustawione, to pole również nie będzie ustawione.

double

Stosunek między [AggregatedMetrics.travel_duration_seconds][] a Vehicle.travel_duration_limit. Jeśli pole Vehicle.travel_duration_limit nie jest ustawione, to pole również nie będzie ustawione.

double

Stosunek między [AggregatedMetrics.total_duration_seconds][] a Vehicle.route_duration_limit. Jeśli pole Vehicle.route_duration_limit nie jest ustawione, to pole również nie będzie ustawione.

double

Maksymalny współczynnik spośród wszystkich typów [AggregatedMetrics.max_load][] i odpowiednich Vehicle.load_limits. Jeśli wszystkie pola Vehicle.load_limits są nieustawione, to pole będzie nieustawione.

double

Stosunek (vehicle_end_time - vehicle_start_time) / (latest_vehicle_end_time - earliest_vehicle_start_time) dla danego pojazdu. Jeśli mianownik nie występuje, używana jest wartość (ShipmentModel.global_end_time – ShipmentModel.global_start_time).

bool

Opcjonalnie: Wskazuje, że lokalizacja tego punktu trasy ma preferencję, aby pojazd zatrzymał się po określonej stronie drogi. Gdy ustawisz tę wartość, trasa będzie przebiegać przez to miejsce, aby pojazd mógł zatrzymać się po stronie drogi, w kierunku której jest ono przesunięte od środka drogi. Ta opcja nie działa w przypadku trybu podróży „PIESZO”.

bool

Wskazuje, że punkt pośredni jest przeznaczony dla pojazdów, które mają się w nim zatrzymać, aby odebrać lub wysadzić pasażera. Ta opcja działa tylko w przypadku trybu podróży „DRIVING” i gdy „location_type” ma wartość „location”.

Eksperymentalne: działanie lub istnienie tego pola może się w przyszłości zmienić.

Location

Punkt określony za pomocą współrzędnych geograficznych, z opcjonalnym kierunkiem.

string

Identyfikator miejsca POI powiązany z punktem pośrednim.

Jeśli używasz identyfikatora miejsca do określania lokalizacji przyjazdu lub odjazdu w przypadku VisitRequest, użyj identyfikatora miejsca, który jest wystarczająco szczegółowy, aby określić lokalizację LatLng na potrzeby nawigacji do tego miejsca. Na przykład identyfikator miejsca reprezentujący budynek jest odpowiedni, ale identyfikator miejsca reprezentujący drogę jest niezalecany.