Package google.research.middlemileoptimization.v1

索引

MiddleMileOptimization

管理物流網路與內部運送包裹的服務。這項通訊協定為無狀態 (訊息是獨立作業),不過背後的服務具有高度狀態 (接收訊息可能會大幅變更許多方法的回覆,例如轉送貨品可能會改變其他貨品的傳送方式)。

CommitPath

rpc CommitPath(CommitPathRequest) returns (Path)

承諾運送路徑,表示日後無法變更 (即便使用者是使用者,或儲存至由 MakeVehicleUnavailable、MakeHubUnavailable 和 MakeLineUnavailable 方法表示) 的不可抗力/行為。這個方法無法用於標記路徑的特定修訂版本。

CreateHub

rpc CreateHub(CreateHubRequest) returns (Hub)

可建立 Hub。

CreateLine

rpc CreateLine(CreateLineRequest) returns (Line)

畫一條線。

CreateLineRotation

rpc CreateLineRotation(CreateLineRotationRequest) returns (LineRotation)

建立 LineRotation。

CreateNetwork

rpc CreateNetwork(CreateNetworkRequest) returns (Network)

建立網路。

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

建立交通工具。

DeleteHub

rpc DeleteHub(DeleteHubRequest) returns (Empty)

刪除 Hub。

DeleteLine

rpc DeleteLine(DeleteLineRequest) returns (Empty)

刪除線條。

DeleteLineRotation

rpc DeleteLineRotation(DeleteLineRotationRequest) returns (Empty)

刪除 LineRotation。

DeleteNetwork

rpc DeleteNetwork(DeleteNetworkRequest) returns (Empty)

刪除網路。

DeleteShipment

rpc DeleteShipment(DeleteShipmentRequest) returns (Empty)

刪除出貨。

DeleteVehicle

rpc DeleteVehicle(DeleteVehicleRequest) returns (Empty)

刪除車輛。

GetHub

rpc GetHub(GetHubRequest) returns (Hub)

取得 Hub 詳細資料。

GetLine

rpc GetLine(GetLineRequest) returns (Line)

取得線條的詳細資料。

GetLineRotation

rpc GetLineRotation(GetLineRotationRequest) returns (LineRotation)

取得 LineRotation 的詳細資料。

GetNetwork

rpc GetNetwork(GetNetworkRequest) returns (Network)

取得網路的詳細資料。

GetShipment

rpc GetShipment(GetShipmentRequest) returns (Shipment)

取得出貨的詳細資料。

GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

取得車輛的詳細資料。

ListHubs

rpc ListHubs(ListHubsRequest) returns (ListHubsResponse)

列出中樞。

ListLineRotations

rpc ListLineRotations(ListLineRotationsRequest) returns (ListLineRotationsResponse)

列出線路。

ListLines

rpc ListLines(ListLinesRequest) returns (ListLinesResponse)

列出線條。

ListNetworks

rpc ListNetworks(ListNetworksRequest) returns (ListNetworksResponse)

列出網路。

ListPaths

rpc ListPaths(ListPathsRequest) returns (ListPathsResponse)

傳回目前可用的所有路徑。這種方法為等冪,沒有副作用。

ListShipments

rpc ListShipments(ListShipmentsRequest) returns (ListShipmentsResponse)

列出出貨。

ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

列出車輛。

MakeHubAvailable

rpc MakeHubAvailable(MakeHubAvailableRequest) returns (MakeHubAvailableResponse)

可建立中樞。

MakeHubUnavailable

rpc MakeHubUnavailable(MakeHubUnavailableRequest) returns (MakeHubUnavailableResponse)

無法使用中樞。

MakeLineAvailable

rpc MakeLineAvailable(MakeLineAvailableRequest) returns (MakeLineAvailableResponse)

會顯示路線。

MakeLineUnavailable

rpc MakeLineUnavailable(MakeLineUnavailableRequest) returns (MakeLineUnavailableResponse)

無法顯示線條。

MakeVehicleAvailable

