Package google.maps.routeoptimization.v1

int32

执行的配送次数。请注意，取货和送货配对仅计为一次。

Duration

路线或解决方案的总行程时间。

Duration

路线或解决方案的总等待时长。

Duration

路线或解决方案的总延迟时长。

Duration

路线或解决方案的总中断时长。

Duration

路线或解决方案的总访问时长。

Duration

总时长应等于上述所有时长的总和。对于路线，它还对应于：

[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

路线或解决方案的总出行距离。

map<string, VehicleLoad>

整个路线（相应地，解决方案）上达到的最大负荷，针对相应路线（相应地，解决方案）上的每种数量计算，计算方式为所有 Transition.vehicle_loads（相应地，ShipmentRoute.metrics.max_loads。

int32

执行的强制性配送次数。

实验性：此字段的行为或存在状态将来可能会发生变化。

double

已完成的货件的 Shipment.penalty_cost 之和。

实验性：此字段的行为或存在状态将来可能会发生变化。

string

必需。定位项目和位置以进行呼叫。

格式：

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

如果未指定位置，系统将自动选择区域。

AsyncModelConfig

必需。每个购买模型的输入/输出信息，例如文件路径和数据格式。

string

可选。用户定义的模型名称，可供用户用作别名来跟踪模型。

InputConfig

必需。有关输入模型的信息。

OutputConfig

必需。所需的输出位置信息。

BreakRequest

休息顺序。看到 BreakRequest 消息。

FrequencyConstraint

可能适用多个 FrequencyConstraint。它们必须全部由相应 BreakRule 的 BreakRequest 满足。请参阅 FrequencyConstraint。

Timestamp

必需。中断开始时间的下限（含）。

Timestamp

必需。休止开始时间的上限（含）。

Duration

必需。休息时长的下限。必须为正值。

Duration

必需。相应限制的广告插播时长下限。非负。请参阅 FrequencyConstraint 的说明。

Duration

必需。路线中任何时间区间的最大允许跨度，该时间区间不包含至少部分 duration >= min_break_duration 的休息时间。必须为正值。

int64

一种硬性限制，用于将距离限制为最多 max_meters。限值必须是非负数。

int64

一种不强制执行最大距离限制的软限制，但如果违反该限制，则会产生费用，该费用会与模型中定义的其他费用相加，单位相同。

如果定义了 soft_max_meters，则该值必须小于 max_meters，并且必须为非负数。

double

每公里产生的费用，最高可增加至 soft_max_meters，公式如下：

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

route_distance_limit 不支持此费用。

double

如果距离超过 soft_max_meters 限制，则每公里产生的费用。如果距离低于限值，则额外费用为 0；否则，用于计算费用的公式如下：

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

费用必须为非负数。

string

必需。Google Cloud Storage URI。

string

必需。Google Cloud Storage 对象的 URI，格式为 gs://bucket/path/to/object。

ShipmentRoute

要注入的解决方案的路由。原始解决方案可能会省略部分路线。路线和跳过配送的商品必须满足 injected_first_solution_routes 中列出的基本有效性假设。

SkippedShipment

要注入的解决方案的跳过发货。部分内容可能已从原始解决方案中省略。请参阅 routes 字段。

ConstraintRelaxation

针对零个或多个车辆组，指定何时以及在多大程度上放宽限制条件。如果此字段为空，则所有非空车辆路线都会受到完全限制。

Relaxation

将应用于 vehicle_indices 中有车辆的路线上的所有访问的访问限制放宽。

int32

指定访问限制 relaxations 所适用的车辆指数。如果为空，则视为默认值，并且 relaxations 适用于其他 constraint_relaxations 中未指定的所有车辆。最多只能有一个默认值，也就是说，最多只能有一个约束放宽字段为空 vehicle_indices。即使在多个 constraint_relaxations 中，车辆索引也只能列出一次。

如果 interpret_injected_solutions_using_labels 为 true，则车辆索引的映射方式与 ShipmentRoute.vehicle_index 相同（请参阅 fields 注释）。

Level

当满足 threshold_time 及之后和至少 threshold_visit_count 的条件时应用的约束放宽级别。

Timestamp

可应用放松时间 level 的时间或之后的时间。

int32

可应用放松 level 的访问次数（包括该次数）下限。如果 threshold_visit_count 为 0（或未设置），则 level 可能会在车辆启动时直接应用。

如果值为 route.visits_size() + 1，则 level 只能应用于车辆端。如果大于 route.visits_size() + 1，则不会为相应路线应用 level。

DataFormat

必需。输入数据格式。

GcsSource

Google Cloud Storage 位置。这必须是单个对象（文件）。

LatLng

途经点的地理坐标。

int32

与交通流量方向相关的罗盘方向。此值用于指定上下车时要使用的道路一侧。航向值可以介于 0 到 360 之间，其中 0 表示正北航向，90 表示正东航向，依此类推。

string

必需。定位项目或位置以进行呼叫。

格式：

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

如果未指定位置，系统将自动选择区域。

Duration

如果设置了此超时时间，服务器会在超时时间段结束之前或同步请求的服务器截止时间到达之前（以较早者为准）返回响应。

对于异步请求，服务器会在超时时间结束之前生成解决方案（如果可能）。

ShipmentModel

要解决的运输模型。

SolvingMode

默认情况下，求解模式为 DEFAULT_SOLVE (0)。

SearchMode

用于解决请求的搜索模式。

ShipmentRoute

引导优化算法找到与之前解决方案类似的首个解决方案。

在构建第一个解决方案时，模型会受到限制。在第一个解决方案中，未在路线中执行的任何配送都会被隐式跳过，但在后续解决方案中可能会执行这些配送。

解决方案必须满足一些基本有效性假设：

• 对于所有路线，vehicle_index 必须在范围内且不得重复。
• 对于所有访问，shipment_index 和 visit_request_index 必须在范围内。
• 一次只能在一条路线中引用一次配送。
• 取件配送型货件的取件必须在配送之前完成。
• 不得对同一批次货物执行超过一次取货替代方案或送货替代方案。
• 对于所有路线，时间都在增加（即vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time）。
• 只能使用允许的车辆进行配送。如果 Shipment.allowed_vehicle_indices 为空或其 vehicle_index 包含在 Shipment.allowed_vehicle_indices 中，则允许相应车辆。

如果注入的解不可行，系统不一定会返回验证错误，而是可能会返回指示不可行的错误。

InjectedSolutionConstraint

限制优化算法，使其找到与之前解决方案类似的最终解决方案。例如，这可用于冻结已完成或将要完成但不得修改的部分路线。

如果注入的解不可行，系统不一定会返回验证错误，而是可能会返回指示不可行的错误。

ShipmentRoute

如果不为空，则会刷新给定的路线，而不会修改其基础访问序列或出行时间：只会更新其他详细信息。这并不能解决模型。

截至 2020 年 11 月，此方法仅填充非空路线的折线，并且要求 populate_polylines 为 true。

传入路线的 route_polyline 字段可能与路线 transitions 不一致。

此字段不得与 injected_first_solution_routes 或 injected_solution_constraint 一起使用。

Shipment.ignore 和 Vehicle.ignore 对行为没有影响。无论是否忽略相关货件或车辆，系统仍会在所有非空路线中的所有访问之间填充多段线。

bool

如果为 true：

• 使用 ShipmentRoute.vehicle_label 而不是 vehicle_index 来匹配注入解决方案中的路线与请求中的车辆；重用原始 ShipmentRoute.vehicle_index 到新 ShipmentRoute.vehicle_index 的映射来更新 ConstraintRelaxation.vehicle_indices（如果非空），但映射必须明确（即，多个 ShipmentRoute 不得共享同一个原始 vehicle_index）。
• 使用 ShipmentRoute.Visit.shipment_label 而不是 shipment_index 将注入的解决方案中的访问与请求中的配送进行匹配；
• 使用 SkippedShipment.label 而不是 SkippedShipment.index 将注入的解决方案中的跳过配送与请求配送相匹配。

此解释适用于 injected_first_solution_routes、injected_solution_constraint 和 refresh_details_routes 字段。如果自创建解决方案以来，请求中的配送或车辆指数发生了变化（可能是因为从请求中移除了配送或车辆，或者向请求中添加了配送或车辆），则可以使用此参数。

如果为 true，则以下类别的标签在其类别中最多只能出现一次：

• 请求中的 Vehicle.label；
• 请求中的 Shipment.label；
• 注入的解决方案中的 ShipmentRoute.vehicle_label；
• 注入的解决方案中的 SkippedShipment.label 和 ShipmentRoute.Visit.shipment_label（取货/送货访问对除外，其 shipment_label 必须出现两次）。

如果注入的解决方案中的 vehicle_label 与请求车辆不对应，则会从解决方案中移除相应路线及其访问。如果注入的解决方案中的 shipment_label 与请求的配送不对应，则会从解决方案中移除相应拜访。如果注入的解决方案中的 SkippedShipment.label 与请求的货件不对应，则从解决方案中移除 SkippedShipment。

从注入的解决方案中移除路线访问或整个路线可能会影响隐含的限制，从而导致解决方案发生变化、出现验证错误或不可行。

注意：调用方必须确保每个 Vehicle.label（相应地，Shipment.label) 用于在两个相关请求中唯一标识车辆（相应地，货物）实体：生成注入解决方案中所用 OptimizeToursResponse 的过去请求，以及包含注入解决方案的当前请求。上述唯一性检查不足以保证满足此要求。

