Package google.research.middlemileoptimization.v1

Indeks

MiddleMileOptimization

Usługa do zarządzania siecią logistyczną i trasowania przesyłek w środku. Protokół ten jest bezstanowy (wiadomości są niezależne), chociaż wiążąca się z nim usługa jest wysoce stanowa (odebranie wiadomości może radykalnie zmienić odpowiedzi w wielu metodach, takich jak kierowanie przesyłki może zmienić routing innych przesyłek).

CommitPath

rpc CommitPath(CommitPathRequest) returns (Path)

Określa ścieżkę dostawy, co oznacza, że nie może jej zmienić w przyszłości, nawet przez użytkownika, z wyjątkiem siły wyższej lub działania Bogu wskazanego przez metody MakeMachineUnavailable, MakeHubUnavailable i MakeLineUnavailable. Ta metoda nie służy do oznaczania tagami konkretnej wersji ścieżki.

CreateHub

rpc CreateHub(CreateHubRequest) returns (Hub)

Tworzy centrum.

CreateLine

rpc CreateLine(CreateLineRequest) returns (Line)

Tworzy linię.

CreateLineRotation

rpc CreateLineRotation(CreateLineRotationRequest) returns (LineRotation)

Tworzy element LineRotation.

CreateNetwork

rpc CreateNetwork(CreateNetworkRequest) returns (Network)

Tworzy sieć.

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

Tworzy pojazd.

DeleteHub

rpc DeleteHub(DeleteHubRequest) returns (Empty)

Usuwa centrum.

DeleteLine

rpc DeleteLine(DeleteLineRequest) returns (Empty)

Usuwa wiersz.

DeleteLineRotation

rpc DeleteLineRotation(DeleteLineRotationRequest) returns (Empty)

Usuwa element LineRotation.

DeleteNetwork

rpc DeleteNetwork(DeleteNetworkRequest) returns (Empty)

Usuwa sieć.

DeleteShipment

rpc DeleteShipment(DeleteShipmentRequest) returns (Empty)

Usuwa przesyłkę.

DeleteVehicle

rpc DeleteVehicle(DeleteVehicleRequest) returns (Empty)

Usuwa pojazd.

GetHub

rpc GetHub(GetHubRequest) returns (Hub)

Pobiera szczegóły centrum.

GetLine

rpc GetLine(GetLineRequest) returns (Line)

Pobiera szczegóły linii.

GetLineRotation

rpc GetLineRotation(GetLineRotationRequest) returns (LineRotation)

Pobiera szczegóły obiektu LineRotation.

GetNetwork

rpc GetNetwork(GetNetworkRequest) returns (Network)

Pobiera szczegóły sieci.

GetShipment

rpc GetShipment(GetShipmentRequest) returns (Shipment)

Pobiera szczegóły przesyłki.

GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

Pobiera szczegóły pojazdu.

ListHubs

rpc ListHubs(ListHubsRequest) returns (ListHubsResponse)

Wyświetla listę centrów.

ListLineRotations

rpc ListLineRotations(ListLineRotationsRequest) returns (ListLineRotationsResponse)

Wyświetla listę LineRotations.

ListLines

rpc ListLines(ListLinesRequest) returns (ListLinesResponse)

Wyświetla listę wierszy.

ListNetworks

rpc ListNetworks(ListNetworksRequest) returns (ListNetworksResponse)

Wyświetla listę sieci.

ListPaths

rpc ListPaths(ListPathsRequest) returns (ListPathsResponse)

Zwraca wszystkie aktualnie dostępne ścieżki. Ta metoda jest idempotentna i nie ma skutków ubocznych.

ListShipments

rpc ListShipments(ListShipmentsRequest) returns (ListShipmentsResponse)

Wyświetla listę przesyłek.

ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

Wyświetla listę pojazdów.

MakeHubAvailable

rpc MakeHubAvailable(MakeHubAvailableRequest) returns (MakeHubAvailableResponse)

Udostępnia centrum.

MakeHubUnavailable

rpc MakeHubUnavailable(MakeHubUnavailableRequest) returns (MakeHubUnavailableResponse)

Ustawia centrum jako niedostępne.

MakeLineAvailable

rpc MakeLineAvailable(MakeLineAvailableRequest) returns (MakeLineAvailableResponse)

Udostępnia linię.

MakeLineUnavailable

rpc MakeLineUnavailable(MakeLineUnavailableRequest) returns (MakeLineUnavailableResponse)

Ustawia linię jako niedostępne.

MakeVehicleAvailable

rpc MakeVehicleAvailable(MakeVehicleAvailableRequest) returns (MakeVehicleAvailableResponse)

Udostępnia pojazd.

MakeVehicleUnavailable

rpc MakeVehicleUnavailable(MakeVehicleUnavailableRequest) returns (MakeVehicleUnavailableResponse)

Ustawia pojazd jako niedostępny.

RouteShipment

