OptimizeToursResponse

解决游览优化问题后给出的响应，其中包括每辆车所走的路线、跳过的运单以及解决方案的总体成本。

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 消息的“多个错误”说明。如果 solvingMode 为 DEFAULT_SOLVE，则会包含警告（而非错误）。
metrics

object (Metrics)

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

OptimizeToursValidationError

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

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

integer

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

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

MULTIPLE ERRORS：如果存在多个错误，验证流程会尝试输出其中的多个错误。与编译器类似，这并不是一个完美的流程。有些验证错误是“严重”错误，也就是说，它们会停止整个验证流程。displayName="UNSPECIFIED" 错误就是其中之一。某些错误可能会导致验证流程跳过其他错误。

稳定性：code 和 displayName 应非常稳定。但随着时间的推移，可能会出现新的代码和显示名称，这可能会导致给定（无效）请求产生不同的 (code, displayName) 对，因为新错误会掩盖旧错误。有关示例，请参阅“多个错误”。
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 之间存在 1 对 1 映射（如果代码 != "UNSPECIFIED"）。

稳定性：不稳定：与给定 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

字段的名称，例如“vehicles”
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)

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

number

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