リクエスト メッセージを作成する

欧州経済領域（EEA）のデベロッパー

ルート最適化の概要で簡単に説明したように、基本的なリクエストは、必要なエンティティとして モデル、配送、車両で構成されます。

  • モデルは、Shipments と Vehicles の両方を含む、リクエスト全体の制約と設定をキャプチャします。
  • Shipments は、集荷と配送の 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 つの方法の違いを理解しておくことが重要です。

OptimizeTours と BatchOptimizeTours の比較