rpc RouteShipment(RouteShipmentRequest) returns (RouteShipmentResponse)

Kieruj nową przesyłkę. Ta operacja przypomina tworzenie, co oznacza zmianę stanu.

UpdateHub

rpc UpdateHub(UpdateHubRequest) returns (Hub)

Aktualizuje centrum.

UpdateLine

rpc UpdateLine(UpdateLineRequest) returns (Line)

Aktualizuje linię.

UpdateLineRotation

rpc UpdateLineRotation(UpdateLineRotationRequest) returns (LineRotation)

Aktualizuje LineRotation.

UpdateNetwork

rpc UpdateNetwork(UpdateNetworkRequest) returns (Network)

Aktualizuje sieć.

UpdatePath

rpc UpdatePath(UpdatePathRequest) returns (Path)

Zmienia ścieżkę dostawy: zamiast używać zasobu obliczonego przez usługę, stan będzie zawierał ścieżkę ustawioną przez użytkownika w ramach tego wywołania.

UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

Aktualizuje pojazd.

AnnotatedPathSegment

Reprezentuje część ścieżki z bardziej nadmiarowymi informacjami, które można obliczyć na podstawie zawartego w ścieżce PathSegment i sieci. Komunikaty te są zwykle zwracane przez serwer interfejsu API.

Pola
segment

PathSegment

Wymagane. Segment z adnotacjami.

arrival_time

DateTime

Tylko dane wyjściowe. Godzina przyjazdu tego segmentu.

departure_time

DateTime

Tylko dane wyjściowe. Godzina odjazdu tego segmentu.

is_committed

bool

Tylko dane wyjściowe. Informacja, czy klient interfejsu API zdecydował się zrealizować tę część ścieżki.

segment_cost_constant

double

Tylko dane wyjściowe. Stały koszt dla tego segmentu.

segment_cost_due_to_vehicle

map<string, double>

Tylko dane wyjściowe. Jeden wpis na wymiar.

segment_cost_due_to_departure

double

Tylko dane wyjściowe. Koszt związany z rotacją linii: wylot.

segment_cost_due_to_arrival

double

Tylko dane wyjściowe. Koszt związany z rotacją linii: przylot.

CommitPathRequest

Komunikat żądania dla metody CommitPath.

Pola
name

string

Wymagane. Nazwa dostawy, której ścieżka musi zostać zatwierdzona. Format: „sieci/{sieć}/przesyłki/{shipment}”

Pole sumy path_to_commit. Ścieżka lub jej części, które należy zatwierdzić. path_to_commit może mieć tylko jedną z tych wartości:
complete_shipment_path

PathToCommit

Segmenty ścieżki ze źródła do miejsca docelowego.

segments

IncompletePathToCommit

Podzbiór segmentów ścieżki ze źródła do miejsca docelowego.

IncompletePathToCommit

Część zatwierdzanej ścieżki, np. niektóre segmenty między źródłem a miejscem docelowym.

Pola
segments[]

PathSegment

Wymagane. Podzbiór segmentów ścieżki ze źródła do miejsca docelowego.

PathToCommit

Akceptowana jest pełna ścieżka, od źródła do miejsca docelowego.

Pola
segments[]

PathSegment

Wymagane. Segmenty muszą być ułożone w określonej kolejności, od źródła do miejsca docelowego.

CreateHubRequest

Komunikat żądania dla metody CreateHub.

Pola
parent

string

Wymagane. Zasób nadrzędny, w którym zostanie utworzone to centrum. Format: „sieci/{sieć}”

hub_id

string

Wymagane. Identyfikator centrum do utworzenia.

hub

Hub

Wymagane. Centrum tworzenia.

CreateLineRequest

Komunikat żądania dla metody CreateLine.

Pola
parent

string

Wymagane. Zasób nadrzędny, w którym zostanie utworzony ten wiersz. Format: „sieci/{sieć}”

line_id

string

Wymagane. Identyfikator wiersza do utworzenia.

line

Line

Wymagane. Wiersz do utworzenia.

CreateLineRotationRequest

Komunikat żądania dla metody CreateLineRotation.

Pola
parent

string

Wymagane. Zasób nadrzędny, w którym zostanie utworzona rotacja wierszy. Format: „sieci/{sieć}/linii/{line}”

line_rotation_id

string

Wymagane. Identyfikator rotacji wierszy do utworzenia.

line_rotation

LineRotation

Wymagane. Rotacja linii do utworzenia.

CreateNetworkRequest

Komunikat żądania dla metody CreateNetwork.

Pola
network_id

string

Wymagane. Identyfikator sieci do utworzenia.

network

Network

Wymagane. Sieć do utworzenia.

CreateVehicleRequest

Komunikat żądania dla metody CreateVehicle.

Pola
parent

string

Wymagane. Zasób nadrzędny, w którym zostanie utworzony ten pojazd. Format: „sieci/{sieć}”

vehicle_id

string

