ルート最適化の概要で簡単に説明したように、基本的なリクエストは、必須エンティティとして モデル、配送、車両で構成されます。
- Model は、
ShipmentsとVehiclesの両方を含む、リクエスト全体の設定と制約をキャプチャします。 - 配送は、集荷と配達の
VisitRequestを含むタスクまたは実際の配送を表します。配送にはローカル設定と制約があります。 - 車両は、車両、運転手、または人員を表します。車両にはローカル設定と制約もあります。
各エンティティのプロパティは、特定の粒度レベルで最適化問題の一部を記述します。モデル全体の制約はすべての配送と車両に適用されますが、配送または車両で指定された制約とプロパティは、単一の配送または車両に固有のものです。
各メッセージ タイプの詳細なドキュメントについては、ShipmentModel（REST、gRPC）、Shipment（REST、gRPC）、Vehicle（REST、gRPC）メッセージのリファレンス ドキュメントをご覧ください。
OptimizeToursRequest 件の宿泊施設
最上位の OptimizeToursRequest メッセージ（REST、gRPC）でよく使用されるプロパティには、次のものがあります。
searchModeは、指定された制約を満たす最初のソリューションを返すか、設定された期限内に最適なソリューションを検索するかを指定します。considerRoadTrafficは、ルーティングと到着予定時刻の推定にライブ トラフィックを使用するかどうかを決定します。populateTransitionPolylinesは、ルート ポリラインとルート トークンがレスポンスで返されるかどうかを決定します。
モデル プロパティ
ShipmentModel メッセージ（REST、gRPC）でよく使用されるプロパティには次のようなものがあります。
globalStartTimeは、すべての車両と配送のルートの最小開始時間を表します。この時間より前に、車両の最初の移行と配送を開始することはできません。globalEndTimeは、すべての車両と配送のルートの最新の終了時間を表します。割り当てられたすべての配送と移行は、この時間までに完了する必要があります。
配送プロパティ
Shipment メッセージ（REST、gRPC）でよく使用されるプロパティには次のようなものがあります。
pickups[]とdeliveries[]は、荷物の集荷または配送場所を表します。pickups[]プロパティとdeliveries[]プロパティの両方でVisitRequestメッセージ（REST、gRPC）が使用されます。loadDemandsは、車両が配送を完了するために必要な積載量を表します。車両の対応するload_limits（REST、gRPC）プロパティは、車両が一度に収容できる負荷量を表します。負荷の詳細については、負荷の需要と上限をご覧ください。penalty_costは、配送がスキップされた場合に発生する費用を表します。費用の詳細については、費用モデル パラメータをご覧ください。
車両プロパティ
Vehicle メッセージ（REST、gRPC）でよく使用されるプロパティには次のようなものがあります。
startLocationは、車両がルートを開始する場所を表します。このプロパティは省略可能です。指定しない場合、車両のルートは、最初に割り当てられた配送の場所から開始されます。endLocationは、車両がルートを終了する場所を表します。このプロパティは省略可能です。指定しない場合、車両のルートは最後に割り当てられた荷物の場所で終了します。startTimeWindows[]は、車両がルートを開始できる時刻を表します。このプロパティは省略可能です。endTimeWindows[]は、車両がルートを開始および終了できる時刻を表します。どちらのプロパティも省略可能です。loadLimitsは、配送の荷物需要を満たすために使用できる車両の容量を表します。負荷需要と上限の詳細については、負荷需要と上限をご覧ください。
JSON 形式のリクエストの例を以下に示します。
{
"model": {
"shipments": [
{
"pickups": [
{
"arrivalLocation": {
"latitude": 37.73881799999999,
"longitude": -122.4161
}
}
],
"deliveries": [
{
"arrivalLocation": {
"latitude": 37.79581,
"longitude": -122.4218856
}
}
]
}
],
"vehicles": [
{
"startLocation": {
"latitude": 37.73881799999999,
"longitude": -122.4161
},
"endLocation": {
"latitude": 37.73881799999999,
"longitude": -122.4161
},
"costPerKilometer": 1.0
}
],
"globalStartTime": "2024-02-13T00:00:00.000Z",
"globalEndTime": "2024-02-14T06:00:00.000Z"
}
}
OptimizeTours と BatchOptimizeTours はどちらも、上記の例のようにリクエスト メッセージを消費しますが、方法が異なります。ルート最適化リクエストを行う前に、次の 2 つの方法の違いを理解しておくことが重要です。