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

int32

実施された必須の配送の数。

試験運用版: このフィールドの動作または存在は、今後変更される可能性があります。

double

実行された配送の Shipment.penalty_cost の合計。

試験運用版: このフィールドの動作または存在は、今後変更される可能性があります。

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

発生した 1 キロメーターあたりの費用。soft_max_meters まで増加します。計算式は次のとおりです。

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

この費用は route_distance_limit ではサポートされていません。

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 が適用される車両のインデックスを指定します。空の場合、これはデフォルトと見なされ、他の constraint_relaxations で指定されていないすべての車両に 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 つのルートでのみ参照できます。
• 集荷配送の荷物の集荷は、配送の前に行う必要があります。
• 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

該当する場合:

• 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（または 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

この設定を行うと、リクエストの期限（https://grpc.io/blog/deadlines を参照）を最大 60 分に設定できます。設定しない場合、最大期限は 30 分のみです。長時間実行されるリクエストは、中断のリスクが大幅に高くなります（ただし、リスクは依然として小さいです）。

bool

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

string

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

double

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

int32

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

ShipmentRoute

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

string

リクエストでラベルが指定された場合は、OptimizeToursRequest.label のコピー。

SkippedShipment

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

OptimizeToursValidationError

独自に検出できたすべての検証エラーのリスト。OptimizeToursValidationError メッセージについては、「複数のエラー」の説明をご覧ください。solving_mode が DEFAULT_SOLVE の場合、エラーではなく警告が含まれます。

OptimizeToursRequest

場合によっては、解決する前に受信リクエストを変更します（費用を追加するなど）。solving_mode == TRANSFORM_AND_RETURN_REQUEST の場合、変更されたリクエストがここで返されます。

試験運用版: 詳しくは、https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request をご覧ください。

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」）で、値は対応する費用フィールドによって生成された合計費用で、ソリューション全体で集計されます。つまり、costs["model.shipments.pickups.cost"] は、ソリューション全体のすべての店舗受取手数料の合計です。モデルで定義されたすべての費用がここに詳細にレポートされます。ただし、2022 年 1 月の時点では、TransitionAttributes に関連する費用は集計された形でしかレポートされません。

double

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

string

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

形式:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

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

Uri

必須。OptimizeToursRequest を含む Cloud Storage オブジェクトの URI。

Uri

必須。OptimizeToursResponse を含む Cloud Storage オブジェクトの URI。

Uri

省略可。JSON または textproto としてエンコードされた OptimizeToursResponse を含む Cloud Storage オブジェクトの URI。オブジェクトが JSON としてエンコードされている場合、オブジェクト名の拡張子は .json になります。オブジェクトが textproto としてエンコードされている場合、オブジェクト名の拡張子は .txtpb になります。

リソースの crc32_checksum を使用して、リソースの内容が変更されていないことを確認できます。

int32

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

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

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

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

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

フィールドの値を 1 つ以上含めることができます。この機能は常に利用できるとは限りません。この機能に依存することは絶対に避けてください。手動のモデル デバッグにのみ使用してください。

string

フィールド名（「vehicles」など）。

FieldReference

必要に応じて、再帰的にネストされたサブフィールド。

int32

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

string

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

DataFormat

必須。出力データ形式。

GcsDestination

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

bool

有料道路を避けるかどうかを指定します。有料道路を含まないルートが優先されます。電動の移動手段にのみ適用されます。

bool

可能な限り高速道路を避けるかどうかを指定します。高速道路を含まないルートが優先されます。自動車の移動手段にのみ適用されます。

bool

可能な限りフェリーを避けるかどうかを指定します。フェリーを利用しないルートが優先されます。自動車の移動手段にのみ適用されます。

bool

省略可。屋内ナビゲーションを可能な限り避けるかどうかを指定します。屋内ナビゲーションを含まないルートが優先されます。WALKING の移動手段にのみ適用されます。

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