rpc MakeVehicleAvailable(MakeVehicleAvailableRequest) returns (MakeVehicleAvailableResponse)

提供車輛。

MakeVehicleUnavailable

rpc MakeVehicleUnavailable(MakeVehicleUnavailableRequest) returns (MakeVehicleUnavailableResponse)

車輛無法使用。

RouteShipment

rpc RouteShipment(RouteShipmentRequest) returns (RouteShipmentResponse)

安排新的出貨商品。這個作業與建立類似,只是表示狀態變更。

UpdateHub

rpc UpdateHub(UpdateHubRequest) returns (Hub)

更新 Hub。

UpdateLine

rpc UpdateLine(UpdateLineRequest) returns (Line)

更新一行。

UpdateLineRotation

rpc UpdateLineRotation(UpdateLineRotationRequest) returns (LineRotation)

更新 LineRotation。

UpdateNetwork

rpc UpdateNetwork(UpdateNetworkRequest) returns (Network)

更新網路。

UpdatePath

rpc UpdatePath(UpdatePathRequest) returns (Path)

變更運送路徑:狀態會包含使用者透過這個呼叫所設定的狀態,而不是使用服務運算的路徑。

UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

更新車輛。

AnnotatedPathSegment

代表路徑中具有更多多餘資訊,可以根據包含的 PathSegment 和 Network 計算的部分。這些訊息通常是由 API 伺服器傳回。

欄位
segment

PathSegment

必要欄位。區隔已加註。

arrival_time

DateTime

僅供輸出。這個路段的抵達時間。

departure_time

DateTime

僅供輸出。這個路段的出發時間。

is_committed

bool

僅供輸出。確認 API 客戶是否決定提交這部分的路徑。

segment_cost_constant

double

僅供輸出。這個區隔的固定費用。

segment_cost_due_to_vehicle

map<string, double>

僅供輸出。每個維度一個項目。

segment_cost_due_to_departure

double

僅供輸出。因線條旋轉而產生的費用:出發。

segment_cost_due_to_arrival

double

僅供輸出。因線條旋轉而產生的費用:抵達。

CommitPathRequest

CommitPath 方法的要求訊息。

欄位
name

string

必要欄位。必須修訂路徑的運送名稱。格式:「networks/{network}/shipments/{shipment}」

聯集欄位 path_to_commit。應修訂的路徑或路徑部分。path_to_commit 只能是下列其中一項:
complete_shipment_path

PathToCommit

從來源到目的地的路徑區段。

segments

IncompletePathToCommit

從來源到目的地的路徑片段子集。

IncompletePathToCommit

修訂路徑的一部分,例如來源和目的地之間的某些路段。

欄位
segments[]

PathSegment

必要欄位。從來源到目的地的路徑片段子集。

PathToCommit

從來源到目的地的完整路徑。

欄位
segments[]

PathSegment

必要欄位。區隔必須依照來源和目的地的順序排列。

CreateHubRequest

CreateHub 方法的要求訊息。

欄位
parent

string

必要欄位。用來建立此中心的父項資源。格式:「networks/{network}」

hub_id

string

必要欄位。待建立中樞的 ID。

hub

Hub

必要欄位。要建立的中樞。

CreateLineRequest

CreateLine 方法的要求訊息。

欄位
parent

string

必要欄位。用來建立這行程式碼的父項資源。格式:「networks/{network}」

line_id

string

必要欄位。待建立行的 ID。

line

Line

必要欄位。要建立的線條。

CreateLineRotationRequest

CreateLineRotation 方法的要求訊息。

欄位
parent

string

必要欄位。用來建立這個線條旋轉的父項資源。格式:「networks/{network}/lines/{line}」

line_rotation_id

string

必要欄位。要建立的行旋轉 ID。

line_rotation

LineRotation

必要欄位。要建立的線條旋轉。

CreateNetworkRequest

CreateNetwork 方法的要求訊息。

欄位
network_id

string

必要欄位。待建立網路的 ID。

network

Network

必要欄位。要建立的網路。

CreateVehicleRequest