Wymagane. Identyfikator pojazdu do utworzenia.

vehicle

Vehicle

Wymagane. Pojazd do tworzenia.

CrossDockingCapacity

Ogólna pojemność dokowania w centrum.

Pola
capacity_per_hour[]

ValueDimension

Opcjonalnie. Możliwość łączenia się między dokumentami w każdym wymiarze.

CrossDockingTime

Ogólny czas dokowania w centrum.

Pola
time_constant

Duration

Opcjonalnie. Stały czas operacji cross-docking.

time

SeparableNDFunction

Opcjonalnie. Rozdzielność to założenie upraszczające.

DateTimeRange

Zakres czasowy pomiędzy dwiema wartościami typu DateTime. Aby określić konkretną datę i godzinę, użyj wartości start == end.

Działanie google/type/interval.proto jest podobne, ale z użyciem czasu fizycznego (zależy nam tylko na czasie cywilnym).

Pola
first_date

DateTime

Początek zakresu.

last_date

DateTime

Koniec zakresu

DeleteHubRequest

Komunikat żądania dla metody DeleteHub.

Pola
name

string

Wymagane. Nazwa centrum do usunięcia. Format: „sieci/{sieć}/hubs/{hub}”

DeleteLineRequest

Komunikat żądania dla metody DeleteLine.

Pola
name

string

Wymagane. Nazwa wiersza do usunięcia. Format: „sieci/{sieć}/linii/{line}”

force

bool

Opcjonalnie. Jeśli ma wartość true, usuń zasoby podrzędne.

DeleteLineRotationRequest

Komunikat żądania dla metody DeleteLineRotation.

Pola
name

string

Wymagane. Nazwa rotacji wierszy, która ma zostać usunięta. Format: „networks/{network}/lines/{line}/rotations/{rotation}"

DeleteNetworkRequest

Komunikat żądania dla metody DeleteNetwork.

Pola
name

string

Wymagane. Nazwa sieci do usunięcia. Format: „sieci/{sieć}”

force

bool

Opcjonalnie. Jeśli ma wartość true, usuń zasoby podrzędne.

DeleteShipmentRequest

Komunikat żądania dla metody DeleteShipment.

Pola
name

string

Wymagane. Nazwa przesyłki do usunięcia. Format: „sieci/{sieć}/przesyłki/{shipment}”

DeleteVehicleRequest

Komunikat żądania dla metody DeleteVehicle.

Pola
name

string

Wymagane. Nazwa pojazdu do usunięcia. Format: „sieci/{sieć}/pojazdy/{pojazd}”

DistanceMatrixEntry

Odległość między centrum źródłowym a centrum docelowym.

Pola
source_hub

string

Wymagane. Centrum źródeł.

destination_hub

string

Wymagane. Centrum docelowe.

weights[]

ValueDimension

Wymagane. Odległość między centrami mierzona w kilku wymiarach.

EarlinessTardiness

koszty związane z dostarczeniem/odlotem przesyłki wcześniej lub później niż jest to wymagane (ograniczenia miękkie).

Pola
maximum_earliness

Duration

Opcjonalnie. Maksymalna dopuszczalna wstępna dostępność. Przydatny tylko z opłatami.

maximum_tardiness

Duration

Opcjonalnie. Maksymalne dozwolone opóźnienie. Przydatny tylko z opłatami.

earliness_cost

Function1D

Opcjonalnie. Koszt wczesnego okresu. Usuń ustawienie bezpłatnej wersji z wcześniejszym wyprzedzeniem.

tardiness_cost

Function1D

Opcjonalnie. Koszt ponaglenia. Usuń ustawienie IFF bez kosztów na czas oczekiwania.

Funkcja1D

Funkcja jednego argumentu.

Pola
Pole sumy function. Jednostką argumentu funkcji jest: - jeśli waga: kg - jeśli czas: min - jeśli liczba palet: 1 function może być tylko jedną z tych wartości:
constant

double

Funkcja jest stałą.

pwl

PieceWiseAffineFunction

Funkcja jest kawałkami liniowy.

GeneratedLineAndRotation

Jedna rotacja wiersza wygenerowana przez ten interfejs API, a nie przez klienta interfejsu API. Jest on z natury mniej ograniczony i może używać dowolnego pojazdu (chyba że klient interfejsu API zdecyduje inaczej podczas kolejnych wywołań).

Pola
arrival_times

map<string, DateTime>

Tylko dane wyjściowe. Zmapuj identyfikatory centrów na godziny. Ta mapa powinna mieć te same klucze (minus centrum źródłowe, bez godziny przybycia).

departure_times

map<string, DateTime>

Tylko dane wyjściowe. Zmapuj identyfikatory centrów na godziny. Ta mapa powinna mieć te same klawisze (minus centrum docelowe, bez godziny odjazdu).

GetHubRequest

Komunikat żądania dla metody GetHub.

Pola
name

string