集荷場所から配達場所までの最短経路と比較した、最大絶対迂回時間を指定します。指定する場合は、非負の値にする必要があります。また、配送には少なくとも集荷と配達が含まれている必要があります。

たとえば、選択した受け取り方法から選択した配送方法に直接移動するのにかかる最短時間を t とします。pickup_to_delivery_absolute_detour_limit を設定すると、次のことが強制されます。

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

同じ配送で相対制限と絶対制限の両方が指定されている場合、可能な各集荷 / 配達ペアに対して、より制約の厳しい制限が使用されます。2017 年 10 月の時点で、迂回は移動時間が車両に依存しない場合にのみサポートされています。

Duration

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

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

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

たとえば、選択した受け取り方法から選択した配送方法に直接移動するのにかかる最短時間を 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 年 10 月の時点で、迂回は移動時間が車両に依存しない場合にのみサポートされています。

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.load_demands フィールドと同じですが、Shipment 全体ではなく、この VisitRequest にのみ適用されます。ここに記載されているデマンドは、Shipment.load_demands に記載されているデマンドに追加されます。

string

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

型は 1 回しか指定できません。

string

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

bool

この場所の運転ルートで U ターンを避けるかどうかを指定します。U ターン回避はベスト エフォートであり、完全な回避は保証されません。これは試験運用中の機能であり、動作は変更される可能性があります。

試験運用版: 詳しくは、https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request をご覧ください。

Shipment

モデルで実行する必要がある配送のセット。

Vehicle

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

Objective

このモデルの目標のセット。費用に変換されます。空でない場合、入力モデルは費用なしである必要があります。変更されたリクエストを取得するには、solving_mode = TRANSFORM_AND_RETURN_REQUEST を使用してください。この場合、リクエストは解決されません。対応するドキュメントをご覧ください。

試験運用版: 詳しくは、https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request をご覧ください。

Timestamp

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

モデルの期間は 1 年未満にする必要があります。つまり、global_end_time と global_start_time の差は 31,536,000 秒以内にする必要があります。

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

Timestamp

未設定の場合、デフォルトとして 1971 年 1 月 1 日 00:00:00 UTC（秒: 31536000、ナノ秒: 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 つのロケーションがあります。
• locA でルートを開始し、locB で終了する 1 台の車両。マトリックス「fast」を使用します。
• locB でルートを開始し、locB で終了する 1 台の車両。マトリックス「slow」を使用。
• locB でルートを開始し、locB で終了する 1 台の車両。マトリックス「fast」を使用。
• 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

互換性のない shipment_type のセット（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

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

double

特定の行の距離の値。モデルで距離を参照する費用や制約がない場合は、空のままにできます。それ以外の場合は、durations と同じ数の要素が必要です。

Type

目標のタイプ。

double

この目標を他の目標と比較してどの程度重視するか。これは任意の正の数で、重みの合計が 1 になる必要はありません。重みのデフォルト値は 1.0 です。

bool

「最初」のイベントが配達かどうかを示します。

bool

「2 番目」のイベントが配信かどうかを示します。

Duration

「最初」のイベントと「2 番目」のイベントのオフセット。負の値になることもあります。

int32

「最初」のイベントの配送インデックス。このフィールドは指定する必要があります。

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 で合計されます。

VehicleFullness

上限付き指標がそれぞれの車両制限にどの程度近づいているかを計算するための VehicleFullness フィールド。このフィールドは、上限付きの指標フィールド（AggregatedMetrics.travel_distance_meters など）と関連する車両制限（Vehicle.route_distance_limit など）の比率です。

試験運用版: このフィールドの動作または存在は、今後変更される可能性があります。

map<string, double>