CreateVehicle 方法的要求訊息。

欄位
parent

string

必要欄位。用來建立這輛車的父項資源。格式:「networks/{network}」

vehicle_id

string

必要欄位。待建立車輛的 ID。

vehicle

Vehicle

必要欄位。要建立的車輛。

CrossDockingCapacity

中樞的整體跨文件處理能力。

欄位
capacity_per_hour[]

ValueDimension

選用設定。每個維度的交叉編碼功能容量。

CrossDockingTime

中樞的整體跨記錄使用時間。

欄位
time_constant

Duration

選用設定。跨文件剖析作業的固定時間。

time

SeparableNDFunction

選用設定。區隔可說是簡化假設。

DateTimeRange

兩個 DateTime 之間的時間範圍。設定尖端的日期時間時,請使用 start == end。

google/type/interval.proto 很類似,但卻會牽涉到實際時間 (我們只關心民用時間)。

欄位
first_date

DateTime

範圍的起點。

last_date

DateTime

電量耗盡前的行駛距離

DeleteHubRequest

DeleteHub 方法的要求訊息。

欄位
name

string

必要欄位。要刪除的中樞名稱。格式:「networks/{network}/hubs/{hub}」

DeleteLineRequest

DeleteLine 方法的要求訊息。

欄位
name

string

必要欄位。要刪除的行名稱。格式:「networks/{network}/lines/{line}」

force

bool

選用設定。如果設為 true,請刪除子項資源。

DeleteLineRotationRequest

DeleteLineRotation 方法的要求訊息。

欄位
name

string

必要欄位。要刪除的線條名稱。格式:「networks/{network}/lines/{line}/rotations/{rotation}」

DeleteNetworkRequest

DeleteNetwork 方法的要求訊息。

欄位
name

string

必要欄位。要刪除的網路名稱。格式:「networks/{network}」

force

bool

選用設定。如果設為 true,請刪除子項資源。

DeleteShipmentRequest

DeleteShipment 方法的要求訊息。

欄位
name

string

必要欄位。要刪除的運送名稱。格式:「networks/{network}/shipments/{shipment}」

DeleteVehicleRequest

DeleteVehicle 方法的要求訊息。

欄位
name

string

必要欄位。要刪除的車輛名稱。格式:「networks/{network}/vehicles/{vehicle}」

DistanceMatrixEntry

來源中心與目的地中樞之間的距離。

欄位
source_hub

string

必要欄位。來源中樞。

destination_hub

string

必要欄位。目的地中樞。

weights[]

ValueDimension

必要欄位。中樞之間的距離,以多種維度測量。

EarlinessTardiness

因貨物延遲或延遲抵達/出發而產生的費用函式 (軟性限制)。

欄位
maximum_earliness

Duration

選用設定。最大耳朵數上限。僅供費用使用。

maximum_tardiness

Duration

選用設定。最大允許品種。僅供費用使用。

earliness_cost

Function1D

選用設定。耳塞費。如果沒有為耳罩式付費,則為未設定。

tardiness_cost

Function1D

選用設定。焦慮成本。如果沒有這種特性,則未設定。

函式 1D

一個引數的函式。

欄位
聯集欄位 function。函式引數的單位應為:- if a weight: kg - if a time: min - 如果數量:1 function 只能為下列其中一項:
constant

double

函式為常數。

pwl

PieceWiseAffineFunction

這個函式屬於分段線性。

GeneratedLineAndRotation

由這個 API (而非 API 客戶) 產生一行程式碼的輪替憑證。本身的限制較少,而且可以使用任何車輛 (除非 API 客戶在後續呼叫中做出其他決定)。

欄位
arrival_times

map<string, DateTime>

僅供輸出。對應中樞 ID 和時間。這張對應應有相同的鍵 (刪除來源中樞,沒有抵達時間)。

departure_times

map<string, DateTime>

僅供輸出。對應中樞 ID 和時間。這張地圖應有相同的按鍵 (減去目的地中樞,沒有出發時間)。

GetHubRequest

GetHub 方法的要求訊息。

