Package google.maps.routeoptimization.v1

int32

実施した配送の数。受け取りと配送の組み合わせは 1 回のみカウントされます。

Duration

ルートまたはソリューションの合計移動時間。

Duration

ルートまたはソリューションの合計待機時間。

Duration

経路またはソリューションの遅延の合計時間。

Duration

ルートまたはソリューションの総休憩時間。

Duration

ルートまたはソリューションの訪問の合計時間。

Duration

合計時間は、上記のすべての時間の合計と等しくする必要があります。ルートの場合は、以下も対応します。

[ShipmentRoute.vehicle_end_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_end_time] - [ShipmentRoute.vehicle_start_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_start_time]

double

ルートまたはソリューションの総移動距離。

map<string, VehicleLoad>

ルート全体で達成された最大負荷（対応ソリューション）。このルート上の各数量（対応ソリューション）に対して計算され、すべての Transition.vehicle_loads（対応ソリューション）の最大負荷として計算されます。ShipmentRoute.metrics.max_loads

string

必須。呼び出しを行うターゲット プロジェクトとロケーション。

形式: * projects/{project-id} * projects/{project-id}/locations/{location-id}

ロケーションが指定されていない場合、リージョンは自動的に選択されます。

AsyncModelConfig

必須。各購入モデルの入力/出力情報（ファイルパスやデータ形式など）。

string

省略可。ユーザー定義のモデル名。モデルを追跡するためにユーザーがエイリアスとして使用できます。

InputConfig

必須。入力モデルに関する情報。

OutputConfig

必須。目的の出力場所情報。

BreakRequest

休憩の順序。BreakRequest メッセージをご覧ください。

FrequencyConstraint

複数のFrequencyConstraintが適用される場合があります。これらはすべて、この BreakRule の BreakRequest で満たされる必要があります。FrequencyConstraint をご覧ください。

Timestamp

必須。ブレーク開始の下限（両端を含む）。

Timestamp

必須。ブレーク開始の上限（両端を含む）。

Duration

必須。休憩の最小時間。正の値である必要があります。

Duration

必須。この制約の最小ブレーク時間。非負。FrequencyConstraint の説明をご覧ください。

Duration

必須。duration >= min_break_duration の中断部分を含まない、ルートの任意の時間間隔の最大許容スパン。正の値である必要があります。

int64

距離を最大 max_meters に制限するハードリミット。上限は負でない値にしてください。

int64

ソフトリミットは、最大距離制限を適用しませんが、違反した場合、同じ単位でモデルで定義された他のコストに加算されます。

定義する場合、soft_max_meters は max_meters よりも小さく、負でない値にする必要があります。

double

距離が soft_max_meters の上限を超える場合、1 キロメートルあたりの費用が発生します。距離が制限を下回っている場合、追加費用は 0 になります。それ以外の場合は、費用の計算に次の式が使用されます。

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

費用は負でない値にしてください。

string

必須。Google Cloud Storage URI。

string

必須。gs://bucket/path/to/object 形式の Google Cloud Storage オブジェクトの URI。

ShipmentRoute

挿入するソリューションのルート。一部のルートは、元のソリューションから省略されている場合があります。ルートとスキップされた配送は、injected_first_solution_routes に記載されている基本的な有効性の前提条件を満たす必要があります。

SkippedShipment

挿入するソリューションの発送をスキップした。一部は元のソリューションで省略されている場合があります。routes フィールドをご覧ください。

ConstraintRelaxation

0 個以上の車両グループに対して、制約を緩和するタイミングと程度を指定します。このフィールドが空の場合、空でないすべての車両経路に制約が適用されます。

Relaxation

vehicle_indices の車両が通るルートの訪問に適用されるすべての訪問制約の緩和。

int32

訪問制約 relaxations を適用する車両インデックスを指定します。空の場合、これがデフォルトとみなされ、relaxations は他の constraint_relaxations で指定されていないすべての車両に適用されます。デフォルトは 1 つだけです。つまり、vehicle_indices を空にできる制約緩和フィールドは最大で 1 つです。車両インデックスは、複数の constraint_relaxations 内でも 1 回だけリストに含めることができます。

interpret_injected_solutions_using_labels が true の場合、車両インデックスは ShipmentRoute.vehicle_index と同じようにマッピングされます（fields コメントを参照）。

Level

threshold_time 以降かつ少なくとも threshold_visit_count の条件が満たされた場合に適用される制約緩和レベル。

Timestamp

緩和 level が適用される時間。

int32

緩和 level が適用される時点またはそれ以降の訪問回数。threshold_visit_count が 0（または未設定）の場合、level を車両の開始時に直接適用できます。

route.visits_size() + 1 の場合、level は車両端にのみ適用できます。route.visits_size() + 1 より大きい場合、そのルートに level は一切適用されません。

DataFormat

必須。入力データ形式。

GcsSource

Google Cloud Storage のロケーション。これは単一のオブジェクト（ファイル）にする必要があります。

LatLng

地点の地理的座標。

int32

交通の流れの方向に関連付けられたコンパス方位。この値は、乗車場所と降車場所のどちら側かを指定するために使用されます。見出しの値は 0 から 360 までで、0 は真北の見出し、90 は真東の見出し、というようになります。

string

必須。呼び出しを行うターゲット プロジェクトまたはロケーション。

形式: * projects/{project-id} * projects/{project-id}/locations/{location-id}

ロケーションが指定されていない場合、リージョンは自動的に選択されます。

Duration

このタイムアウトが設定されている場合、サーバーは、タイムアウト期間か同期リクエストのサーバー期限のどちらか早いほうでレスポンスを返します。

非同期リクエストの場合は、タイムアウト時間が経過する前にサーバーがソリューションを生成します（可能な場合）。

ShipmentModel

解決する配送モデル。

SolvingMode

デフォルトの解決モードは DEFAULT_SOLVE（0）です。

SearchMode

リクエストの解決に使用された検索モード。

ShipmentRoute

最適化アルゴリズムをガイドして、前の解に似た最初の解を見つけます。

最初のソリューションを構築する際には、モデルに制約が課されます。あるルートで実施されなかった配送は、最初のソリューションでは暗黙的にスキップされますが、連続したソリューションでは実施される可能性があります。

このソリューションは、次のような基本的な妥当性の前提を満たしている必要があります。