bool

在计算 ShipmentRoute 字段 Transition.travel_duration、Visit.start_time 和 vehicle_end_time 时，在设置 ShipmentRoute.has_traffic_infeasibilities 字段时，以及在计算 OptimizeToursResponse.total_cost 字段时，考虑流量估算。

bool

如果为 true，则会在响应 ShipmentRoute 中填充折线。

bool

如果为 true，则会在响应 ShipmentRoute.transitions 中填充折线和路线令牌。

bool

如果设置了此参数，则请求的截止时间（请参阅 https://grpc.io/blog/deadlines）最长可达 60 分钟。否则，最长截止期限仅为 30 分钟。请注意，长时间运行的请求被中断的风险会明显更高（但仍很小）。

bool

如果为 true，则使用测地线距离（而非 Google 地图距离）计算出行距离，并使用测地线距离和由 geodesic_meters_per_second 定义的速度计算出行时间。

string

可用于标识此请求的标签，会在 OptimizeToursResponse.request_label 中报告。

double

当 use_geodesic_distances 为 true 时，必须设置此字段，用于定义应用于计算出行时间的行驶速度。其值必须至少为 1.0 米/秒。

int32

截断返回的验证错误数量。除非 solving_mode=VALIDATE_ONLY，否则这些错误通常会作为 BadRequest 错误详情 (https://cloud.google.com/apis/design/errors#error_details) 附加到 INVALID_ARGUMENT 错误载荷。请参阅 OptimizeToursResponse.validation_errors 字段。此值默认为 100，上限为 10,000。

ShipmentRoute

为每辆车计算的路线；第 i 条路线对应于模型中的第 i 辆车。

string

OptimizeToursRequest.label 的副本（如果在请求中指定了标签）。

SkippedShipment

所有跳过的配送的列表。

OptimizeToursValidationError

我们能够独立检测到的所有验证错误的列表。请参阅 OptimizeToursValidationError 消息的“MULTIPLE ERRORS”说明。如果 solving_mode 为 DEFAULT_SOLVE，则会包含警告，而不是错误。

OptimizeToursRequest

在某些情况下，我们会先修改传入的请求（即添加费用），然后再解决问题。如果 solving_mode == TRANSFORM_AND_RETURN_REQUEST，则在此处返回修改后的请求。

实验性功能：如需了解详情，请参阅 https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request。

Metrics

此解决方案的时长、距离和使用情况指标。

AggregatedMetrics

按路线汇总。每个指标都是所有同名 ShipmentRoute.metrics 字段的总和（或加载的最大值）。

int32

跳过的强制性配送次数。

int32

使用的车辆数。注意：如果车辆路线为空且 Vehicle.used_if_route_is_empty 为 true，则车辆会被视为正在使用中。

Timestamp

二手车的最早开始时间，计算方式为所有二手车的 ShipmentRoute.vehicle_start_time 的最小值。

Timestamp

二手车的最新结束时间，计算方式为所有二手车的 ShipmentRoute.vehicle_end_time 中的最大值。

map<string, double>

解决方案的费用，按与费用相关的请求字段细分。键是相对于输入 OptimizeToursRequest 的 proto 路径，例如“model.shipments.pickups.cost”，值是相应费用字段生成的总费用，汇总了整个解决方案。换句话说，费用 ["model.shipments.pickups.cost"] 是整个解决方案中所有取件费用的总和。模型中定义的所有费用都会在此处详细报告，但与 TransitionAttributes 相关的费用除外，这些费用自 2022 年 1 月起仅以汇总方式报告。

double

解决方案的总费用。费用映射中所有值的总和。

string

必需。定位项目或位置以进行呼叫。

格式：

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

如果未指定位置，系统将自动选择区域。

Uri

必需。包含 OptimizeToursRequest 的 Cloud Storage 对象的 URI。

Uri

必需。将包含 OptimizeToursResponse 的 Cloud Storage 对象的 URI。

Uri

可选。包含 OptimizeToursResponse 的 Cloud Storage 对象的 URI，编码格式为 JSON 或 textproto。如果对象以 JSON 格式编码，则对象名称的扩展名将为 .json。如果对象以 textproto 格式编码，则对象名称的扩展名将为 .txtpb。

资源的 crc32_checksum 可用于验证资源的内容是否未被修改。

int32

验证错误由始终存在的 (code, display_name) 对定义。

此部分后面的字段提供了有关错误的更多背景信息。

多个错误：如果存在多个错误，验证过程会尝试输出其中的几个。与编译器类似，这是一个不完善的过程。某些验证错误是“致命”的，这意味着它们会停止整个验证过程。display_name="UNSPECIFIED" 错误就是其中的一个例子。某些错误可能会导致验证过程跳过其他错误。

稳定性：code 和 display_name 应该非常稳定。但随着时间的推移，可能会出现新的代码和显示名称，这可能会导致给定的（无效）请求产生不同的（code、display_name）对，因为新错误隐藏了旧错误。例如，请参阅“多项错误”。

string

错误显示名称。

FieldReference

错误上下文可能涉及 0 个、1 个（大多数情况下）或多个字段。例如，如需指明车辆 4 和货件 2 的首次取货，可以按如下方式操作：

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

不过请注意，对于给定的错误代码，fields 的基数不应发生变化。

string

直观易懂的字符串，用于描述错误。code 和 error_message 之间存在一对一的映射关系（当代码不为“UNSPECIFIED”时）。

稳定性：不稳定：与给定 code 关联的错误消息可能会随时间变化（希望是变得更清晰）。请改用 display_name 和 code。

string

可能包含相应字段的值。此功能并非总是可用。您绝对不应依赖它，而应仅将其用于手动模型调试。

string

字段的名称，例如 “车辆”。

FieldReference

递归嵌套的子字段（如果需要）。

int32

如果字段重复，则为字段的索引。

string

如果相应字段是映射，则为键。

DataFormat

必需。输出数据格式。

GcsDestination

要向其中写入输出的 Google Cloud Storage 位置。

bool

指定是否在合理的情况下避开收费公路。系统会优先选择不包含收费公路的路线。仅适用于机动出行方式。

bool

指定是否在合理的情况下避开高速公路。系统会优先选择不包含高速公路的路线。仅适用于机动出行方式。

bool

指定是否在合理的情况下避开轮渡。系统会优先选择不包含轮渡行程的路线。仅适用于机动出行方式。

bool

可选。指定是否在合理的情况下避免室内导航。系统会优先选择不包含室内导航的路线。仅适用于 WALKING 出行模式。

string

用户定义的货件显示名称。不得超过 63 个字符，可以使用 UTF-8 字符。

VisitRequest

与相应配送相关联的一组自提替代方案。如果未指定，车辆只需前往与配送对应的位置。

VisitRequest

与相应货件相关的一组配送替代方案。如果未指定，车辆只需前往与上车点对应的位置。

map<string, Load>

货件的装载需求（例如重量、体积、托盘数量等）。映射中的键应是描述相应负载类型的标识符，最好还包含单位。例如：“weight_kg”“volume_gallons”“pallet_count”等。如果给定键未出现在映射中，则相应载荷将被视为 null。

int32

可能执行相应配送的一组车辆。如果为空，则所有车辆都可以执行该操作。车辆由其在 ShipmentModel 的 vehicles 列表中的索引给出。

double

指定每辆车在运送相应货物时产生的费用。如果指定，则必须具有以下任一值：

• 与 costs_per_vehicle_indices 具有相同数量的元素。costs_per_vehicle[i] 对应于型号为 costs_per_vehicle_indices[i] 的车辆。
• 与模型中的车辆数量相同的元素数量。第 i 个元素对应于相应型号的第 i 辆车。

这些费用必须与 penalty_cost 的单位相同，且不得为负数。如果没有此类费用，请将此字段留空。

int32

costs_per_vehicle 适用的车辆的索引。如果非空，则必须与 costs_per_vehicle 具有相同数量的元素。车辆索引不得多次指定。如果车辆被排除在 costs_per_vehicle_indices 之外，则其费用为零。

Duration

指定与从上车点到送达点的最短路径相比，最长的绝对绕行时间。如果指定，则必须为非负值，并且相应配送必须至少包含取货和送货。

例如，假设 t 是从所选取货替代方案直接前往所选送货替代方案所需的最短时间。然后，设置 pickup_to_delivery_absolute_detour_limit 会强制执行以下操作：

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

如果同一批货件同时指定了相对限制和绝对限制，则对于每个可能的取货/送货对，系统会使用限制更严格的那个。截至 2017 年 10 月，仅当出行时长不取决于车辆时，系统才支持绕行。

Duration

指定从取件开始到送达开始的货件最长时长。如果指定，则必须为非负值，并且相应货件必须至少包含取货和送货。这并不取决于为取货和送货选择的替代方案，也不取决于车辆速度。此参数可与绕行距离上限约束条件一起指定：解决方案将同时满足这两项规范。

string

非空字符串，用于指定相应货件的“类型”。此功能可用于定义 shipment_types 之间的不兼容性或要求（请参阅 ShipmentModel 中的 shipment_type_incompatibilities 和 shipment_type_requirements）。

与为单次访问指定的 visit_types 不同：属于同一批次的所有取货/送货共用同一个 shipment_type。

string

为相应配送指定标签。此标签会在相应 ShipmentRoute.Visit 的 shipment_label 中报告。

bool

如果为 true，则跳过相应配送，但不应用 penalty_cost。

如果模型中存在任何 shipment_type_requirements，忽略配送会导致验证错误。

允许忽略在 injected_first_solution_routes 或 injected_solution_constraint 中执行的配送；求解器会从执行路线中移除相关的取货/送货访问。引用被忽略的货件的 precedence_rules 也会被忽略。

double

如果未完成配送，此罚款将添加到路线的总费用中。如果某个配送方案的取货和送货替代方案之一被访问，则该配送方案被视为已完成。费用可以采用模型中所有其他费用相关字段所用的相同单位表示，并且必须为正值。

重要提示：如果未指定此罚款，则视为无限期，即必须完成配送。

double

指定与从上车点到送达点的最短路径相比，最长的相对绕行时间。如果指定，则必须为非负值，并且相应配送必须至少包含取货和送货。

例如，假设 t 是从所选取货替代方案直接前往所选送货替代方案所需的最短时间。然后，设置 pickup_to_delivery_relative_detour_limit 会强制执行以下操作：

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

如果同一批货件同时指定了相对限制和绝对限制，则对于每个可能的取货/送货对，系统会使用限制更严格的那个。截至 2017 年 10 月，仅当出行时长不取决于车辆时，系统才支持绕行。

int64

执行相应访问的车辆的负载量会有所不同。由于它是整数，因此建议用户选择合适的单位，以免损失精度。必须大于等于 0。

LatLng

执行此 VisitRequest 时车辆到达的地理位置。如果配送模型具有时长距离矩阵，则不得指定 arrival_location。

Waypoint

执行此 VisitRequest 时车辆到达的途经点。如果配送模型具有时长距离矩阵，则不得指定 arrival_waypoint。

LatLng

车辆在完成此 VisitRequest 后出发的地理位置。如果与 arrival_location 相同，则可以省略。如果配送模型具有时长距离矩阵，则不得指定 departure_location。

Waypoint

车辆在完成此 VisitRequest 后出发的途经点。如果与 arrival_waypoint 相同，则可以省略。如果配送模型具有时长距离矩阵，则不得指定 departure_waypoint。

string

指定附加到访问请求的标记。不允许使用空字符串或重复的字符串。

TimeWindow

限制访问到达时间的时间窗口。请注意，车辆可能会在到达时间窗口之外出发，也就是说，到达时间 + 时长不必在时间窗口内。如果车辆在 TimeWindow.start_time 之前到达，则可能会产生等待时间。

缺少 TimeWindow 表示车辆可以在任何时间执行此访问。

时间窗口必须是不相交的，也就是说，任何时间窗口都不得与其他时间窗口重叠或相邻，并且必须按递增顺序排列。

只有在单个时间窗口的情况下才能设置 cost_per_hour_after_soft_end_time 和 soft_end_time。

Duration

访问时长，即车辆从到达到离开所花费的时间（将添加到可能的等待时间；请参阅 time_windows）。

double

在车辆路线中服务此访问请求的费用。此属性可用于为货件的每种替代自提或送货方式支付不同的费用。此费用必须与 Shipment.penalty_cost 的单位相同，且不得为负值。

map<string, Load>

加载相应访问请求的需求。此字段与 Shipment.load_demands 字段类似，但仅适用于此 VisitRequest，而不适用于整个 Shipment。此处列出的需求会添加到 Shipment.load_demands 中列出的需求中。

string

指定访问类型。这可用于分配车辆完成此访问所需的额外时间（请参阅 Vehicle.extra_visit_duration_for_visit_type）。

一种类型只能出现一次。

string

为此 VisitRequest 指定标签。此标签在响应中报告为相应 ShipmentRoute.Visit 中的 visit_label。

bool

指定是否应避免在此位置的驾车路线中出现掉头。系统会尽力避免掉头，但无法保证完全避免。这是一项实验性功能，其行为可能会发生变化。

实验性功能：如需了解详情，请参阅 https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request。

Shipment

必须在模型中执行的一组货件。

Vehicle

可用于执行拜访的一组车辆。

Objective

此模型的目标集，我们将将其转换为费用。如果非空，则输入模型必须是无成本的。如需获取修改后的请求，请使用 solving_mode = TRANSFORM_AND_RETURN_REQUEST。请注意，在这种情况下，请求将无法解决。请参阅相应文档。

实验性功能：如需了解详情，请参阅 https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request。

Timestamp

模型的全局开始时间和结束时间：超出此范围的时间均视为无效。

模型的跨度必须小于一年，即 global_end_time 和 global_start_time 之间的差值必须小于 31536000 秒。

使用 cost_per_*hour 字段时，您可能需要将此窗口设置为较小的时间间隔，以提高性能（例如，如果您对单日进行建模，则应将全局时间限制设置为该天）。如果未设置，则使用 1970 年 1 月 1 日 00:00:00 UTC（即秒数：0，纳秒数：0）作为默认值。

Timestamp

如果未设置，则使用 1971 年 1 月 1 日 00:00:00 UTC（即秒数：31536000，纳秒数：0）作为默认值。

double

整个方案的“全局时长”是指所有车辆的最早有效开始时间与最晚有效结束时间之间的差值。用户可以为该数量分配每小时费用，以尝试优化最早完成作业的时间。此费用必须与 Shipment.penalty_cost 的单位相同。

DurationDistanceMatrix

指定模型中使用的时长和距离矩阵。如果此字段为空，系统会改用 Google 地图或测地线距离，具体取决于 use_geodesic_distances 字段的值。如果该值不为空，则 use_geodesic_distances 不能为 true，并且 duration_distance_matrix_src_tags 和 duration_distance_matrix_dst_tags 均不能为空。

用法示例：

• 有两个位置：locA 和 locB。
• 1 辆车从位置 A 开始其路线，并在位置 A 结束。
• 在 locB 提交了 1 次取件访问请求。

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

• 有三个位置：locA、locB 和 locC。
• 1 辆车从 locA 开始其路线，在 locB 结束，使用矩阵“fast”。
• 1 辆车从 locB 开始其路线，并在 locB 结束，使用矩阵“slow”。
• 1 辆车从 locB 开始其路线，在 locB 结束，使用矩阵“fast”。
• 在 locC 处提出 1 次取件访问请求。

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

用于定义时长矩阵和距离矩阵来源的标记；duration_distance_matrices(i).rows(j) 用于定义从具有标记 duration_distance_matrix_src_tags(j) 的访问到矩阵 i 中其他访问的时长和距离。

标记对应于 VisitRequest.tags 或 Vehicle.start_tags。给定的 VisitRequest 或 Vehicle 必须与此字段中的一个代码完全匹配。请注意，Vehicle 的来源、目的地和矩阵标记可能相同；同样，VisitRequest 的来源和目的地标记也可能相同。所有标记都必须各不相同，且不能为空字符串。如果此字段不为空，则 duration_distance_matrices 不得为空。

string

用于定义时长和距离矩阵的目的地的标记；duration_distance_matrices(i).rows(j).durations(k)（分别为 duration_distance_matrices(i).rows(j).meters(k)) 定义了从具有标记 duration_distance_matrix_src_tags(j) 的访问到具有标记 duration_distance_matrix_dst_tags(k) 的访问在矩阵 i 中的出行时长（相应地为出行距离）。