ルートの費用。費用関連のリクエスト フィールド別に分類されます。キーは、入力 OptimizeToursRequest に相対的な proto パス（例: 「model.shipments.pickups.cost」）で、値は対応する費用フィールドによって生成された合計費用で、ルート全体で集計されます。つまり、costs["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` も成り立ちます。
• break_duration + wait_duration` です。

Timestamp

この遷移の開始時間。

EncodedPolyline

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

string

出力専用。ナビゲーション中にルートを再構築し、ルートが作成されたときにリルートが発生した場合に元の意図を尊重するために Navigation SDK に渡すことができる不透明なトークン。このトークンは不透明な blob として扱います。サービスがまったく同じルートを返した場合でも、値が変更される可能性があるため、リクエスト間で値を比較しないでください。このフィールドは、populate_transition_polylines が true に設定されている場合にのみ入力されます。

map<string, VehicleLoad>

この移行中の車両の積載量。この車両の Vehicle.load_limits に表示されるか、このルートで実行された一部の配送で 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 で指定されている場合は、対応する Shipment.label のコピー。

string

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

VisitType

省略可。訪問のタイプを指定します。Visit.is_pickup フィールドをオーバーライドします。

int32

訪問場所に関する情報を表す不透明なトークン。

このフィールドは、この訪問で VisitRequest.avoid_u_turns が true に設定されている場合、またはリクエスト OptimizeToursRequest で ShipmentModel.avoid_u_turns が true に設定されている場合に、結果ルートの訪問で入力されることがあります。

試験運用版: 詳しくは、https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request をご覧ください。

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 で指定されている場合は、対応する Shipment.label のコピー。

Reason

配送がスキップされた理由を説明する理由のリスト。Reason の上のコメントを参照してください。配送がスキップされた理由を特定できない場合、理由は設定されません。

double

これは Shipment.penalty_cost のコピーです。スキップされた配送の重大度を簡単に確認できるようにするために、ここに含めました。

試験運用版: このフィールドの動作または存在は、今後変更される可能性があります。

double

次のいずれかの理由により、この配送を実行できない車両の推定比率。注: 理由は車両に関係する場合にのみ入力されます。

試験運用版: このフィールドの動作または存在は、今後変更される可能性があります。

Code

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

int32

example_vehicle_index と同じですが、識別された複数の車両のリストを提供します。このリストは必ずしも網羅的ではありません。これは、[fill_example_vehicle_indices_in_skipped_reasons][] が true の場合にのみ入力されます。

試験運用版: このフィールドの動作または存在は、今後変更される可能性があります。

string

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

int32

理由が配送車両の互換性に関連している場合、このフィールドには関連する車両のインデックスが指定されます。

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 が含まれていない場合（どちらのフィールドが空でないかによって異なります）、目的地訪問または車両の終了が一致します。

string

dst_tag をご覧ください。dst_tag と excluded_dst_tag のいずれか 1 つのみが空でない必要があります。

double

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

double

このトランジションの実行中に移動した距離に適用されるキロメートルあたりの費用を指定します。車両に指定された Vehicle.cost_per_kilometer に加算されます。

DistanceLimit

このトランジションの実行中に移動する距離の上限を指定します。

2021 年 6 月の時点で、ソフト上限のみがサポートされています。

Duration

このトランジションの実行時に発生する遅延を指定します。

この遅延は、常に参照元サイトへのアクセスが終了した後、参照先サイトへのアクセスが開始される前に発生します。

string

リソースの URI。リソースはまだ存在しない可能性があります。

リソースの内容は JSON または textproto としてエンコードされます。Google Cloud Storage リソースのみがサポートされています。リソースが JSON としてエンコードされている場合、リソース名の末尾に .json を付ける必要があります。リソースが textproto としてエンコードされている場合、リソース名の末尾に .txtpb を付ける必要があります。たとえば、JSON エンコード ファイルの Google Cloud Storage URI は gs://bucket/path/input/object.json のようになります。

string

車両のユーザー定義の表示名。最大 63 文字で、UTF-8 文字を使用できます。

TravelMode

車両が走行可能な道路とその速度に影響する移動モード。travel_duration_multiple もご覧ください。

RouteModifiers

指定された車両のルートの計算方法に影響する、満たすべき条件のセット。

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 文字列から期間へのマップを指定します。期間は、指定された visit_types での訪問時に VisitRequest.duration に加えてかかる時間です。この追加の訪問時間により、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

最大期間の制限を強制しないソフト制限。違反すると、期間の 2 乗に比例したコストがルートに発生します。このコストは、モデルで定義された他のコストと同じ単位で加算されます。

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 を超えた場合、次のコスト ペナルティが適用されます（車両ごとに 1 回のみ）。（負荷 - soft_max_load）* cost_per_unit_above_soft_max。すべてのコストが合計され、Shipment.penalty_cost と同じ単位でなければなりません。ソフト上限は、モデル全体で集荷のみまたは配達のみに適用されるタイプでのみ定義できます。

Interval

ルートの開始時の車両の許容可能な積載間隔。

Interval

ルートの終点における車両の許容可能な積載間隔。

int64

許容できる最大負荷量。

LoadCost

この車両で 1 単位の荷物を 1 km 運ぶための費用。これは燃料消費量の代理として使用できます。荷物が重量（ニュートン単位）の場合、荷物 × 距離はエネルギーの次元を持ちます。

試験運用版: 詳しくは、https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request をご覧ください。

LoadCost

この車両で 1 時間に 1 単位の荷物を運ぶ費用。

試験運用版: 詳しくは、https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request をご覧ください。

int64

許容できる最小負荷。0 以上である必要があります。両方が指定されている場合、min は max 以下である必要があります。

int64

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

int64

単位の荷物を移動する費用が cost_per_unit_below_threshold から cost_per_unit_above_threshold に変化する荷物の量。0 以上である必要があります。

double

0 ～しきい値の各単位について、1 単位の負荷を移動する費用。有限値で、0 以上である必要があります。

double

しきい値を超える各単位の負荷を移動する費用。しきい値が 0 の場合は、単位あたりの固定費用になります。有限値で、0 以上である必要があります。

double

このメッセージ内の他のすべてのフィールドの最大値。

double

AggregatedMetrics.travel_distance_meters と Vehicle.route_distance_limit の比率。Vehicle.route_distance_limit が設定されていない場合、このフィールドは設定されません。

double

[AggregatedMetrics.travel_duration_seconds][] と Vehicle.travel_duration_limit の比率。Vehicle.travel_duration_limit が設定されていない場合、このフィールドは設定されません。

double

[AggregatedMetrics.total_duration_seconds][] と Vehicle.route_duration_limit の比率。Vehicle.route_duration_limit が設定されていない場合、このフィールドは設定されません。

double

すべてのタイプの [AggregatedMetrics.max_load][] とそれぞれの Vehicle.load_limits の最大比率。すべての Vehicle.load_limits フィールドが設定されていない場合、このフィールドは設定されません。

double

特定の車両の比率（vehicle_end_time - vehicle_start_time）/（latest_vehicle_end_time - earliest_vehicle_start_time）。分母がない場合は、代わりに（ShipmentModel.global_end_time - ShipmentModel.global_start_time）を使用します。

bool

省略可。このウェイポイントの場所では、車両を優先的に道路の特定の側に停車することを指示します。この値を設定すると、ルートは場所を通過するため、車両は道路の中央から場所の方向に偏った道路の脇に停車できます。このオプションは、移動手段が「徒歩」の場合には機能しません。

bool

ウェイポイントが車両の停車地点であり、乗車または降車を目的としていることを示します。このオプションは、交通手段が「DRIVING」で、location_type が「location」の場合にのみ機能します。

試験運用版: このフィールドの動作または存在は、今後変更される可能性があります。

Location

地理座標を使用して指定されたポイント。オプションの方角を含む。

string

経由地に関連付けられた POI のプレイス ID。

プレイス ID を使用して VisitRequest の到着地または出発地を指定する場合は、その場所へのナビゲーションの LatLng 位置を特定するのに十分なプレイス ID を使用します。たとえば、建物を示すプレイス ID は適切ですが、道路を示すプレイス ID は推奨されません。