• すべてのルートで、vehicle_index は範囲内にあり、重複しないようにする必要があります。
• すべての訪問で、shipment_index と visit_request_index が範囲内である必要があります。
• 配送は 1 つのルートでのみ参照できます。
• 受け取り、配達の集荷は配達前に行う必要があります。
• 1 つの配送について、複数の受け取りまたは配送の代替を行うことはできない。
• すべてのルートで所要時間が増加（vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time）。
• 許可された車両でしか発送できない場合。Shipment.allowed_vehicle_indices が空であるか、車両の vehicle_index が Shipment.allowed_vehicle_indices に含まれている場合、車両は許可されます。

挿入された解が実行不可能な場合、必ずしも検証エラーが返されるとは限らず、代わりに実行可能性を示すエラーが返されることがあります。

InjectedSolutionConstraint

最適化アルゴリズムを制約して、前の解に似た最終的な解を見つけます。たとえば、すでに完了しているルートや、もう完了するが変更してはならないルートの一部を凍結するために使用できます。

挿入された解が実行不可能な場合、必ずしも検証エラーが返されるとは限らず、代わりに実行可能性を示すエラーが返されることがあります。

ShipmentRoute

空でない場合、指定された経路は更新され、訪問や移動時間の基礎となる順序は変更されず、他の詳細情報のみが更新されます。これではモデルが解決されません。

2020/11 の時点では、空でないルートのポリラインにのみデータが入力され、populate_polylines が true である必要があります。

渡されたルートの route_polyline フィールドがルート transitions と一致しない可能性があります。

このフィールドを injected_first_solution_routes または injected_solution_constraint と併用することはできません。

Shipment.ignore と Vehicle.ignore は動作に影響しません。配送や車両が無視されるかどうかにかかわらず、空でないすべての経路のすべての訪問時にはポリラインが入力されます。

bool

true の場合:

• 挿入されたソリューションのルートとリクエスト内の車両を照合するために、vehicle_index ではなく ShipmentRoute.vehicle_label を使用します。空でない場合、元の ShipmentRoute.vehicle_index から新しい ShipmentRoute.vehicle_index へのマッピングを再利用して ConstraintRelaxation.vehicle_indices を更新しますが、マッピングは明確である必要があります（つまり、複数の ShipmentRoute で元の vehicle_index を共有することはできません）。
• 挿入されたソリューションでの訪問とリクエスト内の配送を照合するために、shipment_index ではなく ShipmentRoute.Visit.shipment_label を使用します。
• 挿入されたソリューションでスキップされた配送とリクエストの配送を照合するために、SkippedShipment.index ではなく SkippedShipment.label を使用します。

この解釈は、injected_first_solution_routes、injected_solution_constraint、refresh_details_routes フィールドに適用されます。ソリューションの作成後にリクエストの出荷数または車両のインデックスが変更された場合に使用できます。たとえば、出荷または車両がリクエストから削除または追加された場合などです。

true の場合、次のカテゴリのラベルはそのカテゴリ内に最大 1 回出現する必要があります。

• リクエスト内の Vehicle.label
• リクエスト内の Shipment.label
• 挿入されたソリューションの ShipmentRoute.vehicle_label
• 挿入されたソリューションの SkippedShipment.label と ShipmentRoute.Visit.shipment_label（受け取り/配達の訪問ペアは除きます。このペアの shipment_label は 2 回表示する必要があります）。

挿入されたソリューションの vehicle_label がリクエストの車両に対応していない場合、対応するルートは訪問とともにソリューションから削除されます。挿入されたソリューションの shipment_label が配送リクエストの対応でない場合、対応する訪問はソリューションから削除されます。挿入されたソリューションの SkippedShipment.label がリクエストの配送に対応していない場合、SkippedShipment はソリューションから削除されます。

挿入されたソリューションからルート訪問またはルート全体を削除すると、暗黙の制約に影響が及び、ソリューションの変更、検証エラー、実現不能につながる可能性があります。

注: 呼び出し元は、各 Vehicle.label（resp.Shipment.label など）は、2 つの関連リクエスト（挿入されたソリューションで使用される OptimizeToursResponse を生成した過去のリクエストと、挿入されたソリューションを含む現在のリクエスト）で使用される車両（応答配送）エンティティを一意に識別します。上記の一意性チェックは、この要件を保証するには不十分です。

bool

ShipmentRoute フィールドの Transition.travel_duration、Visit.start_time、vehicle_end_time の計算では、トラフィックの見積もりを考慮します。ShipmentRoute.has_traffic_infeasibilities フィールドの設定と OptimizeToursResponse.total_cost フィールドの計算における。

bool

true の場合、ポリラインはレスポンスの ShipmentRoute で入力されます。

bool

true の場合、ポリラインはレスポンス ShipmentRoute.transitions で入力されます。

bool

これが設定されている場合、リクエストの期限は最大 60 分です（https://grpc.io/blog/deadlines をご覧ください）。それ以外の場合、最大期限は 30 分です。実行時間が長いリクエストは、中断のリスクが大幅に高くなります（ただし、それでもわずかです）。

bool

true の場合、移動距離は Google マップの距離ではなく測地線距離を使用して計算され、移動時間は geodesic_meters_per_second で定義される速度の測地線距離を使用して計算されます。

string

このリクエストの識別に使用できるラベル。OptimizeToursResponse.request_label で報告されます。

double

use_geodesic_distances が true の場合、このフィールドを設定し、移動時間の計算に適用される速度を定義する必要があります。値は 1.0 メートル/秒以上である必要があります。

int32

返された検証エラーの数を切り捨てます。これらのエラーは通常、BadRequest エラーの詳細（https://cloud.google.com/apis/design/errors#error_details)として INVALID_ARGUMENT エラー ペイロードに添付されます。ただし、resolve_mode=VALIDATE_ONLY の場合は、OptimizeToursResponse.validation_errors フィールドを参照してください。デフォルトは 100 で、上限は 10,000 です。

ShipmentRoute

各車両で計算されたルートi 番目のルートはモデルの i 番目の車両に対応しています。

string

OptimizeToursRequest.label のコピー（リクエストでラベルが指定されている場合）。

SkippedShipment

スキップされたすべての配送のリスト。

OptimizeToursValidationError

個別に検出できたすべての検証エラーのリスト。「複数のエラー」を確認OptimizeToursValidationError メッセージの説明。

Metrics

このソリューションの期間、距離、使用状況の指標。

AggregatedMetrics

ルート全体で集計されます。各指標は、同じ名前のすべての ShipmentRoute.metrics フィールドの合計（または負荷の場合は最大）です。