标记对应于 VisitRequest.tags 或 Vehicle.start_tags。给定的 VisitRequest 或 Vehicle 必须与此字段中的一个代码完全匹配。请注意，Vehicle 的来源、目的地和矩阵标记可能相同；同样，VisitRequest 的来源和目的地标记也可能相同。所有标记都必须各不相同，且不能为空字符串。如果此字段不为空，则 duration_distance_matrices 不得为空。

TransitionAttributes

向模型添加了过渡属性。

ShipmentTypeIncompatibility

一组不兼容的 shipment_types（请参阅 ShipmentTypeIncompatibility）。

ShipmentTypeRequirement

一组 shipment_type 要求（请参阅 ShipmentTypeRequirement）。

PrecedenceRule

必须在模型中强制执行的一组优先级规则。

重要提示：使用优先级规则会限制可优化的问题的规模。使用包含大量货件的优先规则的请求可能会被拒绝。

int32

限制有效车辆的最大数量。如果车辆的路线至少执行一次运输，则该车辆处于有效状态。如果司机数量少于车辆数量，且车辆类型各不相同，则可以使用此参数来限制路线数量。然后，优化功能会选择要使用的最佳车辆子集。必须严格为正。

Row

指定时长和距离矩阵的行。它必须具有与 ShipmentModel.duration_distance_matrix_src_tags 相同的元素数量。