Wymagane. Nazwa centrum do pobrania. Format: „sieci/{sieć}/hubs/{hub}”

GetLineRequest

Komunikat żądania dla metody GetLine.

Pola
name

string

Wymagane. Nazwa sieci do pobrania. Format: „sieci/{sieć}/linii/{line}”

GetLineRotationRequest

Komunikat żądania dla metody GetLineRotation.

Pola
name

string

Wymagane. Nazwa rotacji wierszy do pobrania. Format: „networks/{network}/lines/{line}/rotations/{rotation}"

GetNetworkRequest

Komunikat żądania dla metody GetNetwork.

Pola
name

string

Wymagane. Nazwa sieci do pobrania. Format: „sieci/{sieć}”

GetShipmentRequest

Komunikat żądania dla metody GetShipment.

Pola
name

string

Wymagane. Nazwa przesyłki do pobrania. Format: „sieci/{sieć}/przesyłki/{shipment}”

GetVehicleRequest

Komunikat żądania dla metody GetVehicle.

Pola
name

string

Wymagane. Nazwa pojazdu do pobrania. Format: „sieci/{sieć}/pojazdy/{pojazd}”

Regularne

Przesyłki muszą być dostarczone z jednego centrum do innego.

Pola
name

string

Wymagane. Identyfikator. Tego ustawienia nie można później zmienić.

position

LatLng

Opcjonalnie. Pozycja przy obliczaniu rzeczywistych ścieżek.

opening_times[]

DateTimeRange

Wymagane. Godziny otwarcia. Na razie używaj raczej mniej niż 1 zapisu: po jednym wstępie na każde otwarcie centrum (jeśli jego pracownicy mają przerwę na lunch i o tej porze nikt nie pracuje, na ten dzień będą dostępne 2 wpisy).

cross_docking_capacity

CrossDockingCapacity

Opcjonalnie. Pojemność całego centrum.

cross_docking_time

CrossDockingTime

Opcjonalnie. Czas wykonania jednej operacji dokowania (dla każdego pojazdu).

IntegerRange

Zakres liczb całkowitych.

Pola
start_value

int32

Interwał otwarty, jeśli nie jest ustawiony.

end_value

int32

Interwał otwarty, jeśli nie jest ustawiony.

Liniowy

Linia obsługiwana z określoną częstotliwością.

Pola
name

string

Wymagane. Identyfikator. Tego ustawienia nie można później zmienić.

hub_ids[]

string

Wymagane. Lista koncentratorów, do których wzywa się ta linia, w kolejności, w jakiej się zatrzymują pojazdy.

LineRotation

Pojazd zaczyna kursować na tej linii w określonym czasie.

Pola
name

string

Wymagane. Identyfikator. Tego ustawienia nie można później zmienić.

arrival_times

map<string, DateTimeRange>

Opcjonalnie. Zakres, z którego odjazd jest dozwolony bez opłat (tj. jeśli nie jest to punktowe, rzeczywiste godziny przyjazdu są określane przez system). Ta mapa powinna mieć te same klucze (minus centrum źródłowe, bez godziny przybycia).

departure_times

map<string, DateTimeRange>

Opcjonalnie. Zakres, w którym przyjazd jest dozwolony bezpłatnie (tj. jeśli nie jest to punktowane, rzeczywiste czasy odjazdu są określane przez system). Ta mapa powinna mieć te same klawisze (minus centrum docelowe, bez godziny odjazdu).

departure_earliness_tardiness_costs

map<string, EarlinessTardiness>

Opcjonalnie. Koszty wczesnego etapu/czas oczekiwania oraz ograniczenia związane z odjazdem. Te mapy powinny mieć te same klawisze (minus centrum docelowe, bez godziny odjazdu).

arrival_earliness_tardiness_costs

map<string, EarlinessTardiness>

Opcjonalnie. Koszty wczesnego etapu i opóźnienia oraz ograniczenia związane z przyjazdem. Te mapy powinny mieć te same klawisze (minus centrum źródłowe, bez godziny przybycia).

vehicles[]

string

Opcjonalnie. Lista pojazdów, które mogą wykonywać tę procedurę obrotu linii (np. lista dozwolonych). Jeśli parametr number_vehicles zmniejszy się do jednej wartości odpowiadającej liczbie pojazdów, wszystkie te pojazdy zostaną przypisane do rotacji linii. Jeśli nie ma żadnych pojazdów, wszystkie są uznawane za dostępne.

fixed_price

PricingStrategy

Opcjonalnie. Koszty dowolnego pojazdu używanego na tej linii, niezależnie od pojazdu (kierowcy, serwisowania itp.).

maximum_number_vehicles

IntegerRange

Opcjonalnie. Maksymalna liczba pojazdów, które można przypisać do tej rotacji. Jeśli nie jest skonfigurowana: brak limitu pojazdów w przypadku tej rotacji. W przeciwnym razie górna granica liczby pojazdów, które można przydzielić do tej rotacji (wśród listy dozwolonych vehicle_ids). W szczególności wartość 0 wyłącza obrót (pojazdy nie są dozwolone).