int32

スキップされた必須配送の数。

int32

使用台数。注: 車両ルートが空で、Vehicle.used_if_route_is_empty が true の場合、車両は中古車と見なされます。

Timestamp

中古車の最も早い開始時間。ShipmentRoute.vehicle_start_time のすべての中古車における最小値として計算されます。

Timestamp

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

map<string, double>

ソリューションのコスト。費用関連のリクエスト フィールド別に分類されます。キーは、入力 OptimizeToursRequest に対する相対パスの proto パスです。次に例を示します。「model.shipments.pickups.cost」、値は対応する費用フィールドで生成された合計費用で、ソリューション全体で集計されます。つまり、cost["model.shipments.pickups.cost"] は、ソリューションのすべての受け取り費用の合計です。2022 年 1 月時点で集計された形でのみ報告される TransitionAttributes に関連する費用を除き、モデルで定義されたすべての費用は、ここで詳細に報告されます。

double

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

int32

検証エラーは、常に存在するペア（code、display_name）で定義されます。

その他のフィールド（下記）では、エラーの詳細なコンテキストが提供されます。

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

STABILITY: code と display_name は非常に安定しているはずです。ただし、新しいコードや表示名は時間が経つと表示される場合があります。そのため、特定の（無効な）リクエストで別の（code、display_name）ペアが生成される可能性があります。これは、新しいエラーによって古いリクエストが隠されていたためです（「複数のエラー」を参照）。

参照: すべての（コードと名前）ペアのリスト。

• 指定なし = 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; <ph type="x-smartling-placeholder">
  </ph>
  • 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; <ph type="x-smartling-placeholder">
  </ph>
  • 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; <ph type="x-smartling-placeholder">
  </ph>
  • 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; <ph type="x-smartling-placeholder">
  </ph>
  • AMOUNT_NEGATIVE_VALUE = 3100 です。
• LOAD_LIMIT_ERROR = 33; <ph type="x-smartling-placeholder">
  </ph>
  • 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; <ph type="x-smartling-placeholder">
  </ph>
  • 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; <ph type="x-smartling-placeholder">
  </ph>
  • 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; <ph type="x-smartling-placeholder">
  </ph>
  • DURATION_LIMIT_MAX_DURATION_NEGATIVE_OR_NAN = 3800;
  • DURATION_LIMIT_SOFT_MAX_DURATION_NEGATIVE_OR_NAN = 3801;
  • DURATION_LIMIT_INVALID_COST_PER_HOUR_AFTER_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;（配送エラー = 40） <ph type="x-smartling-placeholder">
  </ph>
  • SHIPMENT_PD_LIMIT_WITHOUT_PICKUP_AND_DELIVERY = 4014;
  • SHIPMENT_PD_ABSOLUTE_DETOUR_LIMIT_DURATION_NEGATIVE_OR_NAN = 4,000
  • 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; <ph type="x-smartling-placeholder">
  </ph>
  • 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; <ph type="x-smartling-placeholder">
  </ph>
  • 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; <ph type="x-smartling-placeholder">
  </ph>
  • 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;
• 配送タイプ非互換エラー = 50 <ph type="x-smartling-placeholder">
  </ph>
  • SHIPMENT_TYPE_INCOMPATIBILITY_EMPTY_TYPE = 5001（配送タイプ非互換タイプ = 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; <ph type="x-smartling-placeholder">
  </ph>
  • 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; <ph type="x-smartling-placeholder">
  </ph>
  • 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; <ph type="x-smartling-placeholder">
  </ph>
  • DURATION_SECONDS_MATRIX_DURATION_NEGATIVE_OR_NAN = 5600;
  • DURATION_SECONDS_MATRIX_DURATION_EXCEEDS_GLOBAL_DURATION = 5601;

string

エラーの表示名。

FieldReference

エラー コンテキストには、ほとんどの場合、0、1、またはそれ以上のフィールドが含まれます。たとえば、車両 #4 と配送 #2 の最初の集荷を参照するには、次のように行います。

fields { name: "vehicles" index: 4}
fields { name: "shipments" index: 2 sub_field {name: "pickups" index: 0} }

ただし、特定のエラーコードの fields のカーディナリティは変更しないでください。

string

エラーを説明する、人が読める形式の文字列。code と error_message の間には 1 対 1 のマッピングがあります（コードが != "UNSPECIFIED" の場合）。

安定性: 安定していません。特定の code に関連するエラー メッセージは、時間の経過とともに変化する可能性があります（わかりやすくなる可能性があります）。代わりに display_name と code を使用してください。

string

フィールドの値が含まれる場合があります。常に利用できるわけではありません。これに依存することは絶対に避け、モデルの手動デバッグにのみ使用してください。

string

フィールドの名前（例:「vehicles」

FieldReference

再帰的にネストされたサブフィールド（必要な場合）。

int32

繰り返される場合のフィールドのインデックス。

string

フィールドがマップの場合はキー。

DataFormat

必須。出力データ形式。

GcsDestination

出力を書き込む Google Cloud Storage の場所。

string

配送のユーザー定義の表示名。長さは 63 文字以下で、UTF-8 文字を使用できます。

VisitRequest

配送に関連付けられている受け取りの代替手段のセット。指定されていない場合、車両は配達に対応する場所を訪問するだけで済みます。

VisitRequest

配送に関連付けられた配送方法のセット。指定されていない場合、車両は乗車に対応する場所を訪問するだけで済みます。

map<string, Load>

荷物の積荷需要（重量、体積、パレット数など）。マップ内のキーは、対応する負荷のタイプを示す識別子である必要があります。また、単位も含めることが理想的です。例: 「weight_kg」、「volume_gallons」、「pallet_count」など。指定されたキーがマップにない場合、対応する負荷は null と見なされます。

int32

この配送が可能な車両のセット。空の場合、すべての車両で実行できます。車両は、ShipmentModel の vehicles リストのインデックスで指定されます。

double

この配送が各車両で配達されたときに発生する費用を指定します。指定する場合は、次のいずれかが必要です。

• costs_per_vehicle_indices と同じ数の要素にします。costs_per_vehicle[i] はモデルの車両 costs_per_vehicle_indices[i] に対応します。
• モデル内の車両と同じ数の要素が必要です。i 番目の要素は、モデルの車両 #i に対応しています。

これらの費用は penalty_cost と同じ単位で指定し、負の値にすることはできません。該当する費用がない場合は、このフィールドを空のままにします。

int32