欄位
name

string

必要欄位。要擷取的中樞名稱,格式:「networks/{network}/hubs/{hub}」

GetLineRequest

GetLine 方法的要求訊息。

欄位
name

string

必要欄位。要擷取的網路名稱。格式:「networks/{network}/lines/{line}」

GetLineRotationRequest

GetLineRotation 方法的要求訊息。

欄位
name

string

必要欄位。要擷取的線條旋轉名稱。格式:「networks/{network}/lines/{line}/rotations/{rotation}」

GetNetworkRequest

GetNetwork 方法的要求訊息。

欄位
name

string

必要欄位。要擷取的網路名稱。格式:「networks/{network}」

GetShipmentRequest

GetShipment 方法的要求訊息。

欄位
name

string

必要欄位。要擷取的運送名稱。格式:「networks/{network}/shipments/{shipment}」

GetVehicleRequest

GetVehicle 方法的要求訊息。

欄位
name

string

必要欄位。要擷取的車輛名稱。格式:「networks/{network}/vehicles/{vehicle}」

中樞

必須將出貨至其他中樞裝置。

欄位
name

string

必要欄位。ID。設定完成後即無法更新。

position

LatLng

選用設定。計算實際路徑的位置。

opening_times[]

DateTimeRange

必要欄位。營業時間。目前,使用粗略估計:每次中心開幕時,一個項目 (如果員工有午休時間,但目前無人工作,當天就會有兩個項目)。

cross_docking_capacity

CrossDockingCapacity

選用設定。完整中樞的容量。

cross_docking_time

CrossDockingTime

選用設定。每輛車執行一次跨文件作業的時間。

IntegerRange

整數的範圍。

欄位
start_value

int32

如未設定,系統會開啟時間間隔。

end_value

int32

如未設定,系統會開啟時間間隔。

折線圖

按照指定頻率操作的線。

欄位
name

string

必要欄位。ID。設定完成後即無法更新。

hub_ids[]

string

必要欄位。這條路線呼叫的中樞清單,按照順序車輛停靠在其抵達的位置。

LineRotation

車輛在特定時間開始行駛這條路線。

欄位
name

string

必要欄位。ID。設定完成後即無法更新。

arrival_times

map<string, DateTimeRange>

選用設定。可以免費出發的範圍 (如果未點,則由系統決定實際抵達時間)。這張對應應有相同的鍵 (刪除來源中樞,沒有抵達時間)。

departure_times

map<string, DateTimeRange>

選用設定。允許抵達的地點無須付費 (也就是說,如果不點,則實際出發時間是由系統決定)。這張地圖應有相同的按鍵 (減去目的地中樞,沒有出發時間)。

departure_earliness_tardiness_costs

map<string, EarlinessTardiness>

選用設定。出境的耳道/事故成本和邊界。這張地圖應有相同的按鍵 (減去目的地中樞,沒有出發時間)。

arrival_earliness_tardiness_costs

map<string, EarlinessTardiness>

選用設定。抵達時須留意的耳道/交通事故費用和邊界。這張地圖應有相同的索引鍵 (刪除來源中樞,沒有抵達時間)。

vehicles[]

string

選用設定。可進行此路線旋轉的車輛清單 (即許可清單)。如果 number_vehicles 降至一個對應車輛數量的值,則所有這些車輛都會分配到線條旋轉角度。如果沒有車輛,所有車輛即視同有空。

fixed_price

PricingStrategy

選用設定。駕駛這個路線的任何車輛費用,無論車輛為何 (駕駛、維護人員等)。

maximum_number_vehicles

IntegerRange

選用設定。可指派給此旋轉動作的車輛數量上限。如未設定:此旋轉角度的車輛沒有限制。否則,可分配至此旋轉車數量的車輛數量上限 (在許可清單 vehicle_ids 中)。如果值為 0,就會停用此旋轉機制 (不允許任何車輛)。

ListHubsRequest

ListHubs 方法的要求訊息。

欄位
parent

string