ListHubsRequest

Komunikat żądania dla metody ListHubs.

Pola
parent

string

Wymagane. Nadrzędny, do którego należy ta kolekcja centrów. Format: „sieci/{sieć}”

page_size

int32

Opcjonalnie. Maksymalna liczba centrów do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwróconych zostanie maksymalnie 50 centrów. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.

page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania funkcji ListHubs. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu ListHubs muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListHubsResponse

Komunikat z odpowiedzią dla metody ListHubs.

Pola
hubs[]

Hub

Centra z określonej sieci.

next_page_token

string

Token, który może zostać wysłany jako page_token w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

ListLineRotationsRequest

Komunikat żądania dla metody ListLineRotations.

Pola
parent

string

Wymagane. Element nadrzędny, który jest właścicielem tej kolekcji obrotów wierszy. Format: „sieci/{sieć}/linii/{line}”

page_size

int32

Opcjonalnie. Maksymalna liczba obrotów linii do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwróconych zostanie maksymalnie 50 lineRotations. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.

page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania funkcji ListLineRotations. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu ListLineRotations muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListLineRotationsResponse

Komunikat z odpowiedzią dla metody ListLineRotations.

Pola
line_rotations[]

LineRotation

Obroty linii ze wskazanej sieci i linii.

next_page_token

string

Token, który może zostać wysłany jako page_token w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

ListLinesRequest

Komunikat żądania dla metody ListLines.

Pola
parent

string

Wymagane. Element nadrzędny, do którego należy ta kolekcja wierszy. Format: „sieci/{sieć}”

page_size

int32

Opcjonalnie. Maksymalna liczba wierszy do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwróconych zostanie maksymalnie 50 wierszy. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.

page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania funkcji ListLines. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu ListLines muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListLinesResponse

Komunikat z odpowiedzią dla metody ListLines.

Pola
lines[]

Line

Linie z określonej sieci.

next_page_token

string

Token, który może zostać wysłany jako page_token w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

ListNetworksRequest

Komunikat żądania dla metody ListNetworks.

Pola
page_size

int32

Opcjonalnie. Maksymalna liczba sieci do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwróconych zostanie maksymalnie 50 sieci. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.

page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania funkcji ListNetworks. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu ListNetworks muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListNetworksResponse

Komunikat z odpowiedzią dla metody ListNetworks.

Pola
networks[]

Network

Lista sieci.

next_page_token

string

Token, który może zostać wysłany jako page_token w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

ListPathsRequest

Komunikat żądania dla metody ListPaths.

Pola
parent

string

Wymagane. Nazwa sieci, dla której muszą być wysyłane ścieżki. Format: „sieci/{sieć}”

page_size

int32

Opcjonalnie. Maksymalna liczba sieci do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwróconych zostanie maksymalnie 50 sieci. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.

page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania funkcji ListNetworks. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu ListNetworks muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListPathsResponse

Komunikat z odpowiedzią dla metody ListPaths.

Pola
paths[]

Path

Lista ścieżek.

next_page_token

string

Token, który może zostać wysłany jako page_token w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

ListShipmentsRequest

Komunikat żądania dla metody ListShipments.

Pola
parent

string

Wymagane. Podmiot nadrzędny, który jest właścicielem tej kolekcji przesyłek. Format: „sieci/{sieć}”

page_size

int32

Opcjonalnie. Maksymalna liczba przesyłek do zwrotu. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwrócimy maksymalnie 50 przesyłek. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.

page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania funkcji ListShipments. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu ListShipments muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListShipmentsResponse

Komunikat z odpowiedzią dla metody ListShipments.

Pola
shipments[]

Shipment

Wysyłki z określonej sieci.

next_page_token

string

Token, który może zostać wysłany jako page_token w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

ListVehiclesRequest

Komunikat żądania dla metody ListVehicles.

Pola
parent

string

Wymagane. Podmiot nadrzędny, który jest właścicielem tej kolekcji pojazdów. Format: „sieci/{sieć}”

page_size

int32

Opcjonalnie. Maksymalna liczba pojazdów do zwrotu. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwrócimy maksymalnie 50 pojazdów. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.

page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania funkcji ListVehicles. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu ListVehicles muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListVehiclesResponse

Komunikat z odpowiedzią dla metody ListVehicles.

Pola
vehicles[]

Vehicle

Pojazdy z określonej sieci.

next_page_token

string

Token, który może zostać wysłany jako page_token w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

MakeHubAvailableRequest

Komunikat żądania dla metody MakeHubAvailable.

Pola
name

string

Wymagane. Nazwa centrum do udostępnienia. Format: „sieci/{sieć}/hubs/{hub}”

availability_starts[]

DateTime