costs_per_vehicle が適用される車両のインデックス。空でない場合は、要素数が costs_per_vehicle と同じである必要があります。車両インデックスは複数回指定できません。costs_per_vehicle_indices から除外されている車両の費用は 0 です。

Duration

受け取りから配達までの最短経路と比較して、最大絶対迂回時間を指定します。指定する場合は負の値を指定してください。配送には少なくとも受け取りと宅配の 1 つが含まれている必要があります。

たとえば、選択した受け取り方法から別の配送方法に直接移動する最短の所要時間を t とします。pickup_to_delivery_absolute_detour_limit を設定すると、次のようになります。

start_time(delivery) - start_time(pickup) <=
t + pickup_to_delivery_absolute_detour_limit

同じ配送に相対的制限と絶対的制限の両方が指定されている場合は、受け取りと配達の組み合わせごとに、より制限の厳しい制限が適用されます。2017 ～ 2010 年現在、迂回運転は、移動時間が車両に依存しない場合にのみサポートされます。

Duration

荷物の集荷から配達を開始するまでの最長期間を指定します。指定する場合は負の値を指定してください。配送には少なくとも受け取りと宅配の 1 つが含まれている必要があります。これは、受け取りと配達のためにどの代替手段を選択するか、車両の速度に依存しません。これは、最大迂回の制約とともに指定することができます。ソリューションは両方の仕様を遵守します。

string

「タイプ」を指定する空でない文字列。この機能を使用すると、shipment_types 間の非互換性や要件を定義できます（ShipmentModel の shipment_type_incompatibilities と shipment_type_requirements を参照）。

1 回の訪問に指定された visit_types と異なる場合: 同じ配送に属するすべての集荷と配達で同じ shipment_type が使用されます。

string

この配送のラベルを指定します。このラベルは、対応する ShipmentRoute.Visit の shipment_label のレスポンスで報告されます。

bool

true の場合、この配送はスキップしますが、penalty_cost は適用しません。

モデルに shipment_type_requirements がある場合、配送を無視すると、検証エラーが発生します。

injected_first_solution_routes または injected_solution_constraint で行われる配送は無視できます。ソルバーは、関連する集荷/配達の訪問を遂行ルートから削除します。無視した配送を参照する precedence_rules も無視されます。

double

配送が完了していない場合、このペナルティがルートの総費用に追加されます。集荷と配達の代替手段のいずれかを訪問した場合、配送は完了とみなされます。費用は、モデル内の費用関連フィールドのその他すべてのために使用される同じ単位で表すことができ、正の値である必要があります。

重要: このペナルティが指定されていない場合は、ペナルティは無限（配送の完了が必要）とみなされます。

double

集荷から配達までの最短経路と比較して、最大の相対的迂回時間を指定します。指定する場合は負の値を指定してください。配送には少なくとも受け取りと宅配の 1 つが含まれている必要があります。

たとえば、選択した受け取り方法から別の配送方法に直接移動する最短の所要時間を t とします。pickup_to_delivery_relative_detour_limit を設定すると、次のようになります。

start_time(delivery) - start_time(pickup) <=
std::ceil(t * (1.0 + pickup_to_delivery_relative_detour_limit))

同じ配送に相対的制限と絶対的制限の両方が指定されている場合は、受け取りと配達の組み合わせごとに、より制限の厳しい制限が適用されます。2017 ～ 2010 年現在、迂回運転は、移動時間が車両に依存しない場合にのみサポートされます。

int64

対応する訪問を実行する車両の積載量は、変動します。整数値であるため、精度の低下を避けるために適切な単位を選択することをおすすめします。0 以上にする必要があります。

LatLng

この VisitRequest の実行中に車両が到着する位置情報。配送モデルに所要時間距離行列がある場合、arrival_location は指定できません。

Waypoint

この VisitRequest の実行中に車両が到着する地点。配送モデルに所要時間距離行列がある場合、arrival_waypoint は指定できません。

LatLng

この VisitRequest の完了後に車両が出発する位置情報。arrival_location と同じである場合は省略できます。配送モデルに所要時間距離行列がある場合、departure_location は指定できません。

Waypoint

この VisitRequest を完了した後に車両が出発する地点。arrival_waypoint と同じである場合は省略できます。配送モデルに所要時間距離行列がある場合、departure_waypoint は指定できません。

string

訪問リクエストに添付するタグを指定します。空の文字列や重複する文字列は使用できません。

TimeWindow

訪問時の到着時間を制限する時間枠。車両は到着時間の範囲外に出発する可能性があります。つまり、到着時間と到着時間が時間枠の範囲内である必要はありません。車両が TimeWindow.start_time より前に到着すると、待ち時間が発生する可能性があります。

TimeWindow が存在しない場合、車両はいつでもこの訪問を実施できることを意味します。

時間枠は互いに独立している必要があります。つまり、時間枠が他の時間枠と重なったり隣接したりしてはいけません。また、時間枠は昇順である必要があります。

cost_per_hour_after_soft_end_time と soft_end_time は、時間枠が 1 つの場合にのみ設定できます。

Duration

訪問時間。つまり、到着から出発までに車両が費やした時間（予想待ち時間に加算されます。time_windows を参照）。

double

車両ルートでのこの訪問リクエストの処理にかかる費用。荷物の受け取りまたは配送ごとに、異なる送料を支払うために使用できます。この費用は Shipment.penalty_cost と同じ単位で指定し、負の値にすることはできません。

map<string, Load>

この訪問リクエストのロード デマンド。これは、Shipment 全体ではなくこの VisitRequest にのみ適用される点を除き、Shipment.load_demands フィールドと類似しています。ここに記載されている需要は、Shipment.load_demands にリストされている需要に追加されます。

string

訪問のタイプを指定します。これは、車両がこの訪問を完了するために必要な追加の時間を割り当てるために使用されることがあります（Vehicle.extra_visit_duration_for_visit_type を参照）。

タイプは 1 回しか使用できません。

string

この VisitRequest のラベルを指定します。このラベルは、対応する ShipmentRoute.Visit のレスポンスでは visit_label として報告されます。

Shipment

モデルで実行する必要がある一連の配送。

Vehicle

訪問に使用できる車両のセット。

Timestamp

モデルのグローバルな開始時刻と終了時刻: この範囲外の時刻は有効とみなされません。

モデルの期間は 1 年未満にする必要があります（例: global_end_time と global_start_time の差は 3,153,6000 秒以内）。