必要欄位。擁有此中心集合的父項。格式:「networks/{network}」

page_size

int32

選用設定。要傳回的中樞數量上限。服務傳回的產品數量可能會少於這個值。如未指定,系統最多會傳回 50 個中樞。許可的最大值為 1000;超出的數值將一律指定為 1000。

page_token

string

選用設定。屬於接收自前一個 ListHubs 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時,提供至 ListHubs 的所有其他參數須與提供網頁權杖的呼叫相符。

ListHubsResponse

ListHubs 方法的回應訊息。

欄位
hubs[]

Hub

指定網路的中樞。

next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListLineRotationsRequest

ListLineRotations 方法的要求訊息。

欄位
parent

string

必要欄位。父項,擁有這個線條旋轉集合的父項。格式:「networks/{network}/lines/{line}」

page_size

int32

選用設定。要傳回的線條旋轉數量上限。服務傳回的產品數量可能會少於這個值。如未指定,最多會傳回 50 LineRotations。許可的最大值為 1000;超出的數值將一律指定為 1000。

page_token

string

選用設定。屬於接收自前一個 ListLineRotations 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時,提供至 ListLineRotations 的所有其他參數須與提供網頁權杖的呼叫相符。

ListLineRotationsResponse

ListLineRotations 方法的回應訊息。

欄位
line_rotations[]

LineRotation

線條會自指定的網路和線條旋轉。

next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListLinesRequest

ListLines 方法的要求訊息。

欄位
parent

string

必要欄位。擁有此行集合的父項。格式:「networks/{network}」

page_size

int32

選用設定。要傳回的行數上限。服務傳回的產品數量可能會少於這個值。如未指定,最多會傳回 50 行。許可的最大值為 1000;超出的數值將一律指定為 1000。

page_token

string

選用設定。屬於接收自前一個 ListLines 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時,提供至 ListLines 的所有其他參數須與提供網頁權杖的呼叫相符。

ListLinesResponse

ListLines 方法的回應訊息。

欄位
lines[]

Line

指定網路的行。

next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListNetworksRequest

ListNetworks 方法的要求訊息。

欄位
page_size

int32

選用設定。要傳回的網路數量上限。服務傳回的產品數量可能會少於這個值。如未指定,最多將傳回 50 個網路。許可的最大值為 1000;超出的數值將一律指定為 1000。

page_token

string

選用設定。屬於接收自前一個 ListNetworks 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時,提供至 ListNetworks 的所有其他參數須與提供網頁權杖的呼叫相符。

ListNetworksResponse

ListNetworks 方法的回應訊息。

欄位
networks[]

Network

聯播網清單。

next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListPathsRequest

ListPaths 方法的要求訊息。

欄位
parent

string

必要欄位。必須傳送路徑的網路名稱。格式:「networks/{network}」

page_size

int32

選用設定。要傳回的網路數量上限。服務傳回的產品數量可能會少於這個值。如未指定,最多將傳回 50 個網路。許可的最大值為 1000;超出的數值將一律指定為 1000。

page_token

string

選用設定。屬於接收自前一個 ListNetworks 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時,提供至 ListNetworks 的所有其他參數須與提供網頁權杖的呼叫相符。

ListPathsResponse

ListPaths 方法的回應訊息。

欄位
paths[]

Path

路徑清單。

next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListShipmentsRequest

ListShipments 方法的要求訊息。

欄位
parent

string

必要欄位。該組貨物的上層發布商。格式:「networks/{network}」

page_size

int32

選用設定。要退貨的運送數量上限。服務傳回的產品數量可能會少於這個值。如未指定,最多將退還 50 件商品。許可的最大值為 1000;超出的數值將一律指定為 1000。

page_token

string

選用設定。屬於接收自前一個 ListShipments 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時,提供至 ListShipments 的所有其他參數須與提供網頁權杖的呼叫相符。

ListShipmentsResponse

ListShipments 方法的回應訊息。

欄位
shipments[]

Shipment

指定網路的出貨。

next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListVehiclesRequest

