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）で定義されます。

このセクションの後のフィールドには、エラーに関する詳細なコンテキストが表示されます。

複数のエラー: エラーが複数ある場合、検証プロセスは複数のエラーを出力しようとします。コンパイラのように、これは不完全なプロセスです。検証エラーの中には「致命的」なものがあり、検証プロセス全体が停止します。displayName="UNSPECIFIED" エラーなどがこれに該当します。一部のエラーにより、検証プロセスで他のエラーがスキップされる場合があります。

STABILITY: 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 で対応しています（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 の最小値として計算されます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
latestVehicleEndTime

string (Timestamp format)

中古車の最も遅い終了時間。ShipmentRoute.vehicle_end_time のすべての中古車における最大値として計算されます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
costs

map (key: string, value: number)

ソリューションのコスト。費用関連のリクエスト フィールド別に分類されます。キーは、入力 OptimizeToursRequest を基準としたプロトパスです（例: model.shipments.pickups.cost）。値は、対応する費用フィールドによって生成された合計費用で、ソリューション全体で集計されます。つまり、costs["model.shipments.pickups.cost"] は、ソリューション全体の集荷費用の合計です。2022 年 1 月時点で集計された形でのみ報告される TransitionAttributes に関連する費用を除き、モデルで定義されたすべての費用は、ここで詳細に報告されます。
totalCost

number

ソリューションの総費用。費用マップのすべての値の合計。