cost_per_*hour フィールドを使用するときは、パフォーマンスを向上させるために、この時間枠を短い間隔に設定することをおすすめします（たとえば、1 日をモデル化する場合は、グローバルな時間制限をその日に設定する必要があります）。設定しない場合、1970 年 1 月 1 日 00:00:00 UTC（つまり、秒: 0、nanos: 0）がデフォルトで使用されます。

Timestamp

未設定の場合、1971 年 1 月 1 日 00:00:00 UTC（秒: 31536000、nanos: 0）がデフォルトで使用されます。

double

「グローバル期間」すべての車両の最も早い有効開始時間と最新の有効終了時間の差です。ユーザーは、その数量に 1 時間あたりの費用を割り当てて、たとえば、最も早くジョブが完了するように最適化できます。この費用は Shipment.penalty_cost と同じ単位で指定する必要があります。

DurationDistanceMatrix

モデルで使用する期間行列と距離行列を指定します。このフィールドが空の場合、use_geodesic_distances フィールドの値に応じて、Google マップまたは測地線距離が代わりに使用されます。空でない場合、use_geodesic_distances を true にすることはできません。また、duration_distance_matrix_src_tags も duration_distance_matrix_dst_tags も空にすることはできません。

使用例:

• locA と locB の 2 つの場所があります。
• 1 台の車両が locA でルートを開始し、locA で終了しています。
• locB の集荷訪問リクエストが 1 件あります。

model {
  vehicles { start_tags: "locA"  end_tags: "locA" }
  shipments { pickups { tags: "locB" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_dst_tags: "locA"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrices {
    rows {  # from: locA
      durations { seconds: 0 }   meters: 0    # to: locA
      durations { seconds: 100 } meters: 1000 # to: locB
    }
    rows {  # from: locB
      durations { seconds: 102 } meters: 990 # to: locA
      durations { seconds: 0 }   meters: 0   # to: locB
    }
  }
}

• locA、locB、locC の 3 つの場所があります。
• 行列「fast」を使用して、1 台の車両が locA でルートを開始し、locB で終了しています。
• 1 台の車両が、「slow」という行列を使用して、locB でルートを開始し、locB で終了しています。
• 行列「fast」を使用して、1 台の車両が locB から開始し、locB で終了しています。
• locC での受け取りリクエストが 1 件あります。

model {
  vehicles { start_tags: "locA" end_tags: "locB" start_tags: "fast" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "slow" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "fast" }
  shipments { pickups { tags: "locC" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_src_tags: "locC"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrix_dst_tags: "locC"
  duration_distance_matrices {
    vehicle_start_tag: "fast"
    rows {  # from: locA
      durations { seconds: 1000 } meters: 2000 # to: locB
      durations { seconds: 600 }  meters: 1000 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }   meters: 0    # to: locB
      durations { seconds: 700 } meters: 1200 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 702 } meters: 1190 # to: locB
      durations { seconds: 0 }   meters: 0    # to: locC
    }
  }
  duration_distance_matrices {
    vehicle_start_tag: "slow"
    rows {  # from: locA
      durations { seconds: 1800 } meters: 2001 # to: locB
      durations { seconds: 900 }  meters: 1002 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }    meters: 0    # to: locB
      durations { seconds: 1000 } meters: 1202 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 1001 } meters: 1195 # to: locB
      durations { seconds: 0 }    meters: 0    # to: locC
    }
  }
}

string

期間行列と距離行列のソースを定義するタグ。duration_distance_matrices(i).rows(j) は、タグ duration_distance_matrix_src_tags(j) の付いた訪問から行列 i 内の他の訪問までの滞在時間と距離を定義します。

タグは VisitRequest.tags または Vehicle.start_tags に対応します。指定された VisitRequest または Vehicle は、このフィールドの 1 つのタグと完全に一致する必要があります。Vehicle のソースタグ、デスティネーション タグ、マトリックス タグは同じにできます。同様に、VisitRequest のソースタグと宛先タグが同じでもかまいません。タグはすべて異なっている必要があり、空の文字列にすることはできません。このフィールドが空でない場合、duration_distance_matrices を空にすることはできません。

string

期間行列と距離行列のデスティネーションを定義するタグ。duration_distance_matrices(i).rows(j).durations(k)（duration_distance_matrices(i).rows(j).meters(k)) は、行列 i でタグ duration_distance_matrix_src_tags(j) が付けられた訪問から、タグ duration_distance_matrix_dst_tags(k) が付けられている訪問までの移動時間（応答距離）を定義します。

タグは VisitRequest.tags または Vehicle.start_tags に対応します。指定された VisitRequest または Vehicle は、このフィールドの 1 つのタグと完全に一致する必要があります。Vehicle のソースタグ、デスティネーション タグ、マトリックス タグは同じにできます。同様に、VisitRequest のソースタグと宛先タグが同じでもかまいません。タグはすべて異なっている必要があり、空の文字列にすることはできません。このフィールドが空でない場合、duration_distance_matrices を空にすることはできません。

TransitionAttributes

モデルに追加された遷移属性。

ShipmentTypeIncompatibility

互換性のない shipping_types のセット（ShipmentTypeIncompatibility を参照）。

ShipmentTypeRequirement

shipment_type の要件のセット（ShipmentTypeRequirement を参照）。

PrecedenceRule

モデルに適用する必要がある一連の優先順位ルール。

int32

アクティブな車両の最大数を制限します。ルートで少なくとも 1 回の配送が行われる車両はアクティブです。これは、ドライバーの数が車両より少ない場合や、車両フリートが混在している場合に、ルートの数を制限するために使用できます。最適化により、使用する最適な車両のサブセットが選択されます。真に正である必要があります。

Row

期間と距離の行列の行を指定します。ShipmentModel.duration_distance_matrix_src_tags と同じ数の要素が必要です。

string

この所要時間と距離行列を適用する車両を定義するタグ。空の場合、すべての車両に適用されます。マトリックスは 1 つだけです。

各車両の始動は、1 つの行列のみと一致する必要があります。つまり、車両の start_tags フィールドのいずれか 1 つが、ある行列の vehicle_start_tag と完全に一致する必要があります（その行列のみ）。

すべての行列は異なる vehicle_start_tag を持つ必要があります。

Duration

特定の行の Duration 値。ShipmentModel.duration_distance_matrix_dst_tags と同じ数の要素が必要です。

double

指定された行の距離値。モデル内の距離を参照するコストや制約がない場合は、空のままにしておくことができます。それ以外の場合は、durations と同数の要素が必要です。

