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 (resp.ShipmentRoute.metrics.max_loads。

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 的上限，则产生的每公里费用。如果距离低于上限，则额外费用为 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 (resp.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

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

ShipmentRoute

为每辆车计算的路线；第 i-th 号路线对应于模型中的第 i 号交通工具。

string

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

SkippedShipment

跳过的所有运单的列表。

OptimizeToursValidationError

我们能够单独检测到的所有验证错误的列表。请参阅“多个错误”OptimizeToursValidationError 消息的说明。

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>

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

double

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

int32

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

其他字段（见下文）提供了有关此错误的更多背景信息。

多个错误：如果存在多个错误，验证流程会尝试输出多个错误。这是一个不完美的过程，就像编译器一样。有些验证错误是“严重”错误，也就是说，它们会停止整个验证流程。display_name="UNSPECIFIED" 错误就属于这种情况。有些可能会导致验证流程跳过其他错误。

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

REFERENCE：所有 (code, name) 对的列表：

• 未指定 = 0；
• VALIDATION_TIMEOUT_ERROR = 10；无法在期限内完成验证。

• REQUEST_OPTIONS_ERROR = 12；

  • REQUEST_OPTIONS_INVALID_SOLVING_MODE = 1201；
  • REQUEST_OPTIONS_INVALID_MAX_VALIDATION_ERRORS = 1203；
  • REQUEST_OPTIONS_INVALID_GEODESIC_METERS_PER_SECOND = 1204；
  • REQUEST_OPTIONS_GEODESIC_METERS_PER_SECOND_TOO_SMALL = 1205；
  • REQUEST_OPTIONS_MISSING_GEODESIC_METERS_PER_SECOND = 1206；
  • REQUEST_OPTIONS_POPULATE_PATHFINDER_TRIPS_AND_GEODESIC_DISTANCE = 1207；
  • REQUEST_OPTIONS_COST_MODEL_OPTIONS_AND_GEODESIC_DISTANCE = 1208；
  • REQUEST_OPTIONS_TRAVEL_MODE_INCOMPATIBLE_WITH_TRAFFIC = 1211；
  • REQUEST_OPTIONS_MULTIPLE_TRAFFIC_FLAVORS = 1212；
  • REQUEST_OPTIONS_INVALID_TRAFFIC_FLAVOR = 1213；
  • REQUEST_OPTIONS_TRAFFIC_ENABLED_WITHOUT_GLOBAL_START_TIME = 1214；
  • REQUEST_OPTIONS_TRAFFIC_ENABLED_WITH_PRECEDENCES = 1215；
  • REQUEST_OPTIONS_TRAFFIC_PREFILL_MODE_INVALID = 1216；
  • REQUEST_OPTIONS_TRAFFIC_PREFILL_ENABLED_WITHOUT_TRAFFIC = 1217；
• INJECTED_SOLUTION_ERROR = 20； <ph type="x-smartling-placeholder">
  </ph>
  • INJECTED_SOLUTION_MISSING_LABEL = 2000；
  • INJECTED_SOLUTION_DUPLICATE_LABEL = 2001；
  • INJECTED_SOLUTION_AMBIGUOUS_INDEX = 2002；
  • INJECTED_SOLUTION_INFEASIBLE_REMAINING_GETTING_TRAVEL_TIMES = 2003；
  • INJECTED_SOLUTION_TRANSITION_INCONSISTENT_WITH_ACTUAL_TRAVEL = 2004；
  • INJECTED_SOLUTION_CONCURRENT_SOLUTION_TYPES = 2005；
  • INJECTED_SOLUTION_MORE_THAN_ONE_PER_TYPE = 2006；
  • INJECTED_SOLUTION_REFRESH_WITHOUT_POPULATE = 2008；
  • INJECTED_SOLUTION_CONSTRAINED_ROUTE_PORTION_INFEASIBLE = 2010；
• SHIPMENT_MODEL_ERROR = 22； <ph type="x-smartling-placeholder">
  </ph>
  • SHIPMENT_MODEL_TOO_LARGE = 2200；
  • SHIPMENT_MODEL_TOO_MANY_CAPACITY_TYPES = 2201；
  • SHIPMENT_MODEL_GLOBAL_START_TIME_NEGATIVE_OR_NAN = 2202；
  • SHIPMENT_MODEL_GLOBAL_END_TIME_TOO_LARGE_OR_NAN = 2203；
  • SHIPMENT_MODEL_GLOBAL_START_TIME_AFTER_GLOBAL_END_TIME = 2204;
  • SHIPMENT_MODEL_GLOBAL_DURATION_TOO_LONG = 2205；
  • SHIPMENT_MODEL_MAX_ACTIVE_VEHICLES_NOT_POSITIVE = 2206；
  • SHIPMENT_MODEL_DURATION_MATRIX_TOO_LARGE = 2207；
• INDEX_ERROR = 24；
• TAG_ERROR = 26；
• TIME_WINDOW_ERROR = 28； <ph type="x-smartling-placeholder">
  </ph>
  • TIME_WINDOW_INVALID_START_TIME = 2800；
  • TIME_WINDOW_INVALID_END_TIME = 2801；
  • TIME_WINDOW_INVALID_SOFT_START_TIME = 2802；
  • TIME_WINDOW_INVALID_SOFT_END_TIME = 2803；
  • TIME_WINDOW_OUTSIDE_GLOBAL_TIME_WINDOW = 2804；
  • TIME_WINDOW_START_TIME_AFTER_END_TIME = 2805；
  • TIME_WINDOW_INVALID_COST_PER_HOUR_BEFORE_SOFT_START_TIME = 2806；
  • TIME_WINDOW_INVALID_COST_PER_HOUR_AFTER_SOFT_END_TIME = 2807；
  • TIME_WINDOW_COST_BEFORE_SOFT_START_TIME_WITHOUT_SOFT_START_TIME = 2808；
  • TIME_WINDOW_COST_REMAINING_SOFT_END_TIME_WITHOUT_SOFT_END_TIME = 2809；
  • TIME_WINDOW_SOFT_START_TIME_WITHOUT_COST_BEFORE_SOFT_START_TIME = 2810；
  • TIME_WINDOW_SOFT_END_TIME_WITHOUT_COST_REMAINING_SOFT_END_TIME = 2811；
  • TIME_WINDOW_OVERLAPPING_ADJACENT_OR_EARLIER_THAN_PREVIOUS = 2812；
  • TIME_WINDOW_START_TIME_AFTER_SOFT_START_TIME = 2813；
  • TIME_WINDOW_SOFT_START_TIME_AFTER_END_TIME = 2814；
  • TIME_WINDOW_START_TIME_REMAINING_SOFT_END_TIME = 2815；
  • TIME_WINDOW_SOFT_END_TIME_AFTER_END_TIME = 2816；
  • TIME_WINDOW_COST_BEFORE_SOFT_START_TIME_SET_AND_MULTIPLE_WINDOWS = 2817；
  • TIME_WINDOW_COST_REMAINING_SOFT_END_TIME_SET_AND_MULTIPLE_WINDOWS = 2818；
  • TRANSITION_ATTRIBUTES_ERROR = 30；
  • TRANSITION_ATTRIBUTES_INVALID_COST = 3000；
  • TRANSITION_ATTRIBUTES_INVALID_COST_PER_KILOMETER = 3001；
  • TRANSITION_ATTRIBUTES_DUPLICATE_TAG_PAIR = 3002；
  • TRANSITION_ATTRIBUTES_DISTANCE_LIMIT_MAX_METERS_UNSUPPORTED = 3003；
  • TRANSITION_ATTRIBUTES_UNSPECIFIED_SOURCE_TAGS = 3004；
  • TRANSITION_ATTRIBUTES_CONFLICTING_SOURCE_TAGS_FIELDS = 3005；
  • TRANSITION_ATTRIBUTES_UNSPECIFIED_DESTINATION_TAGS = 3006；
  • TRANSITION_ATTRIBUTES_CONFLICTING_DESTINATION_TAGS_FIELDS = 3007；
  • TRANSITION_ATTRIBUTES_DELAY_DURATION_NEGATIVE_OR_NAN = 3008；
  • TRANSITION_ATTRIBUTES_DELAY_DURATION_EXCEEDS_GLOBAL_DURATION = 3009；
• AMOUNT_ERROR = 31； <ph type="x-smartling-placeholder">
  </ph>
  • AMOUNT_NEGATIVE_VALUE = 3100；
• LOAD_LIMIT_ERROR = 33； <ph type="x-smartling-placeholder">
  </ph>
  • LOAD_LIMIT_INVALID_COST_ABOVE_SOFT_MAX = 3303；
  • LOAD_LIMIT_SOFT_MAX_WITHOUT_COST_ABOVE_SOFT_MAX = 3304；
  • LOAD_LIMIT_COST_ABOVE_SOFT_MAX_WITHOUT_SOFT_MAX = 3305；
  • LOAD_LIMIT_NEGATIVE_SOFT_MAX = 3306；
  • LOAD_LIMIT_MIXED_DEMAND_TYPE = 3307；
  • LOAD_LIMIT_MAX_LOAD_NEGATIVE_VALUE = 3308；
  • LOAD_LIMIT_SOFT_MAX_ABOVE_MAX = 3309；
• INTERVAL_ERROR = 34； <ph type="x-smartling-placeholder">
  </ph>
  • INTERVAL_MIN_EXCEEDS_MAX = 3401；
  • INTERVAL_NEGATIVE_MIN = 3402；
  • INTERVAL_NEGATIVE_MAX = 3403；
  • INTERVAL_MIN_EXCEEDS_CAPACITY = 3404；
  • INTERVAL_MAX_EXCEEDS_CAPACITY = 3405；
• DISTANCE_LIMIT_ERROR = 36； <ph type="x-smartling-placeholder">
  </ph>
  • DISTANCE_LIMIT_INVALID_COST_REMAINING_SOFT_MAX = 3601；
  • DISTANCE_LIMIT_SOFT_MAX_WITHOUT_COST_REMAINING_SOFT_MAX = 3602；
  • DISTANCE_LIMIT_COST_REMAINING_SOFT_MAX_WITHOUT_SOFT_MAX = 3603；
  • DISTANCE_LIMIT_NEGATIVE_MAX = 3604；
  • DISTANCE_LIMIT_NEGATIVE_SOFT_MAX = 3605；
  • DISTANCE_LIMIT_SOFT_MAX_LARGER_THAN_MAX = 3606；
• DURATION_LIMIT_ERROR = 38； <ph type="x-smartling-placeholder">
  </ph>
  • DURATION_LIMIT_MAX_DURATION_NEGATIVE_OR_NAN = 3800；
  • DURATION_LIMIT_SOFT_MAX_DURATION_NEGATIVE_OR_NAN = 3801；
  • DURATION_LIMIT_INVALID_COST_PER_HOUR_AFTER_SOFT_MAX = 3802；
  • DURATION_LIMIT_SOFT_MAX_WITHOUT_COST_REMAINING_SOFT_MAX = 3803；
  • DURATION_LIMIT_COST_REMAINING_SOFT_MAX_WITHOUT_SOFT_MAX = 3804；
  • DURATION_LIMIT_QUADRATIC_SOFT_MAX_DURATION_NEGATIVE_OR_NAN = 3805；
  • DURATION_LIMIT_INVALID_COST_REMAINING_QUADRATIC_SOFT_MAX = 3806；
  • DURATION_LIMIT_QUADRATIC_SOFT_MAX_WITHOUT_COST_PER_SQUARE_HOUR = 3807；
  • DURATION_LIMIT_COST_PER_SQUARE_HOUR_WITHOUT_QUADRATIC_SOFT_MAX = 3808；
  • DURATION_LIMIT_QUADRATIC_SOFT_MAX_WITHOUT_MAX = 3809；
  • DURATION_LIMIT_SOFT_MAX_LARGER_THAN_MAX = 3810；
  • DURATION_LIMIT_QUADRATIC_SOFT_MAX_LARGER_THAN_MAX = 3811；
  • DURATION_LIMIT_DIFF_BETWEEN_MAX_AND_QUADRATIC_SOFT_MAX_TOO_LARGE = 3812；
  • DURATION_LIMIT_MAX_DURATION_EXCEEDS_GLOBAL_DURATION = 3813；
  • DURATION_LIMIT_SOFT_MAX_DURATION_EXCEEDS_GLOBAL_DURATION = 3814；
  • DURATION_LIMIT_QUADRATIC_SOFT_MAX_DURATION_EXCEEDS_GLOBAL_DURATION = 3815；
• SHIPMENT_ERROR = 40； <ph type="x-smartling-placeholder">
  </ph>
  • SHIPMENT_PD_LIMIT_WITHOUT_PICKUP_AND_DELIVERY = 4014；
  • SHIPMENT_PD_ABSOLUTE_DETOUR_LIMIT_DURATION_NEGATIVE_OR_NAN = 4000；
  • SHIPMENT_PD_ABSOLUTE_DETOUR_LIMIT_DURATION_EXCEEDS_GLOBAL_DURATION = 4001；
  • SHIPMENT_PD_RELATIVE_DETOUR_LIMIT_INVALID = 4015；
  • SHIPMENT_PD_DETOUR_LIMIT_AND_EXTRA_VISIT_DURATION = 4016；
  • SHIPMENT_PD_TIME_LIMIT_DURATION_NEGATIVE_OR_NAN = 4002；
  • SHIPMENT_PD_TIME_LIMIT_DURATION_EXCEEDS_GLOBAL_DURATION = 4003；
  • SHIPMENT_EMPTY_SHIPMENT_TYPE = 4004；
  • SHIPMENT_NO_PICKUP_NO_DELIVERY = 4005；
  • SHIPMENT_INVALID_PENALTY_COST = 4006；
  • SHIPMENT_ALLOWED_VEHICLE_INDEX_OUT_OF_BOUNDS = 4007；
  • SHIPMENT_DUPLICATE_ALLOWED_VEHICLE_INDEX = 4008；
  • SHIPMENT_INCONSISTENT_COST_FOR_VEHICLE_SIZE_WITHOUT_INDEX = 4009；
  • SHIPMENT_INCONSISTENT_COST_FOR_VEHICLE_SIZE_WITH_INDEX = 4010；
  • SHIPMENT_INVALID_COST_FOR_VEHICLE = 4011；
  • SHIPMENT_COST_FOR_VEHICLE_INDEX_OUT_OF_BOUNDS = 4012；
  • SHIPMENT_DUPLICATE_COST_FOR_VEHICLE_INDEX = 4013；
• VEHICLE_ERROR = 42； <ph type="x-smartling-placeholder">
  </ph>
  • VEHICLE_EMPTY_REQUIRED_OPERATOR_TYPE = 4200；
  • VEHICLE_DUPLICATE_REQUIRED_OPERATOR_TYPE = 4201；
  • VEHICLE_NO_OPERATOR_WITH_REQUIRED_OPERATOR_TYPE = 4202；
  • VEHICLE_EMPTY_START_TAG = 4203；
  • VEHICLE_DUPLICATE_START_TAG = 4204；
  • VEHICLE_EMPTY_END_TAG = 4205；
  • VEHICLE_DUPLICATE_END_TAG = 4206；
  • VEHICLE_EXTRA_VISIT_DURATION_NEGATIVE_OR_NAN = 4207；
  • VEHICLE_EXTRA_VISIT_DURATION_EXCEEDS_GLOBAL_DURATION = 4208；
  • VEHICLE_EXTRA_VISIT_DURATION_EMPTY_KEY = 4209；
  • VEHICLE_FIRST_SHIPMENT_INDEX_OUT_OF_BOUNDS = 4210；
  • VEHICLE_FIRST_SHIPMENT_IGNORED = 4211；
  • VEHICLE_FIRST_SHIPMENT_NOT_BOUND = 4212；
  • VEHICLE_LAST_SHIPMENT_INDEX_OUT_OF_BOUNDS = 4213；
  • VEHICLE_LAST_SHIPMENT_IGNORED = 4214；
  • VEHICLE_LAST_SHIPMENT_NOT_BOUND = 4215；
  • VEHICLE_IGNORED_WITH_USED_IF_ROUTE_IS_EMPTY = 4216；
  • VEHICLE_INVALID_COST_PER_KILOMETER = 4217；
  • VEHICLE_INVALID_COST_PER_HOUR = 4218；
  • VEHICLE_INVALID_COST_PER_TRAVELED_HOUR = 4219；
  • VEHICLE_INVALID_FIXED_COST = 4220；
  • VEHICLE_INVALID_TRAVEL_DURATION_MULTIPLE = 4221；
  • VEHICLE_TRAVEL_DURATION_MULTIPLE_WITH_SHIPMENT_PD_DETOUR_LIMITS = 4223；
  • VEHICLE_MATRIX_INDEX_WITH_SHIPMENT_PD_DETOUR_LIMITS = 4224；
  • VEHICLE_MINIMUM_DURATION_LONGER_THAN_DURATION_LIMIT = 4222；
• VISIT_REQUEST_ERROR = 44； <ph type="x-smartling-placeholder">
  </ph>
  • VISIT_REQUEST_EMPTY_TAG = 4400；
  • VISIT_REQUEST_DUPLICATE_TAG = 4401；
  • VISIT_REQUEST_DURATION_NEGATIVE_OR_NAN = 4404；
  • VISIT_REQUEST_DURATION_EXCEEDS_GLOBAL_DURATION = 4405；
• PRECEDENCE_ERROR = 46；
• BREAK_ERROR = 48； <ph type="x-smartling-placeholder">
  </ph>
  • BREAK_RULE_EMPTY = 4800；
  • BREAK_REQUEST_UNSPECIFIED_DURATION = 4801；
  • BREAK_REQUEST_UNSPECIFIED_EARLIEST_START_TIME = 4802；
  • BREAK_REQUEST_UNSPECIFIED_LATEST_START_TIME = 4803；
  • BREAK_REQUEST_DURATION_NEGATIVE_OR_NAN = 4804；= 4804；
  • BREAK_REQUEST_LATEST_START_TIME_BEFORE_EARLIEST_START_TIME = 4805；
  • BREAK_REQUEST_EARLIEST_START_TIME_BEFORE_GLOBAL_START_TIME = 4806;
  • BREAK_REQUEST_LATEST_END_TIME_AFTER_GLOBAL_END_TIME = 4807；
  • BREAK_REQUEST_NON_SCHEDULABLE = 4808；
  • BREAK_FREQUENCY_MAX_INTER_BREAK_DURATION_NEGATIVE_OR_NAN = 4809；
  • BREAK_FREQUENCY_MIN_BREAK_DURATION_NEGATIVE_OR_NAN = 4810；
  • BREAK_FREQUENCY_MIN_BREAK_DURATION_EXCEEDS_GLOBAL_DURATION = 4811；
  • BREAK_FREQUENCY_MAX_INTER_BREAK_DURATION_EXCEEDS_GLOBAL_DURATION = 4812；
  • BREAK_REQUEST_DURATION_EXCEEDS_GLOBAL_DURATION = 4813；
  • BREAK_FREQUENCY_MISSING_MAX_INTER_BREAK_DURATION = 4814；
  • BREAK_FREQUENCY_MISSING_MIN_BREAK_DURATION = 4815；
• SHIPMENT_TYPE_INCOMPATIBILITY_ERROR = 50； <ph type="x-smartling-placeholder">
  </ph>
  • SHIPMENT_TYPE_INCOMPATIBILITY_EMPTY_TYPE = 5001；
  • SHIPMENT_TYPE_INCOMPATIBILITY_LESS_THAN_TWO_TYPES = 5002；
  • SHIPMENT_TYPE_INCOMPATIBILITY_DUPLICATE_TYPE = 5003；
  • SHIPMENT_TYPE_INCOMPATIBILITY_INVALID_INCOMPATIBILITY_MODE = 5004；
  • SHIPMENT_TYPE_INCOMPATIBILITY_TOO_MANY_INCOMPATIBILITY = 5005；
• SHIPMENT_TYPE_REQUIREMENT_ERROR = 52； <ph type="x-smartling-placeholder">
  </ph>
  • SHIPMENT_TYPE_REQUIREMENT_NO_REQUIRED_TYPE = 52001；
  • SHIPMENT_TYPE_REQUIREMENT_NO_DEPENDENT_TYPE = 52002；
  • SHIPMENT_TYPE_REQUIREMENT_INVALID_REQUIREMENT_MODE = 52003；
  • SHIPMENT_TYPE_REQUIREMENT_TOO_MANY_REQUIREMENTS = 52004；
  • SHIPMENT_TYPE_REQUIREMENT_EMPTY_REQUIRED_TYPE = 52005；
  • SHIPMENT_TYPE_REQUIREMENT_DUPLICATE_REQUIRED_TYPE = 52006；
  • SHIPMENT_TYPE_REQUIREMENT_NO_REQUIRED_TYPE_FOUND = 52007；
  • SHIPMENT_TYPE_REQUIREMENT_EMPTY_DEPENDENT_TYPE = 52008；
  • SHIPMENT_TYPE_REQUIREMENT_DUPLICATE_DEPENDENT_TYPE = 52009；
  • SHIPMENT_TYPE_REQUIREMENT_SELF_DEPENDENT_TYPE = 52010；
  • SHIPMENT_TYPE_REQUIREMENT_GRAPH_HAS_CYCLES = 52011；
• VEHICLE_OPERATOR_ERROR = 54； <ph type="x-smartling-placeholder">
  </ph>
  • VEHICLE_OPERATOR_EMPTY_TYPE = 5400；
  • VEHICLE_OPERATOR_MULTIPLE_START_TIME_WINDOWS = 5401；
  • VEHICLE_OPERATOR_SOFT_START_TIME_WINDOW = 5402；
  • VEHICLE_OPERATOR_MULTIPLE_END_TIME_WINDOWS = 5403；
  • VEHICLE_OPERATOR_SOFT_END_TIME_WINDOW = 5404；
• DURATION_SECONDS_MATRIX_ERROR = 56； <ph type="x-smartling-placeholder">
  </ph>
  • DURATION_SECONDS_MATRIX_DURATION_NEGATIVE_OR_NAN = 5600；
  • DURATION_SECONDS_MATRIX_DURATION_EXCEEDS_GLOBAL_DURATION = 5601；

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 之间存在 1 对 1 映射（如果代码 != "UNSPECIFIED"）。

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

string

可以包含字段的值。此功能不一定始终可用。您绝对不能依赖它，而只能将其用于手动模型调试。

string

字段的名称，例如“vehicles”

FieldReference

以递归方式嵌套子字段（如果需要）。

int32

字段的索引（如果重复）。

string

键（如果字段是映射）。

DataFormat

必需。输出数据格式。

GcsDestination

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

string

用户定义的运单显示名称。长度不得超过 63 个字符，且可以使用 UTF-8 字符。

VisitRequest

与运单关联的一组备选自提选项。如果未指定，车辆只需前往与送货相对应的地点。

VisitRequest

与运单关联的一组备选配送方式。如果未指定，车辆只需前往与上车点相对应的位置。

map<string, Load>

加载货物需求信息（例如重量、体积、托盘数量等）。映射中的键应该是描述相应加载类型的标识符，最好也包括单位。例如：“weight_kg”“volume_gallons”“pallet_count”等。如果给定键未出现在映射中，则相应的加载会被视为 null。

int32

可以履行此运单的一组车辆。如果留空，所有车辆都可以执行此操作。车辆由其在 ShipmentModel 的 vehicles 列表中的索引指定。

double

指定每辆车交付此运单时产生的费用。如果指定，它必须具有以下 EITHER：

• 元素数量与 costs_per_vehicle_indices 相同。costs_per_vehicle[i] 对应于模型的车辆 costs_per_vehicle_indices[i]。
• 元素数量与模型中车辆数量相同。第 i-th 元素对应于模型的第 #i 辆车。

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

int32

costs_per_vehicle 所适用的车辆的索引。如果非空，则其元素数量必须与 costs_per_vehicle 相同。一个车辆索引只能指定一次。如果某个车辆已从 costs_per_vehicle_indices 中排除，则其费用为零。

Duration

指定与从自提到送餐的最短路径相比的最长绝对绕行时间。如果指定，则必须为非负数，并且运单中必须至少包含自提和送货信息。

例如，可以是从所选的自提备选方案直接到所选的备选配送方式所需的最短时间。然后，设置 pickup_to_delivery_absolute_detour_limit 会强制执行：

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

如果为同一批商品同时指定了相对限制和绝对限制，系统会对每个可能的自提/送货对使用更具限制性的限制。从 2017 年 10 月 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

指定与从自提到送餐的最短路径相比的最长相对绕行时间。如果指定，则必须为非负数，并且运单中必须至少包含自提和送货信息。

例如，可以是从所选的自提备选方案直接到所选的备选配送方式所需的最短时间。然后，设置 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 月 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。

Shipment

一组必须在模型中执行的运单。

Vehicle

可用于执行访问的车辆集。

Timestamp

模型的全局开始时间和结束时间：此范围以外的时间都不能视为有效时间。

模型的时间跨度必须少于 1 年，即 global_end_time 和 global_start_time 之间的间隔必须在 31536000 秒以内。

使用 cost_per_*hour 字段时，不妨将此时间范围设置为较小的时间间隔以提高性能（例如，如果您针对一天进行建模，则应将全局时间限制设置为当天）。如果未设置，系统将使用 1970 年 1 月 1 日 00:00:00 世界协调时间 (UTC)（即秒数：0，纳米：0）作为默认值。

Timestamp

如果未设置，系统将使用世界协调时间 (UTC) 1971 年 1 月 1 日 00:00:00（即秒数：31536000，纳米：0）作为默认值。

double

“全局持续时间”是指所有车辆的最早有效开始时间与最晚有效结束时间之间的差值。例如，用户可以为此数量指定每小时费用，以尝试进行优化，以便尽早完成作业。此费用必须与Shipment.penalty_cost使用同一个单位。

DurationDistanceMatrix

指定模型中使用的时长和距离矩阵。如果此字段为空，则会根据 use_geodesic_distances 字段的值，改用 Google 地图距离或测地距离。如果不为空，则 use_geodesic_distances 不为 true，duration_distance_matrix_src_tags 和 duration_distance_matrix_dst_tags 均不得为空。

用法示例：

• 有两个位置：locA 和 locB。
• 1 辆车在 locA 开始其路线，并在 locA 结束行驶。
• 1 次在 locB 提交的自提上门服务请求。

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 结束。
• 使用矩阵“慢”的 1 辆车在 locB 开始其路线并在 locB 结束。
• 使用矩阵“快速”的 1 辆车在 locB 开始其路线并在 locB 结束。
• 1 次在 locC 提交的自提上门服务请求。

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) 标记的访问到矩阵 i 中带有 duration_distance_matrix_dst_tags(k) 标记的访问的行程时长（代表距离）。

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

TransitionAttributes

添加到模型的过渡属性。

ShipmentTypeIncompatibility

不兼容的 shipping_types 集（请参阅 ShipmentTypeIncompatibility）。

ShipmentTypeRequirement

shipment_type 要求集（请参阅 ShipmentTypeRequirement）。

PrecedenceRule

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

int32

限制有效车辆的最大数量。如果车辆的路线至少完成一次送货，则车辆处于活跃状态。在司机数量少于车辆数量且车队类型不多时，可以使用此属性来限制路线数量。然后，优化操作会选择最合适的车辆子集进行使用。必须是正数。

Row

指定时长和距离矩阵的行。它包含的元素数量必须与 ShipmentModel.duration_distance_matrix_src_tags 一样多。

string

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

每次车辆启动都必须与一个矩阵完全一致，即其中一个 start_tags 字段必须与矩阵（且仅限该矩阵）的 vehicle_start_tag 匹配。

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

Duration

给定行的时长值。它包含的元素数量必须与 ShipmentModel.duration_distance_matrix_dst_tags 一样多。

double

给定行的距离值。如果模型中的距离没有任何费用或约束条件，则可以留空；否则，它的元素数量必须与 durations 相同。

bool

指明其是否为“第一个”事件是交付事件。

bool

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

Duration

“第一个”和“second”事件。它可以为负值。

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 求和，具体取决于上下文。

map<string, double>

路由的费用，按与费用相关的请求字段细分。键是相对于输入 OptimizationToursRequest 的 proto 路径，例如："model.shipments.pickups.cost"，这些值是相应费用字段生成的总费用，汇总到整个路线中。换句话说，cost["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 时，系统才会填充此字段。

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 中指定）。

string

不兼容的类型列表。列出的 shipment_types 不同的两件运单是“不兼容”的。

IncompatibilityMode

应用于不兼容的模式。

string

dependent_shipment_types要求的备选运单类型的列表。

string

对于所有属于“dependent_shipment_types”字段的运单，同一条航线上必须有至少 1 个类型为 required_shipment_type_alternatives 的运单。

注意：不允许使用导致 shipment_type 依赖于自身的要求链。

RequirementMode

应用于要求的模式。

int32

该指数与来源 ShipmentModel 中的运单对应的索引。

string

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

Reason

解释为何跳过发货的原因列表。查看 Reason 上方的评论。

Code

请参阅代码的注释。

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

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

TravelMode

会影响车辆可使用的道路及其速度的出行方式。另请参阅 travel_duration_multiple。

LatLng

车辆在取走任何货物之前出发的地理位置。如果未指定，车辆会在首次上车点启动。如果运单模型具有时长和距离矩阵，则不得指定 start_location。

Waypoint

表示车辆在取走任何货物前出发的地理位置的航点。如果 start_waypoint 和 start_location 均未指定，则车辆会在首次上车点启动。如果运单模型具有时长和距离矩阵，则不得指定 start_waypoint。

LatLng

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

Waypoint

表示车辆在结束上一个VisitRequest后结束的地理位置的航点。如果 end_waypoint 和 end_location 均未指定，则车辆的 ShipmentRoute 将在完成最后一个 VisitRequest 后立即结束。如果运单模型具有时长和距离矩阵，则不得指定 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 的访问时获取的 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

可接受的最大负载量。

int64

可接受的最小负载。必须 ≥ 0。如果同时指定这两者，则 min 必须 ≤ max。

int64

可接受的最大负载。必须 ≥ 0。如果未指定最大负载，则不受此消息的限制。如果同时指定这两者，则 min 必须 ≤ max。

bool

可选。表示此航点的位置优先让车辆停靠在道路的某一侧。设置此值后，路线会经过相应位置，这样车辆才能在偏离道路中心的道路一侧停靠。此选项不适用于“步行”出行方式。

Location

使用地理坐标指定的点，包含可选标题。

string

与航点相关联的地图注点地点 ID。