OptimizeToursResponse

解决巡回优化问题后的响应，其中包含每辆车行驶的路线、已跳过的运输以及解决方案的总费用。

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

object (ShipmentRoute)

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

string

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

object (SkippedShipment)

所有已跳过的配送的列表。
validationErrors[]

object (OptimizeToursValidationError)

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

object (OptimizeToursRequest)

在某些情况下，我们会先修改传入请求，然后再解决它，例如增加费用。如果 solvingMode == TRANSFORM_AND_RETURN_REQUEST，则此处会返回经过修改的请求。

实验性功能：如需了解详情，请参阅 https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request。
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) 对，因为新错误会掩盖旧错误。例如，请参阅“MULTIPLE ERRORS”。
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 之间存在一对一的映射关系（当 code !=“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 的最小值。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
latestVehicleEndTime

string (Timestamp format)

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

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
costs

map (key: string, value: number)

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

number

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