bool

最初の Pod が配送イベントです。

bool

「秒」が配送イベントです。

Duration

「最初の」位置とと「second」イベントです。負の値も使用できます。

int32

「first」の配送指数イベントです。このフィールドを指定する必要があります。

int32

「2 個目」の配送指数イベントです。このフィールドを指定する必要があります。

int32

ルートを運行している車両。ソース ShipmentModel のインデックスで識別されます。

string

このルートを運行する車両のラベル。指定する場合は ShipmentModel.vehicles(vehicle_index).label になります。

Timestamp

車両がルートを開始した時刻。

Timestamp

車両がルートを終了した時刻。

Visit

経路を表す順序付きの訪問シーケンス。Visits[i] はルートの i 番目の訪問です。このフィールドが空の場合、車両は未使用とみなされます。

Transition

ルートの遷移の順序付きリスト。

bool

OptimizeToursRequest.consider_road_traffic が true に設定されている場合、このフィールドは、ルートのタイミングの不一致が交通量に基づく推定所要時間を使用して予測されることを示します。訪問と車両の時間枠を満たしながら、交通調整による移動、遅延、休憩を完了するための時間が十分でない場合があります。次に例を示します。

  start_time(previous_visit) + duration(previous_visit) +
  travel_duration(previous_visit, next_visit) > start_time(next_visit)

交通状況により推定移動時間 travel_duration(previous_visit, next_visit) が増加するため、next_visit に到着する時刻は現在の時間枠よりも遅くなる可能性があります。また、推定移動時間の増加や訪問または休憩の時間枠の制限により、訪問と重複することが強制的に発生することもあります。

EncodedPolyline

エンコードされた経路のポリライン表現。このフィールドは、OptimizeToursRequest.populate_polylines が true に設定されている場合にのみ入力されます。

Break

このルートを走行する車両の休憩。breaks シーケンスは時間間隔を表し、それぞれ対応する start_time から開始し、duration 秒間継続します。

AggregatedMetrics

このルートの期間、距離、負荷の指標。AggregatedMetrics のフィールドは、コンテキストに応じてすべての ShipmentRoute.transitions または ShipmentRoute.visits で合計されます。

map<string, double>

ルートのコスト。コスト関連のリクエスト フィールド別に分類されます。キーは、入力 OptimizeToursRequest に対する相対パスの proto パスです。次に例を示します。「model.shipments.pickups.cost」、値は対応する費用フィールドで生成された合計費用で、ルート全体で集計されます。つまり、cost["model.shipments.pickups.cost"] はルート上のすべての受け取り費用の合計となります。2022 年 1 月時点で集計された形でのみ報告される TransitionAttributes に関連する費用を除き、モデルで定義されたすべての費用は、ここで詳細に報告されます。

double

ルートの総費用。コストマップのすべての費用の合計。

Timestamp

休憩の開始時間。

Duration

休憩時間。

string

エンコードされたポリラインの地点を表す文字列。

Duration

この移行中の移動時間。

double

移行中の移動距離。

bool

OptimizeToursRequest.consider_road_traffic を介してトラフィックがリクエストされ、Transition の交通情報を取得できなかった場合、このブール値は true に設定されます。これは一時的（リアルタイム トラフィック サーバーでまれに発生する中断）の場合もあれば、永続的（この場所のデータがない）場合もあります。

Duration

この切り替えに適用される遅延時間の合計。設定されている場合は、次のイベント（訪問または車両の終了時間）のちょうど delay_duration 秒前に遅延が開始されます。TransitionAttributes.delayをご確認ください。

Duration

この遷移中に発生する中断の合計（ある場合）。各休憩の開始時間と継続時間に関する詳細は、ShipmentRoute.breaks に保存されます。

Duration

この移行中の待機時間。待機時間はアイドル時間に対応し、休憩時間は含まれません。また、この待ち時間は、連続していない複数の間隔に分割される場合があります。

Duration

移行の合計時間です（便宜上記載）。これは次と等しくなります。

• 次回の訪問 start_time（最後の移行の場合は vehicle_end_time）- この遷移の start_time
• ShipmentRoute.has_traffic_infeasibilities が false の場合、次の式も成り立ちます。`total_duration = travel_duration + delay_duration
• before_duration + wait_duration` です。

Timestamp

この移行の開始時間。

EncodedPolyline

遷移中にたどったルートのエンコードされたポリライン表現。このフィールドは、populate_transition_polylines が true に設定されている場合にのみ入力されます。

map<string, VehicleLoad>

この遷移中の車両の読み込み。この車両の Vehicle.load_limits に表示されるタイプごと、またはこのルートで実行された一部の配送で 0 以外の Shipment.load_demands がある各タイプについて。

最初の遷移中の負荷は、車両経路の開始負荷です。各訪問の後に、訪問が集荷か配達かに応じて、訪問の load_demands が加算または減算され、次の遷移の負荷が算出されます。

int64

指定されたタイプにおける車両の積荷量。負荷の単位は通常、タイプで示されます。Transition.vehicle_loads をご覧ください。

int32

ソース ShipmentModel の shipments フィールドのインデックス。

bool

true の場合、訪問は Shipment の乗車に対応します。それ以外の場合は配信に対応します。

int32

Shipment の「受け取り」または「配送」フィールドの VisitRequest のインデックス（is_pickup を参照）。

Timestamp

訪問の開始時刻。車両がこれよりも早く訪問場所に到着する場合があるので注意してください。時刻は ShipmentModel と一致します。

map<string, Load>

来店負荷の総需要。配送と訪問リクエスト load_demands の合計です。訪問が配送の場合、値は負になります。需要は Transition.loads と同じタイプでレポートされます（このフィールドを参照）。

Duration

訪問前にルート上で訪問した荷物や時間帯によって生じる可能性のある待ち時間が原因で、余分に迂回される時間。訪問が配達の場合、迂回運転は対応する集荷訪問から計算され、次のようになります。

start_time(delivery) - start_time(pickup)
- (duration(pickup) + travel duration from the pickup location
to the delivery location).

それ以外の場合は、車両 start_location から計算されます。

start_time - vehicle_start_time - travel duration from
the vehicle's `start_location` to the visit.

string

対応する Shipment.label のコピー（Shipment で指定されている場合）。

string

対応する VisitRequest.label のコピー（VisitRequest で指定されている場合）。

string

互換性のないタイプのリスト。shipment_types が異なる 2 つの配送は「互換性なし」です。