string

用于定义相应时长和距离矩阵适用于哪些车辆的标记。如果为空，则表示适用于所有车辆，并且只能有一个矩阵。

每次车辆启动都必须与一个矩阵完全匹配，也就是说，车辆启动的 start_tags 字段必须与某个矩阵的 vehicle_start_tag 相匹配（并且只能与该矩阵的 vehicle_start_tag 相匹配）。

所有矩阵都必须具有不同的 vehicle_start_tag。

Duration

指定行的时长值。它必须具有与 ShipmentModel.duration_distance_matrix_dst_tags 相同的元素数量。

double

指定行的距离值。如果模型中没有任何费用或限制条件涉及距离，则可将此参数留空；否则，此参数的元素数量必须与 durations 相同。

Type

目标的类型。

double

相应目标相对于其他目标的权重。可以是任何非负数，权重不必总和为 1。权重默认为 1.0。

bool

表示“第一个”事件是否为送达事件。

bool

指示“第二个”事件是否为交付。

Duration

“第一个”事件与“第二个”事件之间的偏移量。可以为负数。

int32

“第一个”事件的货件指数。必须指定此字段。

int32

“第二个”事件的货件指数。必须指定此字段。

int32

执行路线的车辆，由其在来源 ShipmentModel 中的索引标识。

