Package google.research.middlemileoptimization.v1

索引

• MiddleMileOptimization（接口）
• AnnotatedPathSegment（消息）
• CommitPathRequest（消息）
• CommitPathRequest.IncompletePathToCommit（消息）
• CommitPathRequest.PathToCommit（消息）
• CreateHubRequest（消息）
• CreateLineRequest（消息）
• CreateLineRotationRequest（消息）
• CreateNetworkRequest（消息）
• CreateVehicleRequest（消息）
• CrossDockingCapacity（消息）
• CrossDockingTime（消息）
• DateTimeRange（消息）
• DeleteHubRequest（消息）
• DeleteLineRequest（消息）
• DeleteLineRotationRequest（消息）
• DeleteNetworkRequest（消息）
• DeleteShipmentRequest（消息）
• DeleteVehicleRequest（消息）
• DistanceMatrixEntry（消息）
• EarlinessTardiness（消息）
• Function1D（消息）
• GeneratedLineAndRotation（消息）
• GetHubRequest（消息）
• GetLineRequest（消息）
• GetLineRotationRequest（消息）
• GetNetworkRequest（消息）
• GetShipmentRequest（消息）
• GetVehicleRequest（消息）
• Hub（消息）
• IntegerRange（消息）
• Line（消息）
• LineRotation（消息）
• ListHubsRequest（消息）
• ListHubsResponse（消息）
• ListLineRotationsRequest（消息）
• ListLineRotationsResponse（消息）
• ListLinesRequest（消息）
• ListLinesResponse（消息）
• ListNetworksRequest（消息）
• ListNetworksResponse（消息）
• ListPathsRequest（消息）
• ListPathsResponse（消息）
• ListShipmentsRequest（消息）
• ListShipmentsResponse（消息）
• ListVehiclesRequest（消息）
• ListVehiclesResponse（消息）
• MakeHubAvailableRequest（消息）
• MakeHubAvailableResponse（消息）
• MakeHubUnavailableRequest（消息）
• MakeHubUnavailableResponse（消息）
• MakeLineAvailableRequest（消息）
• MakeLineAvailableResponse（消息）
• MakeLineUnavailableRequest（消息）
• MakeLineUnavailableResponse（消息）
• MakeVehicleAvailableRequest（消息）
• MakeVehicleAvailableResponse（消息）
• MakeVehicleUnavailableRequest（消息）
• MakeVehicleUnavailableResponse（消息）
• Network（消息）
• Path（消息）
• PathSegment（消息）
• PieceWiseAffineFunction（消息）
• PieceWiseAffineSegment（消息）
• PricingStrategy（消息）
• RouteShipmentRequest（消息）
• RouteShipmentResponse（消息）
• SeparableNDFunction（消息）
• Shipment（消息）
• UpdateHubRequest（消息）
• UpdateLineRequest（消息）
• UpdateLineRotationRequest（消息）
• UpdateNetworkRequest（消息）
• UpdatePathRequest（消息）
• UpdateVehicleRequest（消息）
• ValueDimension（消息）
• Vehicle（消息）
• Vehicle.VehiclePositionConstraint（消息）

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) 列出 Hub。

ListLineRotations
rpc ListLineRotations(ListLineRotationsRequest) returns (ListLineRotationsResponse) 列出 LineRotation。

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) 启用 hub。

MakeHubUnavailable
rpc MakeHubUnavailable(MakeHubUnavailableRequest) returns (MakeHubUnavailableResponse) 使 hub 不可用。

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 必需。将在其中创建此 hub 的父级资源。格式：“networks/{network}”
hub_id	string 必需。要创建的 hub 的标识符。
hub	Hub 必需。要创建的 hub。

CreateLineRequest

CreateLine 方法的请求消息。

字段
parent	string 必需。将在其中创建此行的父资源。格式：“networks/{network}”
line_id	string 必需。要创建的行的标识符。
line	Line 必需。要创建的行。

CreateLineRotationRequest

CreateLineRotation 方法的请求消息。

字段
parent	string 必需。将在其中创建此线条轮播的父级资源。格式：“networks/{network}/lines/{line}”
line_rotation_id	string 必需。要创建的线条旋转的标识符。
line_rotation	LineRotation 必需。要创建的线条旋转。

CreateNetworkRequest

CreateNetwork 方法的请求消息。

字段
network_id	string 必需。要创建的网络的标识符。
network	Network 必需。要创建的网络。