IncompatibilityMode

非互換性に適用されるモード。

string

dependent_shipment_types で必須とされる代替配送タイプのリスト。

string

タイプが dependent_shipment_types の配送はすべて、同じルート上で訪問できるタイプ required_shipment_type_alternatives の配送が少なくとも 1 つ必要です。

注: shipment_type がそれ自体に依存するような要件の連鎖は許可されません。

RequirementMode

要件に適用されるモード。

int32

このインデックスは、ソース ShipmentModel の配送のインデックスに対応しています。

string

対応する Shipment.label のコピー（Shipment で指定されている場合）。

Reason

配送がスキップされた理由の説明。Reason の上のコメントをご覧ください。

Code

コードのコメントを参照してください。

string

理由コードが DEMAND_EXCEEDS_VEHICLE_CAPACITY の場合、超過した容量タイプを 1 つ文書化します。

int32

理由が出荷車両の非互換性に関連している場合、このフィールドには関連する 1 台の車両のインデックスが含まれます。

Timestamp

ハードタイム ウィンドウの開始時間。指定しない場合は、ShipmentModel.global_start_time に設定されます。

Timestamp

ハードタイム ウィンドウの終了時刻。指定しない場合は、ShipmentModel.global_end_time に設定されます。

Timestamp

時間枠のソフト スタート時間。

Timestamp

時間枠のソフト終了時刻。

double

soft_start_time より前にイベントが発生した場合に、モデルの他の費用に追加される 1 時間あたりの費用。次のように計算されます。

   max(0, soft_start_time - t.seconds)
                          * cost_per_hour_before_soft_start_time / 3600,
t being the time of the event.

このコストは正の値である必要があります。このフィールドは、soft_start_time が設定されている場合のみ設定できます。

double

soft_end_time の後にイベントが発生した場合にモデルの他の費用に追加される 1 時間あたりの費用。次のように計算されます。

   max(0, t.seconds - soft_end_time.seconds)
                    * cost_per_hour_after_soft_end_time / 3600,
t being the time of the event.

この費用は正数でなければならず、このフィールドは soft_end_time が設定されている場合にのみ設定できます。

string

これらの属性が適用される遷移（src->dst）を定義するタグ。

参照元の訪問または車両の開始は、VisitRequest.tags または Vehicle.start_tags に src_tag が含まれているか、excluded_src_tag を含まない（この 2 つのフィールドが空でないかどうかによって）一致します。

string

src_tag をご覧ください。src_tag と excluded_src_tag のいずれか 1 つのみを空にすることはできません。

string

目的地の訪問または車両の終了は、VisitRequest.tags または Vehicle.end_tags に dst_tag が含まれているか、excluded_dst_tag が含まれていない場合（これら 2 つのフィールドの空でない内容に応じて）一致します。

string

dst_tag をご覧ください。dst_tag と excluded_dst_tag のいずれか 1 つのみを空にすることはできません。

double

この移行の実行にかかる費用を指定します。これは、モデルの他のすべての費用と同じ単位であり、負の値にすることはできません。これは、その他すべての既存の費用に上乗せして適用されます。

double

この移行を実施する際の移動距離に適用される 1 キロメートルあたりの費用を指定します。車両で指定された Vehicle.cost_per_kilometer まで追加できます。

DistanceLimit

この遷移中の移動距離の上限を指定します。

2021 年 6 月現在、ソフトリミットのみがサポートされています。

Duration

この移行の際に発生する遅延を指定します。

この遅延は常に、参照元の訪問が終了してから、訪問先の訪問を開始する前に発生します。

string

ユーザー定義の車両の表示名。長さは 63 文字以下で、UTF-8 文字を使用できます。

TravelMode

車両が通過できる道路とその速度に影響を与える交通手段。travel_duration_multiple もご覧ください。

LatLng

車両が荷物を受け取る前に出発する地理的位置。指定しない場合、車両は最初の乗車から出発します。配送モデルに期間行列と距離行列がある場合、start_location は指定できません。

Waypoint

車両が荷物を受け取る前に出発する地理的位置を表す地点。start_waypoint と start_location のどちらも指定されていない場合、車両は最初の乗車から出発します。配送モデルに期間行列と距離行列がある場合、start_waypoint は指定できません。

LatLng

最後の VisitRequest に到達した後に車両が終了する地理的な位置。指定しない場合、車両の ShipmentRoute は最後の VisitRequest が完了するとすぐに終了します。配送モデルに期間行列と距離行列がある場合、end_location は指定できません。

Waypoint

最後の VisitRequest の完了後に車両が終了する地理的位置を表す地点。end_waypoint と end_location のどちらも指定されていない場合、車両の ShipmentRoute は最後の VisitRequest が完了するとすぐに終了します。配送モデルに期間行列と距離行列がある場合、end_waypoint は指定できません。

string

車両のルートの始点に付けられているタグを指定します。

空の文字列や重複する文字列は使用できません。

string

車両のルートの終点に付けられたタグを指定します。

空の文字列や重複する文字列は使用できません。

TimeWindow

車両が出発地を出発する時間枠。グローバル制限時間内である必要があります（ShipmentModel.global_* フィールドを参照）。指定しない場合、グローバルな時間制限以外の制限はありません。

同じ繰り返しフィールドに属する時間ウィンドウは互いに重複してはいけません。つまり、別の時間ウィンドウと重複したり隣接したりすることはできず、時系列順である必要があります。

cost_per_hour_after_soft_end_time と soft_end_time は、時間枠が 1 つの場合にのみ設定できます。

TimeWindow

車両が目的地に到着する可能性のある時間枠。グローバル制限時間内である必要があります（ShipmentModel.global_* フィールドを参照）。指定しない場合、グローバルな時間制限以外の制限はありません。

同じ繰り返しフィールドに属する時間ウィンドウは互いに重複してはいけません。つまり、別の時間ウィンドウと重複したり隣接したりすることはできず、時系列順である必要があります。

cost_per_hour_after_soft_end_time と soft_end_time は、時間枠が 1 つの場合にのみ設定できます。

UnloadingPolicy

車両に適用されているアンロード ポリシー。

map<string, LoadLimit>

車両の積載量（重量、体積、パレット数など）。マップ内のキーは、読み込みタイプの識別子であり、Shipment.load_demands フィールドのキーと一致します。指定されたキーがこのマップにない場合、対応する容量は無制限とみなされます。

double