string

执行此路线的车辆的标签，如果指定，则等于 ShipmentModel.vehicles(vehicle_index).label。

Timestamp

车辆开始行驶路线的时间。

Timestamp

车辆完成路线的时间。

Visit

表示路线的有序到访序列。visits[i] 是路线中的第 i 次到访。如果此字段为空，则表示相应车辆未被使用。

Transition

相应路由的有序转换列表。

bool

当 OptimizeToursRequest.consider_road_traffic 设置为 true 时，此字段表示系统会使用基于流量的出行时间估算值来预测路线时间的不一致性。在满足访问和车辆时间窗口的前提下，可能没有足够的时间来完成根据流量调整的行程、延迟以及访问之间、首次访问之前或最后一次访问之后的休息时间。例如，

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

由于交通状况导致出行时间估计值增加 travel_duration(previous_visit, next_visit)，因此到达 next_visit 的时间可能会晚于当前时间窗口。此外，由于行程时间估计值增加以及访问或休息时间窗口限制，休息时间可能会被迫与访问时间重叠。

EncodedPolyline

路线的编码多段线表示法。只有当 OptimizeToursRequest.populate_polylines 设置为 true 时，系统才会填充此字段。

Break

执行此路线的车辆的预定休息时间。breaks 序列表示时间间隔，每个时间间隔均从相应的 start_time 开始，持续 duration 秒。

AggregatedMetrics

相应路线的时长、距离和负荷指标。AggregatedMetrics 的字段会针对所有 ShipmentRoute.transitions 或 ShipmentRoute.visits 进行求和，具体取决于上下文。

VehicleFullness

用于计算封顶指标与相应车辆限额的接近程度的 VehicleFullness 字段。其字段是上限指标字段（例如 AggregatedMetrics.travel_distance_meters）与相关车辆限制（例如 Vehicle.route_distance_limit）之间的比率。

实验性：此字段的行为或存在状态将来可能会发生变化。

map<string, double>

路线的费用，按与费用相关的请求字段细分。键是相对于输入 OptimizeToursRequest 的 proto 路径，例如“model.shipments.pickups.cost”，值是相应费用字段生成的总费用（在整个路线中汇总）。换句话说，costs["model.shipments.pickups.cost"] 是路线中所有取货费用的总和。模型中定义的所有费用都会在此处详细报告，但与 TransitionAttributes 相关的费用除外，这些费用自 2022 年 1 月起仅以汇总方式报告。

double

路线的总费用。费用地图中所有费用的总和。

Timestamp

休息的开始时间。

Duration

休息时长。

string

表示多段线的编码点的字符串。

Duration

在此过渡期间的旅行时长。

double

过渡期间的行驶距离。

bool

当通过 OptimizeToursRequest.consider_road_traffic 请求流量，但无法检索到 Transition 的流量信息时，此布尔值会设置为 true。这可能是暂时性的（实时流量服务器出现罕见的小故障），也可能是永久性的（相应位置没有数据）。