ListVehicles 方法的要求訊息。

欄位
parent

string

必要欄位。車輛集合的母公司。格式:「networks/{network}」

page_size

int32

選用設定。要傳回的車輛數量上限。服務傳回的產品數量可能會少於這個值。如未指定,最多會傳回 50 輛車。許可的最大值為 1000;超出的數值將一律指定為 1000。

page_token

string

選用設定。屬於接收自前一個 ListVehicles 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時,提供至 ListVehicles 的所有其他參數須與提供網頁權杖的呼叫相符。

ListVehiclesResponse

ListVehicles 方法的回應訊息。

欄位
vehicles[]

Vehicle

指定網路的車輛。

next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

MakeHubAvailableRequest

MakeHubAvailable 方法的要求訊息。

欄位
name

string

必要欄位。提供的中樞名稱,格式:「networks/{network}/hubs/{hub}」

availability_starts[]

DateTime

必要欄位。開始供應的時段。而且必須是未來的時間點。如果缺少這個欄位,可用性會在收到訊息時開始計算。

MakeHubAvailableResponse

MakeHubAvailable 方法的回應訊息。

欄位
name

string

已更新服務中斷情形的中樞名稱。格式:「networks/{network}/hubs/{hub}」

path[]

Path

更新的路徑。

MakeHubUnavailableRequest

MakeHubUnavailable 方法的要求訊息。

欄位
name

string

必要欄位。無法使用的中樞名稱。格式:「networks/{network}/hubs/{hub}」

unavailability_starts[]

DateTime

必要欄位。無法使用的時段。而且必須是未來的時間點。如果沒有這個欄位,系統將在收到訊息時自動停用。

MakeHubUnavailableResponse

MakeHubUnavailable 方法的回應訊息。

欄位
name

string

已更新服務中斷情形的中樞名稱。格式:「networks/{network}/hubs/{hub}」

path[]

Path

更新的路徑。

MakeLineAvailableRequest

MakeHubAvailable 方法的要求訊息。

欄位
name

string

必要欄位。要顯示的行名稱。格式:「networks/{network}/lines/{line}」

availability_starts[]

DateTime

必要欄位。開始供應的時段。而且必須是未來的時間點。如果缺少這個欄位,可用性會在收到訊息時開始計算。

MakeLineAvailableResponse

MakeLineAvailable 方法的回應訊息。

欄位
name

string

更新無法使用情形的行名稱。格式:「networks/{network}/lines/{line}」

path[]

Path

更新的路徑。

MakeLineUnavailableRequest

MakeLineUnavailable 方法的要求訊息。

欄位
name

string

必要欄位。不可用的行名稱。格式:「networks/{network}/lines/{line}」

unavailability_starts[]

DateTime

必要欄位。無法使用的時段。而且必須是未來的時間點。如果沒有這個欄位,系統將在收到訊息時自動停用。

MakeLineUnavailableResponse

MakeLineUnavailable 方法的回應訊息。

欄位
name

string

更新無法使用情形的行名稱。格式:「networks/{network}/lines/{line}」

path[]

Path

更新的路徑。

MakeVehicleAvailableRequest

MakeVehicleAvailable 方法的要求訊息。

欄位
name

string

必要欄位。提供服務的車輛名稱。格式:「networks/{network}/vehicle/{vehicle}」

availability_starts[]

DateTime

必要欄位。開始供應的時段。而且必須是未來的時間點。如果缺少這個欄位,可用性會在收到訊息時開始計算。

MakeVehicleAvailableResponse

MakeVehicleAvailable 方法的回應訊息。

欄位
name

string

已更新供應情形的車輛名稱。格式:「networks/{network}/vehicles/{vehicle}」

path[]

Path

更新的路徑。

MakeVehicleUnavailableRequest

MakeVehicleUnavailable 方法的要求訊息。

欄位
name

string

必要欄位。無法使用的車輛名稱。格式:「networks/{network}/vehicles/{vehicle}」

unavailability_starts[]

DateTime

