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)

列出我們能夠獨立偵測到的所有驗證錯誤。請參閱「MULTIPLE ERRORS」一節，瞭解 OptimizeToursValidationError 訊息的說明。在 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 之間的對應關係為 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 的最小值。

使用 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

解決方案的總費用。成本對應項目中的所有值總和。