Duration

应用于相应过渡的延迟时长的总和。如果有延迟，则延迟会在下一个事件（到访或车辆结束）开始前 delay_duration 秒开始。请参阅TransitionAttributes.delay。

Duration

相应过渡期间发生的插播时长总和（如有）。有关每个中断的开始时间和时长的详细信息存储在 ShipmentRoute.breaks 中。

Duration

在此过渡期间花费的等待时间。等待时长对应于空闲时间，不包括休息时间。另请注意，此等待时间可能会分为几个不连续的时间段。

Duration

过渡的总时长，为方便起见而提供。它等于：

• 下一次访问 start_time（或 vehicle_end_time，如果这是最后一次过渡）- 相应过渡的 start_time；
• 如果 ShipmentRoute.has_traffic_infeasibilities 为 false，则以下等式也成立：`total_duration = travel_duration + delay_duration
• break_duration + wait_duration”。

Timestamp

相应过渡的开始时间。

EncodedPolyline

过渡期间所遵循路线的编码多段线表示法。只有当 populate_transition_polylines 设置为 true 时，系统才会填充此字段。

string

仅限输出。一个不透明的令牌，可传递给 Navigation SDK，以便在导航期间重建路线，并在重新规划路线时遵循创建路线时的原始意图。将此令牌视为不透明的 blob。请勿跨请求比较其值，因为即使服务返回完全相同的路线，其值也可能会发生变化。只有当 populate_transition_polylines 设置为 true 时，系统才会填充此字段。

map<string, VehicleLoad>

相应车辆在过渡期间的载重，针对的是该车辆的 Vehicle.load_limits 中显示的每种类型，或者在该路线上的某些运输中具有非零 Shipment.load_demands 的每种类型。

首次过渡期间的装载是车辆路线的起始装载。然后，在每次访问后，系统会根据访问是取货还是送货，将访问的 load_demands 添加到当前过渡的载荷中或从中减去，以获得下一个过渡的载荷。

int64

车辆上给定类型的负荷量。负载的单位通常由类型指示。请参阅 Transition.vehicle_loads。

int32

来源 ShipmentModel 中 shipments 字段的索引。

bool

如果为 true，则表示相应访问是 Shipment 的取货访问。否则，它对应于一次交付。

int32

Shipment 的自取或送货字段中 VisitRequest 的索引（请参阅 is_pickup）。

Timestamp

访问的开始时间。请注意，车辆可能会比此时间更早到达访问地点。时间与 ShipmentModel 保持一致。

map<string, Load>

总访问负荷需求，即运输和访问请求 load_demands 的总和。如果相应访问是送货，则值为负数。报告的需求类型与 Transition.loads 相同（请参阅此字段）。

Duration

由于在访问之前路线上的货件以及时间窗口可能造成的等待时间而产生的额外绕行时间。如果相应访问是送货访问，则绕行距离是从相应的取货访问计算得出的，等于：

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

否则，该值将根据车辆 start_location 计算得出，计算公式如下：

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

string

相应 Shipment.label 的副本（如果已在 Shipment 中指定）。

string

相应 VisitRequest.label 的副本（如果已在 VisitRequest 中指定）。

int32

一个不透明的令牌，表示有关访问位置的信息。

如果相应访问的 VisitRequest.avoid_u_turns 设置为 true，或者请求 OptimizeToursRequest 中的 ShipmentModel.avoid_u_turns 设置为 true，则结果路线的访问中可能会填充此字段。

实验性功能：如需了解详情，请参阅 https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request。

string

不兼容的类型列表。如果两批货件的shipment_types不同，则它们“不兼容”。

IncompatibilityMode

应用于不兼容性的模式。

string

dependent_shipment_types 所需的备选配送类型列表。

string

如果配送的类型在 dependent_shipment_types 字段中，则必须在同一路线中至少访问一次类型为 required_shipment_type_alternatives 的配送。

注意：不允许出现 shipment_type 依赖于自身的依赖链。

RequirementMode

应用于要求的模式。

int32

该指数对应于来源 ShipmentModel 中相应配送的指数。

string

相应 Shipment.label 的副本（如果已在 Shipment 中指定）。

Reason

说明跳过相应配送的原因列表。请参阅上文中的注释 Reason。如果我们无法了解跳过某次配送的原因，则不会设置原因。

double

这是 Shipment.penalty_cost 的副本，此处包含该副本是为了方便您了解跳过配送的严重程度。

实验性：此字段的行为或存在状态将来可能会发生变化。

double

因以下至少一个原因而无法执行相应配送任务的车辆的估计比率。注意：仅当原因涉及车辆时才填写此字段。

实验性：此字段的行为或存在状态将来可能会发生变化。

Code

请参阅代码的注释。

int32

与 example_vehicle_index 相同，只不过我们提供的是多个已识别车辆的列表。此列表未必详尽无遗。仅当 [fill_example_vehicle_indices_in_skipped_reasons][] 为 true 时，才会填充此字段。

实验性：此字段的行为或存在状态将来可能会发生变化。

string

如果原因代码为 DEMAND_EXCEEDS_VEHICLE_CAPACITY，则表示文档超出了一种容量类型。

int32

如果原因是与货件-车辆不兼容相关，则此字段会提供相关车辆的索引。

Timestamp

硬性时间段的开始时间。如果未指定，则会设置为 ShipmentModel.global_start_time。

Timestamp

硬性时间段的结束时间。如果未指定，则会设置为 ShipmentModel.global_end_time。

Timestamp

时间窗口的软开始时间。

Timestamp

时间窗口的软结束时间。

double

如果相应事件发生在 soft_start_time 之前，则添加到模型中其他费用的每小时费用，计算方式如下：

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

此费用必须为正值，并且只有在设置了 soft_start_time 的情况下才能设置此字段。

double

如果事件发生在 soft_end_time 之后，则添加到模型中其他费用的每小时费用，计算方式如下：

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

此费用必须为正数，并且只有在已设置 soft_end_time 的情况下才能设置此字段。

string

用于定义这些属性所适用的 (src->dst) 过渡的标记。

当来源访问或车辆启动的 VisitRequest.tags 或 Vehicle.start_tags 包含 src_tag 或不包含 excluded_src_tag 时（具体取决于这两个字段中哪个不为空），即表示匹配。

string

请参阅 src_tag。src_tag 和 excluded_src_tag 中必须只有一个不为空。

string

当目的地访问或车辆结束的 VisitRequest.tags 或 Vehicle.end_tags 包含 dst_tag 或不包含 excluded_dst_tag 时（具体取决于这两个字段中哪个不为空），才算匹配。

string

请参阅 dst_tag。dst_tag 和 excluded_dst_tag 中必须只有一个不为空。

double

指定执行此过渡的费用。此值与模型中的所有其他费用采用相同的单位，且不得为负值。此费用是在所有其他现有费用的基础上收取的。

double

指定在执行此过渡时，按行驶距离计算的每公里费用。它会累加车辆上指定的所有 Vehicle.cost_per_kilometer。

DistanceLimit

指定在执行此过渡时行驶的距离限制。

截至 2021 年 6 月，仅支持软限制。

Duration

指定执行此过渡时产生的延迟。

此延迟始终发生在完成来源访问之后和开始目标访问之前。

string

资源的 URI。资源可能尚不存在。

资源的内容编码为 JSON 或 textproto。仅支持 Google Cloud Storage 资源。如果资源以 JSON 格式编码，则资源名称必须以 .json 为后缀。如果资源以 textproto 格式编码，则资源名称必须以 .txtpb 为后缀。例如，JSON 编码文件的 Google Cloud Storage URI 可能如下所示：gs://bucket/path/input/object.json。

string

用户定义的车辆显示名称。不得超过 63 个字符，可以使用 UTF-8 字符。

TravelMode

出行模式，会影响车辆可行驶的道路及其行驶速度。另请参阅 travel_duration_multiple。

RouteModifiers

一组需要满足的条件，这些条件会影响指定车辆的路线计算方式。

LatLng

车辆在取货前开始行驶的地理位置。如果未指定，车辆将从第一个上车点开始。如果配送模型具有时长和距离矩阵，则不得指定 start_location。

Waypoint

表示车辆在取货前开始行驶的地理位置的途经点。如果未指定 start_waypoint 和 start_location，车辆将从第一个上车点开始。如果配送模型具有时长和距离矩阵，则不得指定 start_waypoint。

LatLng

车辆在完成最后一次 VisitRequest 后停止的地理位置。如果未指定，车辆的 ShipmentRoute 会在完成最后一次 VisitRequest 后立即结束。如果配送模型具有时长和距离矩阵，则不得指定 end_location。

Waypoint

航点，表示车辆在完成最后一次 VisitRequest 后结束的地理位置。如果未指定 end_waypoint 和 end_location，则当车辆完成其最后一次 VisitRequest 时，ShipmentRoute 会立即结束。如果配送模型具有时长和距离矩阵，则不得指定 end_waypoint。

string

指定附加到车辆路线起点的标记。

不允许使用空字符串或重复的字符串。

string

指定附加到车辆路线末尾的标记。

不允许使用空字符串或重复的字符串。

TimeWindow

车辆可以从起始地点出发的时间段。它们必须在全局时间限制内（请参阅 ShipmentModel.global_* 字段）。如果未指定，则除了全局时间限制之外，没有其他限制。

属于同一重复字段的时间窗口必须是不相交的，即任何时间窗口都不能与另一个时间窗口重叠或相邻，并且它们必须按时间顺序排列。

只有在单个时间窗口的情况下才能设置 cost_per_hour_after_soft_end_time 和 soft_end_time。

TimeWindow

车辆可能到达最终位置的时间窗口。它们必须在全局时间限制内（请参阅 ShipmentModel.global_* 字段）。如果未指定，则除了全局时间限制之外，没有其他限制。

属于同一重复字段的时间窗口必须是不相交的，即任何时间窗口都不能与另一个时间窗口重叠或相邻，并且它们必须按时间顺序排列。

只有在单个时间窗口的情况下才能设置 cost_per_hour_after_soft_end_time 和 soft_end_time。

UnloadingPolicy

在车辆上强制执行的卸货政策。

map<string, LoadLimit>

车辆的载重能力（例如重量、体积、托盘数量）。映射中的键是负载类型的标识符，与 Shipment.load_demands 字段的键一致。如果此映射中缺少某个给定的键，则相应容量将被视为无限。

double

车辆费用：所有费用加起来必须与 Shipment.penalty_cost 的单位相同。

车辆路线每小时的费用。此费用适用于路线的总耗时，包括出行时间、等待时间和游览时间。使用 cost_per_hour 而不是仅使用 cost_per_traveled_hour 可能会导致额外的延迟时间。

double

车辆路线每行驶小时的费用。此费用仅适用于路线所用的出行时间（即 ShipmentRoute.transitions 中报告的时间），不包括等待时间和拜访时间。

double

车辆路线的每公里费用。此费用适用于 ShipmentRoute.transitions 中报告的距离，不适用于从单个 VisitRequest 的 arrival_location 到 departure_location 隐式行驶的任何距离。

double

如果使用相应车辆处理货件，则应用固定费用。

bool

此字段仅适用于路线不包含任何货件的车辆。它用于指明在这种情况下是否应将车辆视为已使用。

如果为 true，车辆会从起点前往终点，即使它不运送任何货物，并且系统会考虑从起点到终点的行驶所产生的时间和距离成本。

否则，它不会从起始位置行驶到结束位置，并且不会为该车辆安排 break_rule 或延迟（来自 TransitionAttributes）。在这种情况下，车辆的 ShipmentRoute 除了车辆索引和标签之外，不包含任何信息。

DurationLimit

应用于车辆路线总时长的限制。在给定的 OptimizeToursResponse 内，车辆的路线时长是其 vehicle_end_time 与 vehicle_start_time 之间的差值。

DurationLimit

应用于车辆路线的行驶时长的限制。在给定的 OptimizeToursResponse 中，路线行驶时长是所有 transitions.travel_duration 的总和。

DistanceLimit

应用于车辆路线总距离的限制。在给定的 OptimizeToursResponse 中，路线距离是所有 transitions.travel_distance_meters 的总和。

map<string, Duration>

指定从 visit_types 字符串到时长的映射。时长是指在具有指定 visit_types 的访问中，除了 VisitRequest.duration 之外还要花费的时间。如果指定了 cost_per_hour，则此额外访问时长会增加费用。键（即 visit_types）不能是空字符串。

如果访问请求具有多种类型，则系统会为地图中的每种类型添加时长。

BreakRule

描述要在此车辆上强制执行的休息时间表。如果为空，则不会为相应车辆安排休息时间。

string

指定相应车辆的标签。此标签会在响应中报告为相应 ShipmentRoute 的 vehicle_label。

bool

如果为 true，则 used_if_route_is_empty 必须为 false，并且相应车辆将保持未使用状态。

如果某项配送任务由 injected_first_solution_routes 中被忽略的车辆执行，则该任务会在第一个解决方案中被跳过，但可以在响应中自由执行。

如果某次配送由 injected_solution_constraint 中被忽略的车辆执行，并且任何相关的取货/送货都受限于留在车辆上（即，未放宽到 RELAX_ALL_AFTER_THRESHOLD 级别），则会在响应中跳过该配送。如果某批货件的 allowed_vehicle_indices 字段不为空，但所有允许的车辆都被忽略，则该货件会在响应中被跳过。

double

指定可用于增加或减少相应车辆的出行时间的乘数。例如，如果将此值设置为 2.0，则表示相应车辆速度较慢，行程时间是标准车辆的两倍。此倍数不会影响访问时长。如果指定了 cost_per_hour 或 cost_per_traveled_hour，则会影响费用。此值必须在 [0.001, 1000.0] 范围内。如果未设置，则表示车辆为标准车辆，相应倍数视为 1.0。

警告：应用此倍数后，但在执行任何数值运算之前，出行时间将四舍五入到最接近的秒数，因此，较小的倍数可能会导致精度损失。

另请参阅下文中的 extra_visit_duration_for_visit_type。

Duration

将时长限制为最多 max_duration 的硬性限制。

Duration

一种不强制执行最长时长限制的软性限制，但违反此限制会导致路线产生费用。此费用会与模型中定义的其他费用相加，单位相同。

如果已定义，soft_max_duration 必须为非负数。如果还定义了 max_duration，则 soft_max_duration 必须小于 max_duration。

Duration

一种不强制执行最长时长限制的软性限制，但如果违反此限制，路线的费用将按时长的二次方计算。此费用会与模型中定义的其他费用相加，单位相同。

如果已定义，quadratic_soft_max_duration 必须为非负数。如果还定义了 max_duration，则 quadratic_soft_max_duration 必须小于 max_duration，并且差值不得超过一天：

max_duration - quadratic_soft_max_duration <= 86400 seconds

double

如果违反 soft_max_duration 阈值，则每小时产生的费用。如果时长低于阈值，则额外费用为 0；否则，费用取决于时长，如下所示：

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

费用必须为非负数。

double

如果违反 quadratic_soft_max_duration 阈值，则产生的每平方小时费用。

如果时长低于阈值，则额外费用为 0；否则，费用取决于时长，如下所示：

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

费用必须为非负数。

int64

负载的软性限制。请参阅 cost_per_unit_above_soft_max。

double

如果车辆在行驶路线上的任何时间点负载超过 soft_max_load，则会产生以下费用罚款（每辆车仅一次）：（负载 - soft_max_load）* cost_per_unit_above_soft_max。所有费用加起来必须与 Shipment.penalty_cost 的单位相同。软限制只能针对在整个模型中仅适用于自提或仅适用于送货的类型进行定义。

Interval

车辆在路线开始时的可接受载荷区间。

Interval

路线结束时车辆的可接受装载间隔。

int64

可接受的最大负载量。

LoadCost

此车辆每移动 1 个单位的负荷 1 公里的费用。这可用作燃料消耗量的代理变量：如果负荷是重量（以牛顿为单位），则负荷*公里具有能量的维度。

实验性功能：如需了解详情，请参阅 https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request。

LoadCost

此车辆在 1 小时内运输一个单位的负载所需的费用。

实验性功能：如需了解详情，请参阅 https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request。

int64

可接受的最低负荷。必须大于等于 0。如果同时指定了这两个参数，则 min 必须 ≤ max。

int64

可接受的最大负荷。必须大于等于 0。如果未指定，则此消息不会限制最大负载。如果同时指定了这两个参数，则 min 必须 ≤ max。

int64

负载量，当负载量超过此值时，单位负载的费用将从 cost_per_unit_below_threshold 变为 cost_per_unit_above_threshold。必须大于等于 0。

double

移动一个单位的负载的费用，适用于 0 到阈值之间的每个单位。必须是有限值，且大于等于 0。

double

移动一个单位的负载（对于超出阈值的每个单位）的费用。如果阈值为 0，则表示每单位固定费用。必须是有限值，且大于等于 0。

double

相应消息中所有其他字段的最大值。

double

AggregatedMetrics.travel_distance_meters 与 Vehicle.route_distance_limit 之间的比率。如果未设置 Vehicle.route_distance_limit，则此字段也将未设置。

double

[AggregatedMetrics.travel_duration_seconds][] 与 Vehicle.travel_duration_limit 之间的比率。如果未设置 Vehicle.travel_duration_limit，则此字段也将未设置。

double

[AggregatedMetrics.total_duration_seconds][] 与 Vehicle.route_duration_limit 之间的比率。如果未设置 Vehicle.route_duration_limit，则此字段也将未设置。

double

所有类型的 [AggregatedMetrics.max_load][] 及其各自的 Vehicle.load_limits 之间的最大比率。如果所有 Vehicle.load_limits 字段均未设置，则此字段将未设置。

double

给定车辆的 (vehicle_end_time - vehicle_start_time) / (latest_vehicle_end_time - earliest_vehicle_start_time) 比率。如果不存在分母，则使用 (ShipmentModel.global_end_time - ShipmentModel.global_start_time) 代替。

bool

可选。表示此航点的位置旨在让车辆优先停靠在道路的特定一侧。设置此值后，路线将经过相应位置，以便车辆停靠在道路中心偏向该位置的一侧。此选项不适用于“步行”出行方式。

bool

表示该航点供车辆停靠，目的是接载或送达乘客。此选项仅适用于“DRIVING”出行模式，且“location_type”为“location”。

实验性：此字段的行为或存在状态将来可能会发生变化。

Location

使用地理坐标指定的点，包括可选的航向。

string

与途经点关联的 POI 地点 ID。

使用地点 ID 指定 VisitRequest 的到达或出发地点时，请使用足够具体的地点 ID 来确定前往该地点的导航 LatLng 位置。例如，表示建筑物的地点 ID 适合，但表示道路的地点 ID 不建议使用。