CreateVehicleRequest

CreateVehicle 方法的请求消息。

字段
parent	string 必需。将在其中创建此车辆的父级资源。格式：“networks/{network}”
vehicle_id	string 必需。要创建的车辆的标识符。
vehicle	Vehicle 必需。要创建的车辆。

CrossDockingCapacity

hub 的总跨基座容量。

字段
capacity_per_hour[]	ValueDimension 可选。每个维度的跨基座容量。

CrossDockingTime

hub 的跨基座总时间。

字段
time_constant	Duration 可选。跨基座操作的固定时间。
time	SeparableNDFunction 可选。可分离性是一种简化的假设。

DateTimeRange

两个 DateTime 之间的时间范围。对于逐点日期时间，请使用 start == end。

google/type/interval.proto 也起到类似的作用，但包含实际时间（我们只关心民用时间）。

字段
first_date	DateTime 范围的起点。
last_date	DateTime 范围终点

DeleteHubRequest

DeleteHub 方法的请求消息。

字段
name	string 必需。要删除的 hub 的名称。格式：“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。该函数的参数的统一性应为：- 如果重量为 kg - 如果是时间：min - 如果托盘数为：1 function 只能是下列其中一项：
constant	double 该函数是一个常量。
pwl	PieceWiseAffineFunction 该函数为分段线性函数。

GeneratedLineAndRotation

由此 API（而非 API 客户）生成的线条的一次轮替。它的内在限制较小，并且可以使用任何车辆（除非 API 客户在后续调用中另行决定）。

字段
arrival_times	map<string, DateTime> 仅限输出。hub ID 和时间之间的映射。此映射应具有相同的键（减去来源中心，没有到达时间）。
departure_times	map<string, DateTime> 仅限输出。hub ID 和时间之间的映射。此地图应具有相同的键（去掉目的地枢纽，没有出发时间）。

GetHubRequest

GetHub 方法的请求消息。

字段
name	string 必需。要检索的 hub 的名称。格式：“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}”

Hub

货物必须从一个配送中心运至另一个配送中心。

字段
name	string 必需。标识符。无法更新。
position	LatLng 可选。用于计算实际路径的位置。
opening_times[]	DateTimeRange 必需。开始营业时间。目前，请暂时使用非常粗略的表示方式：每次开放中心时输入一个条目（如果中心的工作人员在午休，而无人在当天工作，则当天将有两个条目）。
cross_docking_capacity	CrossDockingCapacity 可选。整个 hub 的容量。
cross_docking_time	CrossDockingTime 可选。执行一次跨基座操作（每辆车）所需的时间。

IntegerRange

整数范围。

字段
start_value	int32 如果未设置，则间隔开。
end_value	int32 如果未设置，则间隔开。

折线图

按指定频率运营的线路。

字段
name	string 必需。标识符。无法更新。
hub_ids[]	string 必需。此线路要到的发车点列表，按照车辆停靠的顺序排列。

LineRotation

有车辆在特定时间开始运营此线路。

字段
name	string 必需。标识符。无法更新。
arrival_times	map<string, DateTimeRange> 可选。不花钱就允许出车的范围（即，如果不是逐点到达，则实际到达时间由系统决定）。此映射应具有相同的键（减去来源中心，没有到达时间）。
departure_times	map<string, DateTimeRange> 可选。不花钱即可到达的范围（即，如果不是逐点到达，则由系统决定实际出发时间）。此地图应具有相同的键（去掉目的地枢纽，没有出发时间）。
departure_earliness_tardiness_costs	map<string, EarlinessTardiness> 可选。紧急电话/延迟费用和出发边界。此映射应具有相同的键（减去目的地 hub，没有出发时间）。
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 必需。拥有此 hub 集合的父级。格式：“networks/{network}”
page_size	int32 可选。要返回的 hub 数量上限。服务返回的值可能小于此值。如果未指定，则最多返回 50 个 hub。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。
page_token	string 可选。从之前的 ListHubs 调用接收的页面令牌。利用其进行后续页面检索。 进行分页时，提供给 ListHubs 的所有其他参数必须与提供页面令牌的调用匹配。

ListHubsResponse

ListHubs 方法的响应消息。

字段
hubs[]	Hub 来自指定网络的 hub。
next_page_token	string 可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

ListLineRotationsRequest

ListLineRotations 方法的请求消息。

