OptimizeToursResponse

• JSON 表示法
• OptimizeToursValidationError
  • JSON 表示法
• FieldReference
  • JSON 表示法
• 指标
  • JSON 表示法

解决游览优化问题后的响应，其中包含每辆车跟随路线、跳过的运单以及解决方案的总成本。

JSON 表示法
{ "routes": [ { object (ShipmentRoute) } ], "requestLabel": string, "skippedShipments": [ { object (SkippedShipment) } ], "validationErrors": [ { object (OptimizeToursValidationError) } ], "metrics": { object (Metrics) } }

字段
routes[]	object (ShipmentRoute) 为每辆车计算的路线；第 i 条路线对应于模型中的第 i 条车辆。
requestLabel	string OptimizeToursRequest.label 的副本（如果在请求中指定了标签）。
skippedShipments[]	object (SkippedShipment) 已跳过所有运单的列表。
validationErrors[]	object (OptimizeToursValidationError) 我们能够独立检测到的所有验证错误的列表。请参阅针对 OptimizeToursValidationError 消息的“多个错误”说明。
metrics	object (Metrics) 此解决方案的时长、距离和用量指标。

OptimizeToursValidationError

描述验证 OptimizeToursRequest 时遇到的错误。

JSON 表示法
{ "code": integer, "displayName": string, "fields": [ { object (FieldReference) } ], "errorMessage": string, "offendingValues": string }

字段
code	integer 验证错误由始终存在的键值对（code、displayName）定义。 其他字段（见下文）提供了有关该错误的更多背景信息。 多个错误：当存在多个错误时，验证流程会尝试输出多个错误。这个过程与编译器非常相似，但并不完美。有些验证错误是“严重”错误，也就是说，这些错误会停止整个验证流程。displayName="UNSPECIFIED" 错误就是如此。有些错误可能会导致验证流程跳过其他错误。 STABILITY：code 和 displayName 应该非常稳定。不过，随着时间的推移，可能会出现新的代码和显示名称，这可能会导致给定的（无效）请求产生不同的 (code, displayName) 对，因为新错误隐藏了旧错误（请参阅“多重错误”）。 参考：所有（代码、名称）对的列表： UNSPECIFIED = 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; INJECTED_SOLUTION_MISSING_LABEL = 2000； INJECTED_SOLUTION_DUPLICATE_LABEL = 2001； INJECTED_SOLUTION_AMBIGUOUS_INDEX = 2002； INJECTED_SOLUTION_INFEASIBLE_after_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； 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; 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_ After_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_after_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_after_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_after_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； AMOUNT_NEGATIVE_VALUE = 3100； LOAD_LIMIT_ERROR = 33; 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; 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; DISTANCE_LIMIT_INVALID_COST_after_SOFT_MAX = 3601； DISTANCE_LIMIT_SOFT_MAX_WITHOUT_COST_after_SOFT_MAX = 3602； DISTANCE_LIMIT_COST_after_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； DURATION_LIMIT_MAX_DURATION_NEGATIVE_OR_NAN = 3800； DURATION_LIMIT_SOFT_MAX_DURATION_NEGATIVE_OR_NAN = 3801； DURATION_LIMIT_INVALID_COST_PER_HOUR_webkit_SOFT_MAX = 3802； DURATION_LIMIT_SOFT_MAX_WITHOUT_COST_after_SOFT_MAX = 3803； DURATION_LIMIT_COST_after_SOFT_MAX_WITHOUT_SOFT_MAX = 3804； DURATION_LIMIT_QUADRATIC_SOFT_MAX_DURATION_NEGATIVE_OR_NAN = 3805； DURATION_LIMIT_INVALID_COST_after_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； 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; 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; 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; 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； 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_INCOMPATIBILITIES = 5005； SHIPMENT_TYPE_REQUIREMENT_ERROR = 52； 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; 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； DURATION_SECONDS_MATRIX_DURATION_NEGATIVE_OR_NAN = 5600； DURATION_SECONDS_MATRIX_DURATION_EXCEEDS_GLOBAL_DURATION = 5601；
displayName	string 错误的显示名称。
fields[]	object (FieldReference) 错误上下文可能涉及 0、1（大多数情况下）或更多字段。例如，引用车辆 4 和运单 2 的首次取货，可如下执行： fields { name: "vehicles" index: 4} fields { name: "shipments" index: 2 subField {name: "pickups" index: 0} } 但请注意，fields 的基数不应因给定错误代码而改变。
errorMessage	string 用于描述错误的一种人类可读字符串。code 和 errorMessage（当代码 !=“UNSPECIFIED”时）之间是 1:1 的映射。 STABILITY：不稳定：与给定 code 关联的错误消息可能会随着时间的推移而发生变化（希望能加以说明）。请改用 displayName 和 code。
offendingValues	string 可能包含字段值。此功能并非始终可用。您绝对不应该依赖它，而是仅将其用于手动模型调试。

FieldReference

指定验证错误的上下文。FieldReference 始终引用此文件中的给定字段，并遵循相同的层次结构。例如，我们可以使用以下命令指定车辆 5 的 startTimeWindows 的元素 #2：

name: "vehicles" index: 5 subField { name: "endTimeWindows" index: 2 }

不过，我们会省略 OptimizeToursRequest 或 ShipmentModel 等顶级实体，以避免拥挤消息。

JSON 表示法
{ "name": string, "subField": { object (FieldReference) }, // Union field index_or_key can be only one of the following: "index": integer, "key": string // End of list of possible types for union field index_or_key. }

字段
name	string 字段的名称，例如“车辆”。
subField	object (FieldReference) 如果需要，以递归方式嵌套子字段。
联合字段 index_or_key。 index_or_key 只能是下列其中一项：
index	integer 字段的索引（如果重复）。
key	string 如果字段是映射，则为键。

指标

汇总所有路由的总体指标。

JSON 表示法
{ "aggregatedRouteMetrics": { object (AggregatedMetrics) }, "skippedMandatoryShipmentCount": integer, "usedVehicleCount": integer, "earliestVehicleStartTime": string, "latestVehicleEndTime": string, "costs": { string: number, ... }, "totalCost": number }

字段
aggregatedRouteMetrics	object (AggregatedMetrics) 汇总路由。每个指标都是所有同名 ShipmentRoute.metrics 字段的总和（对于加载，则为最大值）。
skippedMandatoryShipmentCount	integer 跳过的强制发货数量。
usedVehicleCount	integer 所用车辆的数量。注意：如果车辆路线为空且 Vehicle.used_if_route_is_empty 为 true，系统会将车辆视为已使用。
earliestVehicleStartTime	string (Timestamp format) 二手车辆的最早启动时间，按 ShipmentRoute.vehicle_start_time期间所有二手车辆的最小值计算。 采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式的时间戳，采用纳秒级精度，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
latestVehicleEndTime	string (Timestamp format) 二手车的最晚结束时间，按ShipmentRoute.vehicle_end_time期间所有二手车辆的最长结束时间计算。 采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式的时间戳，采用纳秒级精度，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
costs	map (key: string, value: number) 解决方案的费用，按与费用相关的请求字段细分。键是相对于输入 OptimizeToursRequest 的 proto 路径，例如“model.shipments.pickups.cost”，值是相应费用字段生成的总费用，在整个解决方案中进行了汇总。换句话说，费用 ["model.shipments.pickups.cost"] 是解决方案中所有自提费用的总和。此处报告了模型中定义的所有费用，但与 TransitionAttributes 相关的费用除外，这些费用在 2022 年 1 月之前仅以汇总方式报告。 包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
totalCost	number 解决方案的总费用。费用映射中所有值的总和。