必要欄位。無法使用的時段。而且必須是未來的時間點。如果沒有這個欄位,系統將在收到訊息時自動停用。

MakeVehicleUnavailableResponse

MakeVehicleUnavailable 方法的回應訊息。

欄位
name

string

供應情形已更新的車輛名稱。格式:「networks/{network}/vehicles/{vehicle}」

path[]

Path

更新的路徑。

網路

說明可使用的完整現有網路。特定 API 客戶可能會有多個網路 (例如主要網路,且未來可能需要修改才能評估)。

欄位
name

string

必要欄位。ID。設定完成後即無法更新。

dimensions[]

ValueDimension

距離、重量、棧板等,以及縮放 (將浮點值對應到整數)。

pricing

PricingStrategy

選用設定。寄件者針對沒有專屬專線出貨的商品所支付的價格。

currency_code

string

選用設定。整個聯播網使用的單一貨幣單位。每位 API 客戶可以針對不同的聯播網有多個不同的單位;一個聯播網只能有一個貨幣單位。單位必須採用 ISO 4217 編碼,例如 google3/google/type/money.proto。

time_step

Duration

選用設定。時間區分。系統會及時以這個精確度來輸出決策。在內部,狀態會以此精確度保留。

distance_matrix[]

DistanceMatrixEntry

選用設定。距離矩陣 (代表加權方向邊緣清單)。

路徑

網路內的運送路徑。

欄位
shipment

string

必要欄位。已說明路徑的貨運。

segments[]

AnnotatedPathSegment

必要欄位。路徑部分。

departure_time

DateTime

僅供輸出。貨品的實際出發時間。

arrival_time

DateTime

僅供輸出。貨品的實際抵達時間。

incurred_penalties

double

僅供輸出。未遵守軟性限製而處罰。

cost_constant

double

僅供輸出。這項貨品的固定費用。

cost

map<string, double>

僅供輸出。依元件區分的費用。

PathSegment

代表部分路徑,可由 API 客戶傳送至 API 伺服器 (例如狀態變更),或 API 伺服器傳送給 API 客戶 (例如轉送貨運)。

欄位
source_hub

string

必要欄位。區隔來源。

destination_hub

string

必要欄位。區隔的目的地。

line

string

必要欄位。這個路段跟隨線。

line_rotation

string

必要欄位。系統遵循這個區隔的旋轉作業。

vehicle

string

必要欄位。後面緊接著這個路段。

PieceWiseAffineFunction

圓周率線性函式,僅限於一個引數。設計類似 https://github.com/google/or-tools/blob/stable/ortools/util/piecewise_linear_function.h

欄位
segments[]

PieceWiseAffineSegment

函式的線性區段。

PieceWiseAffineSegment

分段線性函式的一個區段。

欄位
start_x

double

區隔開頭:x。

start_y

double

區隔開頭:y。

end_x

double

區隔結束時:x。

end_y

double

區隔結束時:y。

PricingStrategy

定價策略。

欄位
聯集欄位 pricing_strategy。定價策略。pricing_strategy 只能是下列其中一項:
separable

SeparableNDFunction

定價策略是將多項變數分開的。

RouteShipmentRequest

RouteShipment 方法的要求訊息。

欄位
parent

string

必要欄位。父項,這是運送訂單所在的網路。格式:「networks/{network}」

shipment

Shipment

必要欄位。要轉送的貨品。

RouteShipmentResponse

RouteShipment 方法的回應訊息。

欄位
shipment

Shipment

剛剛建立的出貨。

paths[]

Path

因轉送出貨而變更的路徑。這個欄位至少包含一個項目,也就是必須轉送的運送路徑。它可以包含其他運送路徑,以反映內部狀態的變更。

lines[]

GeneratedLineAndRotation

安排出貨時建立的線條旋轉。顏色可能為空白,或包含其他運送項目的旋轉資訊,以反映內部狀態的變更。

SeparableNDFunction

N 引數的函式,以單一引數的函式總和表示。

欄位
components

map<string, Function1D>

函式的元件,每個引數/維度各有一個項目。

