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

車両のグループを 1 つ以上指定し、制約を緩和するタイミングと緩和度を指定します。このフィールドが空の場合、空ではないすべての車両ルートが完全に制約されます。

Relaxation

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

int32

訪問制約 relaxations が適用される車両インデックスを指定します。空の場合はデフォルトとして扱われ、relaxations は他の constraint_relaxations で指定されていないすべての車両に適用されます。デフォルトは 1 つまで指定できます。つまり、制約緩和フィールドを空にできるのは 1 つまでです。vehicle_indices車両インデックスは、複数の 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

これが設定されている場合、リクエストに最大 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

返される検証エラーの数を切り捨てます。通常、これらのエラーは、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 を基準としたプロトパスです（例: model.shipments.pickups.cost）。値は、対応する費用フィールドによって生成された合計費用で、ソリューション全体で集計されます。つまり、costs["model.shipments.pickups.cost"] は、ソリューション全体の集荷費用の合計です。モデルで定義されているすべての費用が、ここで詳細にレポートされます。ただし、TransitionAttributes に関連する費用は、2022 年 1 月時点では集計された形でのみレポートされます。

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 で対応しています（code が「UNSPECIFIED」以外の場合）。

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

string

フィールドの値を含めることができます。これは常に利用できるとは限りません。絶対に頼らず、モデルの手動デバッグにのみ使用してください。

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 ターンを回避するかどうかを指定します。右折 / 左折の回避はベスト エフォートであり、完全に回避できる保証はありません。これは試験運用中の機能であり、動作は変更される可能性があります。

試験運用版: 詳しくは、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 つです。
• 1 台の車両が locA から locB までルートを走行し、マトリックス「fast」を使用します。
• 1 台の車両が locB でルートを開始し、locB で終了し、マトリックス「slow」を使用している。
• 1 台の車両が locB から出発し、locB で終点となる。行路は「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 は、このフィールド内のタグと完全に一致している必要があります。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 は、このフィールド内のタグと完全に一致している必要があります。Vehicle のソースタグ、宛先タグ、マトリックス タグは同じになる場合があります。同様に、VisitRequest のソースタグと宛先タグも同じになる場合があります。タグはすべて異なっている必要があり、空の文字列にすることはできません。このフィールドが空でない場合、duration_distance_matrices は空にできません。

TransitionAttributes

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

ShipmentTypeIncompatibility

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

ShipmentTypeRequirement

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

PrecedenceRule

モデルで適用する必要がある優先ルールのセット。

重要: 優先ルールを使用すると、最適化できる問題のサイズが制限されます。優先ルールを使用して多くの配送を含むリクエストは拒否される場合があります。

int32

アクティブな車両の最大数を制限します。車両は、ルートで 1 件以上の配送を実行するとアクティブになります。これは、運転手の数よりも車両の数が少なかったり、車両のフリートが異種である場合に、ルートの数を制限するために使用できます。最適化によって、使用する最適な車両のサブセットが選択されます。真に正である必要があります。

Row

所要時間と距離のマトリックスの行を指定します。ShipmentModel.duration_distance_matrix_src_tags と同じ数の要素が必要です。

string

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

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

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

Duration

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

double

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

Type

目標のタイプ。

double

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

bool

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

bool

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

Duration

「first」イベントと「second」イベントの間のオフセット。負の値にすることもできます。

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 を基準としたプロトパスです（例: model.shipments.pickups.cost）。値は、対応する費用フィールドによって生成された合計費用で、ルート全体で集計されます。つまり、costs["model.shipments.pickups.cost"] は、ルート全体の集荷費用の合計です。モデルで定義されているすべての費用が、ここで詳細にレポートされます。ただし、TransitionAttributes に関連する費用は、2022 年 1 月時点では集計された形でのみレポートされます。

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 の pickup フィールドまたは delivery フィールドの 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 で指定されている場合）。

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.label のコピー（Shipment で指定されている場合）。

Reason

配送がスキップされた理由を説明する理由のリスト。Reason の上のコメントをご覧ください。配送がスキップされた理由がわからない場合は、理由は設定されません。

double

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

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

double

以下のいずれかの理由により、この配送を実施できない車両の推定割合。注: 車両に関連する理由がある場合にのみ入力します。

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

Code

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

int32

example_vehicle_index と同じですが、複数の車両が検出された場合はそのリストが提供されます。このリストはすべてを網羅しているわけではありません。これは、[fill_example_vehicle_indices_in_skipped_reasons][] が true の場合にのみ入力されます。

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

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

リソースの 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

車両ルートの走行 1 時間あたりの費用。この費用は、ルートでの所要時間（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 回のみ）次の費用ペナルティが適用されます（load - soft_max_load）* cost_per_unit_above_soft_max。すべての費用を合計し、Shipment.penalty_cost と同じ単位にする必要があります。

Interval

ルートの開始時点での車両の許容積載間隔。

Interval

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

int64

許容される最大負荷量。

LoadCost

この車両で 1 キロメートル移動する 1 単位の荷物の費用。これは燃料消費量の代用として使用できます。荷重が重量（ニュートン）の場合、荷重*キロメートルはエネルギーの次元になります。

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

LoadCost

この車両で 1 時間あたりの荷物単位の走行費用。

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

int64

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

int64

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

int64

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

double

0 ～しきい値の各ユニットの負荷移動費用。有限値で、0 より大きい値にする必要があります。

double

しきい値を超える単位ごとに、1 単位の負荷を移動する費用。特殊なケースでしきい値が 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

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

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