Wymagane. Okresy, w których rozpocznie się dostępność. Muszą to być punkty w przyszłości. Jeśli brak tego pola, dostępność zaczyna się po otrzymaniu wiadomości.

MakeHubAvailableResponse

Komunikat z odpowiedzią dla metody MakeHubAvailable.

Pola
name

string

Nazwa centrum, którego niedostępność została zaktualizowana. Format: „sieci/{sieć}/hubs/{hub}”

path[]

Path

Zaktualizowane ścieżki.

MakeHubUnavailableRequest

Komunikat żądania dla metody MakeHubUnavailable.

Pola
name

string

Wymagane. Nazwa centrum, które ma być niedostępne. Format: „sieci/{sieć}/hubs/{hub}”

unavailability_starts[]

DateTime

Wymagane. Okresy, w których rozpocznie się niedostępność. Muszą to być punkty w przyszłości. Jeśli brak tego pola, brak dostępności zaczyna się od momentu otrzymania wiadomości.

MakeHubUnavailableResponse

Komunikat z odpowiedzią dla metody MakeHubUnavailable.

Pola
name

string

Nazwa centrum, którego niedostępność została zaktualizowana. Format: „sieci/{sieć}/hubs/{hub}”

path[]

Path

Zaktualizowane ścieżki.

MakeLineAvailableRequest

Komunikat żądania dla metody MakeHubAvailable.

Pola
name

string

Wymagane. Nazwa linii do udostępnienia. Format: „sieci/{sieć}/linii/{line}”

availability_starts[]

DateTime

Wymagane. Okresy, w których rozpocznie się dostępność. Muszą to być punkty w przyszłości. Jeśli brak tego pola, dostępność zaczyna się po otrzymaniu wiadomości.

MakeLineAvailableResponse

Komunikat z odpowiedzią dla metody MakeLineAvailable.

Pola
name

string

Nazwa linii, w której przypadku niedostępność została zaktualizowana. Format: „sieci/{sieć}/linii/{line}”

path[]

Path

Zaktualizowane ścieżki.

MakeLineUnavailableRequest

Komunikat żądania dla metody MakeLineUnavailable.

Pola
name

string

Wymagane. Nazwa wiersza, który ma być niedostępny. Format: „sieci/{sieć}/linii/{line}”

unavailability_starts[]

DateTime

Wymagane. Okresy, w których rozpocznie się niedostępność. Muszą to być punkty w przyszłości. Jeśli brak tego pola, brak dostępności zaczyna się od momentu otrzymania wiadomości.

MakeLineUnavailableResponse

Komunikat z odpowiedzią dla metody MakeLineUnavailable.

Pola
name

string

Nazwa linii, w której przypadku niedostępność została zaktualizowana. Format: „sieci/{sieć}/linii/{line}”

path[]

Path

Zaktualizowane ścieżki.

MakeVehicleAvailableRequest

Komunikat żądania dla metody MakeVehicleAvailable.

Pola
name

string

Wymagane. Nazwa pojazdu do udostępnienia. Format: „sieci/{sieć}/pojazd/{pojazd}”

availability_starts[]

DateTime

Wymagane. Okresy, w których rozpocznie się dostępność. Muszą to być punkty w przyszłości. Jeśli brak tego pola, dostępność zaczyna się po otrzymaniu wiadomości.

MakeVehicleAvailableResponse

Komunikat z odpowiedzią dla metody MakeVehicleAvailable.

Pola
name

string

Nazwa pojazdu, którego dostępność została zaktualizowana. Format: „sieci/{sieć}/pojazdy/{pojazd}”

path[]

Path

Zaktualizowane ścieżki.

MakeVehicleUnavailableRequest

Komunikat żądania dla metody MakeVehicleUnavailable.

Pola
name

string

Wymagane. Nazwa pojazdu, który ma być niedostępny. Format: „sieci/{sieć}/pojazdy/{pojazd}”

unavailability_starts[]

DateTime

Wymagane. Okresy, w których rozpocznie się niedostępność. Muszą to być punkty w przyszłości. Jeśli brak tego pola, brak dostępności zaczyna się od momentu otrzymania wiadomości.

MakeVehicleUnavailableResponse

Komunikat z odpowiedzią dla metody MakeVehicleUnavailable.

Pola
name

string

Nazwa pojazdu, którego niedostępność została zaktualizowana. Format: „sieci/{sieć}/pojazdy/{pojazd}”

path[]

Path

Zaktualizowane ścieżki.

Sieć

Opisuje całą istniejącą sieć, której można używać. Każdy klient korzystający z interfejsu API może mieć kilka sieci (np. sieć główną i możliwe w przyszłości modyfikacje do oceny).

Pola
name

string

Wymagane. Identyfikator. Tego ustawienia nie można później zmienić.

dimensions[]

ValueDimension

Odległość, waga, palety itd. oraz skalowanie (do mapowania liczb zmiennoprzecinkowych na liczby całkowite).