constant_price

double

函式的常數部分。

運送地址

要表演的貨品。

欄位
name

string

必要欄位。ID。設定完成後即無法更新。

source_hub

string

必要欄位。出貨中心。

destination_hub

string

必要欄位。此貨品交付目的地的中心。

departure_time

DateTime

必要欄位。出發時間。

arrival_time

DateTimeRange

必要欄位。預計抵達時間 (即軟性限制)。

arrival_earliness_tardiness_cost

EarlinessTardiness

選用設定。服務水準協議表示時間可能會超過,但會受到一定處分。(如果晚於大小上限,包裹就沒有用處)。處分取決於延遲函式 (以分鐘為單位)。

size[]

ValueDimension

選用設定。用於車輛和集線器容量。

revenue

double

選用設定。此套裝方案的收益 (僅用於計算獎勵),亦即由付款方支付的價格。如未設定,系統會計算收益 (取決於是否為此貨物產生新行)。

UpdateHubRequest

UpdateHub 方法的要求訊息。

欄位
hub

Hub

必要欄位。要更新的中樞。

中樞的 name 欄位是用來識別要更新的中樞,格式:「networks/{network}/hubs/{hub}」

update_mask

FieldMask

選用設定。要更新的欄位清單。

UpdateLineRequest

UpdateLine 方法的要求訊息。

欄位
line

Line

必要欄位。要更新的線條。

線條的 name 欄位是用來識別要更新的行。格式:「networks/{network}/lines/{line}」

update_mask

FieldMask

選用設定。要更新的欄位清單。

UpdateLineRotationRequest

UpdateLineRotation 方法的要求訊息。

欄位
line_rotation

LineRotation

必要欄位。要更新的網路。

旋轉的 name 欄位用於識別要更新的旋轉資料。格式:「networks/{network}/lines/{line}/rotations/{rotation}」

update_mask

FieldMask

選用設定。要更新的欄位清單。

UpdateNetworkRequest

UpdateNetwork 方法的要求訊息。

欄位
network

Network

必要欄位。要更新的網路。

網路的 name 欄位是用於識別要更新的網路。格式:「networks/{network}」

update_mask

FieldMask

選用設定。要更新的欄位清單。

UpdatePathRequest

UpdatePath 方法的要求訊息。

欄位
path

Path

必要欄位。全新的運送路徑。

UpdateVehicleRequest

UpdateVehicle 方法的要求訊息。

欄位
vehicle

Vehicle

必要欄位。要更新的車輛。

車輛的 name 欄位是用來識別要更新的車輛。格式:「networks/{network}/vehicles/{vehicle}」

update_mask

FieldMask

選用設定。要更新的欄位清單。

ValueDimension

緊接一個預先定義維度的值。value 欄位必須設為 dimension 的對應類型。

欄位
value

int64

選用設定。價值

dimension

string

必要欄位。尺寸。

車輛

沒有名稱,而是以對應鍵的形式儲存在網路中。

欄位
name

string

必要欄位。ID。設定完成後即無法更新。

capacities[]

ValueDimension

選用設定。車輛特性。

cost

PricingStrategy

必要欄位。車輛使用費用。這些是單一引數的功能:車輛行駛的距離、交通工具運輸的重量、交通工具運輸的棧板數量。這些功能會考量維護、燃料和處理費用。這類費用可能包含預付費用 (在用車後付費,最適合分包契約)。

pricing

PricingStrategy

選用設定。付費方要支付的價格,前提是車輛是用於產生的路線中 (即非輸入網路的一部分)。

allowed_for_generated_lines

bool

必要欄位。這輛車是否可用於產生的路線。如果設為 false,車輛僅限於許可的預先定義路線。

vehicle_position_constraints[]

VehiclePositionConstraint

選用設定。目前車輛的強制定位和時間。例如,您可以使用項目來模擬車輛在特定中樞上開始或結束的車輛。

VehiclePositionConstraint

限制車輛位置。

欄位
time

DateTime

限制條件的時間。

hub_id

string

限制的中樞。