字段
parent	string 必需。父级，拥有此线条旋转集合。格式：“networks/{network}/lines/{line}”
page_size	int32 可选。要返回的最大线条旋转数。服务返回的值可能小于此值。如果未指定，则最多返回 50 个 LineRotation。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。
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 行。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。
page_token	string 可选。从之前的 ListLines 调用接收的页面令牌。利用其进行后续页面检索。 进行分页时，提供给 ListLines 的所有其他参数必须与提供页面令牌的调用匹配。

ListLinesResponse

ListLines 方法的响应消息。

字段
lines[]	Line 来自指定网络的线条。
next_page_token	string 可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

ListNetworksRequest

ListNetworks 方法的请求消息。

字段
page_size	int32 可选。要返回的最大网络数。服务返回的值可能小于此值。如果未指定，则最多返回 50 个网络。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。
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 个网络。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。
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 件货品。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。
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 辆车。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。
page_token	string 可选。从之前的 ListVehicles 调用接收的页面令牌。利用其进行后续页面检索。 进行分页时，提供给 ListVehicles 的所有其他参数必须与提供页面令牌的调用匹配。

ListVehiclesResponse

ListVehicles 方法的响应消息。

字段
vehicles[]	Vehicle 来自指定网络的车辆。
next_page_token	string 可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

MakeHubAvailableRequest

MakeHubAvailable 方法的请求消息。

字段
name	string 必需。要提供的 hub 的名称。格式：“networks/{network}/hubs/{hub}”
availability_starts[]	DateTime 必需。可供使用的时间段。它们必须是未来的时间点。如果没有此字段，则从收到邮件时开始计算空闲状态。

MakeHubAvailableResponse

MakeHubAvailable 方法的响应消息。

字段
name	string 不可用状态已更新的 hub 的名称。格式：“networks/{network}/hubs/{hub}”
path[]	Path 已更新的路径。

MakeHubUnavailableRequest

MakeHubUnavailable 方法的请求消息。

字段
name	string 必需。要设为不可用的 hub 的名称。格式：“networks/{network}/hubs/{hub}”
unavailability_starts[]	DateTime 必需。不可用的时间范围。它们必须是未来的时间点。如果没有此字段，则从收到消息时开始不可用。

MakeHubUnavailableResponse

MakeHubUnavailable 方法的响应消息。

字段
name	string 不可用状态已更新的 hub 的名称。格式：“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 必需。标识符。无法更新。
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 必需。标识符。无法更新。
source_hub	string 必需。提供运单的配送中心。
destination_hub	string 必需。货物必须送达的枢纽。
departure_time	DateTime 必需。出发时间。
arrival_time	DateTimeRange 必需。预期到达时间（即软约束）。
arrival_earliness_tardiness_cost	EarlinessTardiness 可选。服务等级协议 (SLA) 表明，超出此时间可能会造成一些处罚。（如果超过了上限，软件包就不再有用。）惩罚取决于延迟时间（以分钟为单位）。
size[]	ValueDimension 可选。用于载客车辆和集装箱。
revenue	double 可选。此资源包的收入（仅用于计算奖励），即付款方支付的价格。如果未设置，系统将由系统计算收入（具体取决于是否为此运单生成新行）。

UpdateHubRequest

UpdateHub 方法的请求消息。

字段
hub	Hub 必需。要更新的 hub。 hub 的 name 字段用于标识要更新的 hub。格式：“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 必需。标识符。无法更新。
capacities[]	ValueDimension 可选。车辆特性。
cost	PricingStrategy 必需。使用车辆的费用。这些是其中一个参数的函数：车辆行驶的距离、车辆运输的重量以及车辆运输的托盘数。这些函数负责计算维护、燃油和处理费用。这些费用可能包括预付费用（车辆使用后支付，多用于转包）。
pricing	PricingStrategy 可选。仅当车辆在生成的线路（即不属于输入网络的一部分）中使用时，付款方需要支付的价格。
allowed_for_generated_lines	bool 必需。此车辆是否可用于生成的线路。如果设为 false，车辆将只能行驶在允许的预定义线路上。
vehicle_position_constraints[]	VehiclePositionConstraint 可选。当前车辆的强制位置以及时间。例如，使用条目来模拟某辆车在特定集车点发车或结束的事实。

VehiclePositionConstraint

对车辆位置的约束条件。

字段
time	DateTime 限制条件的时间。
hub_id	string 限制条件的中心。