pricing

PricingStrategy

Opcjonalnie. Cena, jaką ma zapłacić nadawca za wysyłkę, która nie wymaga osobnej linii.

currency_code

string

Opcjonalnie. Jedna jednostka pieniężna używana w całej sieci. Dany klient API może mieć kilka różnych jednostek dla różnych sieci; sieć może mieć tylko jedną jednostkę pieniężną. Jednostka musi być zakodowana w formacie ISO 4217, np. google3/google/type/money.proto.

time_step

Duration

Opcjonalnie. Dyskretyzacja czasu. Decyzje są podejmowane z taką precyzją w czasie. Wewnętrznie stan jest zachowywany z taką precyzją.

distance_matrix[]

DistanceMatrixEntry

Opcjonalnie. Macierz odległości (reprezentuje listę ważonych, kierowanych krawędzi).

Ścieżka

Ścieżka dostawy w sieci.

Pola
shipment

string

Wymagane. Przesyłka, której ścieżka jest opisana.

segments[]

AnnotatedPathSegment

Wymagane. Segmenty ścieżki.

departure_time

DateTime

Tylko dane wyjściowe. Rzeczywista godzina wysyłki przesyłki.

arrival_time

DateTime

Tylko dane wyjściowe. Rzeczywista godzina dostarczenia przesyłki.

incurred_penalties

double

Tylko dane wyjściowe. Kary wynikające z miękkich ograniczeń nie są uwzględniane.

cost_constant

double

Tylko dane wyjściowe. Stały koszt tej dostawy.

cost

map<string, double>

Tylko dane wyjściowe. Koszt według komponentów.

PathSegment

Reprezentuje część ścieżki, która może zostać wysłana przez klienta interfejsu API na serwer API (np. zmiana stanu) lub przez serwer API do klienta korzystającego z interfejsu API (np. w celu kierowania wysyłki).

Pola
source_hub

string

Wymagane. Źródło segmentu.

destination_hub

string

Wymagane. Miejsce docelowe segmentu.

line

string

Wymagane. Linia obserwowana w tym segmencie.

line_rotation

string

Wymagane. Rotacja tego segmentu jest obserwowana.

vehicle

string

Wymagane. Pojazd, a następnie ten segment.

PieceWiseAffineFunction

Funkcja liniowa w układzie pionowym z ograniczeniem do 1 argumentu. Projekt podobny do tego: https://github.com/google/or-tools/blob/stable/ortools/util/piecewise_linear_function.h

Pola
segments[]

PieceWiseAffineSegment

Segmenty liniowe funkcji.

PieceWiseAffineSegment

Jeden segment funkcji liniowej odcinków.

Pola
start_x

double

Początek segmentu: x.

start_y

double

Początek segmentu: y.

end_x

double

Koniec segmentu: x.

end_y

double

Koniec segmentu: y.

PricingStrategy

Strategię cenową.

Pola
Pole sumy pricing_strategy. Strategię cenową. pricing_strategy może mieć tylko jedną z tych wartości:
separable

SeparableNDFunction

Strategia cenowa to rozdzielna funkcja kilku zmiennych.

RouteShipmentRequest

Komunikat żądania dla metody RouteShipment.

Pola
parent

string

Wymagane. Nadrzędna sieć, w której ma być kierowana przesyłka. Format: „sieci/{sieć}”

shipment

Shipment

Wymagane. Przesyłka do kierowania.

RouteShipmentResponse

Komunikat z odpowiedzią dla metody RouteShipment.

Pola
shipment

Shipment

Nowo utworzona dostawa.

paths[]

Path

Ścieżki, które zostały zmienione w związku z skierowaniem przesyłki. To pole zawiera co najmniej 1 wpis, czyli ścieżkę przesyłki, która miała zostać skierowana. Może obejmować więcej ścieżek dla innych dostaw, co odzwierciedla wewnętrzne zmiany stanu.

lines[]

GeneratedLineAndRotation

Rotacja linii utworzone podczas kierowania przesyłki. Może on być pusty lub zawierać rotacje dotyczące innych dostaw, co odzwierciedla wewnętrzne zmiany stanu.

SeparableNDFunction

Funkcja N argumentów wyrażona jako suma funkcji jednego argumentu.

Pola
components

map<string, Function1D>

Składniki funkcji, po 1 wpisie na argument/wymiar.

constant_price

double

Stała część funkcji.

Wysyłka

Wysyłka do realizacji.

Pola
name

string

Wymagane. Identyfikator. Tego ustawienia nie można później zmienić.

source_hub

string

Wymagane. Centrum, w którym dostawa jest dostępna.

destination_hub

string

Wymagane. Centrum, do którego musi zostać dostarczona przesyłka.

departure_time

DateTime

Wymagane. Godzina odjazdu.

arrival_time

DateTimeRange

Wymagane. Oczekiwana godzina przyjazdu (tzn. łagodne ograniczenie).