車両費用: すべての費用を加算します。Shipment.penalty_cost と同じ単位で指定する必要があります。

車両ルートの 1 時間あたりの費用。この費用は、ルートの合計所要時間に適用され、移動時間、待ち時間、訪問時間が含まれます。cost_per_traveled_hour だけでなく cost_per_hour を使用すると、レイテンシが増加する可能性があります。

double

車両ルートの移動時間あたりの費用。この費用は、ルートの移動時間（ShipmentRoute.transitions でレポートされたもの）にのみ適用され、待ち時間と訪問時間は含みません。

double

車両ルートの 1 キロメートルあたりの費用。この費用は、ShipmentRoute.transitions でレポートされる距離に適用され、単一の VisitRequest の arrival_location から departure_location まで暗黙的に移動する距離には適用されません。

double

配送処理にこの車両を使用する場合は固定費用が適用されます。

bool

このフィールドは、ルートで荷物を配送しない車両にのみ適用されます。この場合、車両を中古とみなすべきかどうかを指定します。

true の場合、車両は配送を行っていない場合でも始点から終点に至り、始発によって生じる時間と距離の費用 -->考慮する必要があります

それ以外の場合、始点から終点までの移動は行われず、この車両には break_rule や遅延（TransitionAttributes から）はスケジュールされません。この場合、車両の ShipmentRoute には車両のインデックスとラベル以外の情報は含まれません。

DurationLimit

車両のルートの合計時間に適用される制限。ある OptimizeToursResponse における車両のルート時間は、vehicle_end_time と vehicle_start_time の差です。

DurationLimit

車両のルートの移動時間に適用される制限。ある OptimizeToursResponse におけるルートの移動時間は、すべての transitions.travel_duration の合計となります。

DistanceLimit

車両のルートの合計距離に適用される制限。ある特定の OptimizeToursResponse におけるルート距離は、すべての transitions.travel_distance_meters の合計です。

map<string, Duration>

Visit_types 文字列から期間へのマップを指定します。この期間は、VisitRequest.duration に加えて、指定された visit_types での訪問で受験する時間です。cost_per_hour が指定されている場合は、滞在時間が長くなります。キー（例: visit_types）を空の文字列にすることはできません。

訪問リクエストに複数のタイプがある場合は、マップの各タイプに所要時間が追加されます。

BreakRule

この車両に適用する休憩スケジュールを記述します。空の場合、この車両の休憩はスケジュールされません。

string

この車両のラベルを指定します。このラベルは、対応する ShipmentRoute の vehicle_label としてレスポンスで報告されます。

bool

true の場合、used_if_route_is_empty は false である必要があり、この車両は使用されません。

injected_first_solution_routes で無視された車両によって配送が行われた場合、最初のソリューションではスキップされますが、レスポンスでは自由に行うことができます。

injected_solution_constraint で無視された車両によって配送が行われ、関連する集荷/配達が車両にとどまるよう制限されている場合（レベル RELAX_ALL_AFTER_THRESHOLD に緩和されていない場合）は、レスポンスでスキップされます。配送の allowed_vehicle_indices フィールドが空でなく、許可された車両がすべて無視された場合は、レスポンスでスキップされます。

double

この車両の移動時間を増減するために使用できる乗法係数を指定します。たとえば、この値を 2.0 に設定すると、この車両は速度が遅く、標準車両の 2 倍の移動時間になります。この指標は滞在時間には影響しません。cost_per_hour または cost_per_traveled_hour が指定されている場合は、費用に影響します。[0.001, 1000.0] の範囲内で指定する必要があります。未設定の場合、車両は標準であり、この倍数は 1.0 とみなされます。

警告: 移動時間は、この乗数を適用した後、数値演算を実行する前に最も近い秒単位に丸められます。そのため、乗数の値が小さいと精度が低下する可能性があります。

以下の extra_visit_duration_for_visit_type もご覧ください。

Duration

期間を max_duration 以下に制限するハードリミット。

Duration

ソフトリミットは最大時間制限を適用しませんが、違反するとルートにコストが発生します。このコストは、モデルで定義されている同じ単位での他のコストに加算されます。

定義する場合、soft_max_duration には負でない値を指定する必要があります。max_duration も定義されている場合、soft_max_duration は max_duration より小さくする必要があります。

Duration

ソフトリミットは、最大時間制限を適用しませんが、違反すると、ルートに費用が発生します。このコストは、モデルで定義されている同じ単位での他のコストに加算されます。

定義する場合、quadratic_soft_max_duration には負でない値を指定する必要があります。max_duration も定義されている場合、quadratic_soft_max_duration は max_duration より小さく、差は 1 日を超えないようにする必要があります。

max_duration - quadratic_soft_max_duration <= 86400 seconds

double

soft_max_duration しきい値違反があった場合に発生する 1 時間あたりの費用。期間がしきい値を下回ると、追加費用は 0 になります。しきい値を下回っている場合は、費用は次のように期間によって異なります。

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

費用は負でない値にしてください。

double

quadratic_soft_max_duration のしきい値違反があった場合に発生する 1 平方時間あたりの費用。

期間がしきい値を下回ると、追加費用は 0 になります。しきい値を下回っている場合は、費用は次のように期間によって異なります。

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

費用は負でない値にしてください。

int64

負荷のソフトリミット。cost_per_unit_above_soft_max をご覧ください。

double

この車両のルートの負荷が soft_max_load を超えると、（負荷 - soft_max_load）× cost_per_unit_above_soft_max のペナルティが適用されます（車両 1 台につき 1 回のみ）。すべての費用を合計し、Shipment.penalty_cost と同じ単位にする必要があります。

Interval

ルートの始点における車両の許容積荷区間。

Interval

ルートの終点における車両の許容積載区間。

int64

負荷の最大許容量。

int64

最小許容負荷。0 以上にする必要があります。両方を指定する場合は、min を max 以下にする必要があります。

int64

最大許容負荷。0 以上にする必要があります。指定しない場合、このメッセージによる最大負荷の制限はありません。両方を指定する場合は、min を max 以下にする必要があります。

bool

省略可。車両が道路の特定の側に停車することを優先して、このウェイポイントの位置を指定します。この値を設定すると、ルートは位置を通過するため、車両は、位置が道路の中心よりも偏っている道路脇で停止できるようになります。「WALKING」ではこのオプションは使用できません。選択します

Location

地理座標を使用して指定された地点。オプションで見出しも含む。

string

ウェイポイントに関連付けられているスポットのプレイス ID。