arrival_earliness_tardiness_cost

EarlinessTardiness

Opcjonalnie. Z gwarancji jakości usług wynika, że ten czas może zostać przekroczony z pewną karą. (Jeśli przekroczysz limit, pakiet nie będzie już bardziej przydatny). Kara jest określana przez funkcję opóźnienia (w minutach).

size[]

ValueDimension

Opcjonalnie. Używane z pojemnością pojemności pojazdu i centrum.

revenue

double

Opcjonalnie. Przychody z tego pakietu (używane tylko do obliczenia nagrody), tj. cena, jaką płaci strona dokonująca płatności. Jeśli zasada nie jest skonfigurowana, przychody są obliczane przez system (w zależności od tego, czy dla tej dostawy zostanie wygenerowany nowy wiersz).

UpdateHubRequest

Komunikat żądania dla metody UpdateHub.

Pola
hub

Hub

Wymagane. Centrum do aktualizacji.

Pole name centrum służy do identyfikowania centrum, które ma być aktualizowane. Format: „sieci/{sieć}/hubs/{hub}”

update_mask

FieldMask

Opcjonalnie. Lista pól do zaktualizowania.

UpdateLineRequest

Komunikat żądania dla metody UpdateLine.

Pola
line

Line

Wymagane. Wiersz do zaktualizowania.

Pole name tego wiersza służy do identyfikowania wiersza do zaktualizowania. Format: „sieci/{sieć}/linii/{line}”

update_mask

FieldMask

Opcjonalnie. Lista pól do zaktualizowania.

UpdateLineRotationRequest

Komunikat żądania dla metody UpdateLineRotation.

Pola
line_rotation

LineRotation

Wymagane. Sieć, która ma zostać zaktualizowana.

Pole name rotacji służy do identyfikowania rotacji, która ma być zaktualizowana. Format: „networks/{network}/lines/{line}/rotations/{rotation}"

update_mask

FieldMask

Opcjonalnie. Lista pól do zaktualizowania.

UpdateNetworkRequest

Komunikat żądania dla metody UpdateNetwork.

Pola
network

Network

Wymagane. Sieć, która ma zostać zaktualizowana.

Pole name sieci służy do identyfikowania sieci, która ma być zaktualizowana. Format: „sieci/{sieć}”

update_mask

FieldMask

Opcjonalnie. Lista pól do zaktualizowania.

UpdatePathRequest

Komunikat żądania dla metody UpdatePath.

Pola
path

Path

Wymagane. Nowa ścieżka dostawy.

UpdateVehicleRequest

Komunikat żądania dla metody UpdateVehicle.

Pola
vehicle

Vehicle

Wymagane. Pojazd do zaktualizowania.

Pole name pojazdu służy do jego identyfikacji. Format: „sieci/{sieć}/pojazdy/{pojazd}”

update_mask

FieldMask

Opcjonalnie. Lista pól do zaktualizowania.

ValueDimension

Wartość wzdłuż jednego wstępnie zdefiniowanego wymiaru. Pole value musi mieć ustawiony odpowiedni typ dimension.

Pola
value

int64

Opcjonalnie. konw.

dimension

string

Wymagane. Wymiar.

Pojazd

Brak nazwy – jest przechowywany jako klucz mapy w sieci.

Pola
name

string

Wymagane. Identyfikator. Tego ustawienia nie można później zmienić.

capacities[]

ValueDimension

Opcjonalnie. Charakterystyka pojazdu.

cost

PricingStrategy

Wymagane. Koszt korzystania z pojazdu. To są funkcje jednego argumentu: odległość, jaką pokonuje pojazd, ciężar, jaki może transportować pojazd, liczba palet, które może transportować pojazd. Te funkcje uwzględniają koszty konserwacji, paliwa i obsługi. Może to obejmować koszt z góry (płacony po użyciu pojazdu, co jest szczególnie przydatne w przypadku zleceń podwykonawców).

pricing

PricingStrategy

Opcjonalnie. Cena do zapłacenia przez stronę płacącą, tylko wtedy, gdy pojazd jest używany w wygenerowanej linii (tj. nie należy do sieci wejściowej).

allowed_for_generated_lines

bool

Wymagane. Określa, czy ten pojazd może być używany do generowania linii. Jeśli ustawisz wartość false, pojazd zostanie ograniczony do wstępnie zdefiniowanych linii tam, gdzie jest dozwolony.

vehicle_position_constraints[]

VehiclePositionConstraint

Opcjonalnie. Wymuszone pozycje bieżącego pojazdu wraz z czasem. Możesz na przykład użyć wpisów, aby modelować fakt, że pojazd, który rozpoczyna się lub kończy w danym centrum.

VehiclePositionConstraint

Ograniczenie dotyczące pozycji pojazdu.

Pola
time

DateTime

Czas ograniczenia.

hub_id

string

Centrum ograniczenia.