費用モデル

費用プロパティは、ShipmentModel.shipments.Shipment と ShipmentModel.vehicles.Vehicle で定義されます。

Route Optimization API の主な目的は、最もコストの低いルートを見つけることです。そのため、費用モデルはルート最適化の主な要因となります。

コストモデルは、グローバル、車両、配送のコストを指定する一連のプロパティです。

コストモデルのプロパティは、次の種類の最適化目標をサポートしています。

  • 効率的な車両の割り当てとルート
  • 費用対効果の高い集荷と配達の時間
  • 重要な荷物の優先順位付け

構造

図に示すように、費用モデルのプロパティは次のように構成されています。

このドキュメントでは、重要なコストモデル パラメータのみを説明します。費用パラメータの完全なセットについては、リファレンス ドキュメントをご覧ください。

Essentials のチェックリスト

次のチェックリストでは、費用に関連する潜在的なミスを防ぐための重要な知識について説明します。このリストは、リクエストを検証し、レスポンスのトラブルシューティングを行う際に役立ちます。

プロパティ

次の表に、コストモデルのプロパティを示します。

親 プロパティ名 プロパティのタイプ 費用/ プロパティの説明
Shipment penaltyCost 数値 スキップされた配送 配送をスキップした場合に発生する費用。
API は、配送を完了する費用がペナルティ費用を上回る場合、その配送をスキップします。
  • penaltyCost を設定すると、コストの高い荷物の配送が優先されます。
  • 配送 penaltyCost を設定しないと、配送は必須になります。
  • 配送の penaltyCost を明示的にゼロに設定すると、他の制約で必要とされない限り、API は常に配送をスキップします。
Vehicle fixedCost 数値 配送 この車両が配送に使用される場合に適用される固定費用。
costPerHour 数値 時間 移動時間、待機時間、訪問時間、休憩時間を含む、車両の 1 時間あたりの運用費用。
この費用が増加すると、オプティマイザーは最短ルートではない可能性のある、より速いルートを見つけようとします。
このプロパティは、シンプルで完全であるため、車両 1 台あたりの費用として効果的なスタンドアロンの指標になります。
costPerKilometer 数値 km 車両の走行距離あたりの費用。燃料費や車両のメンテナンス費用の償却費を表すことができます。
costPerTraveledHour 数値 時間 移動中のみの車両の 1 時間あたりの運行費用（待機時間、訪問時間、休憩時間は除く）。これにより、短いルートよりも速いルートが優先されます。

例

このセクションでは、次の 3 種類の例について説明します。

コードサンプル

次のコードサンプルは、Shipment の費用モデル プロパティの構造を示しています。

{
  "model": {
    "shipments": [ ...
      {
        "penaltyCost": PENALTY_COST
      }
    ],
    "vehicles": [ ...
    ]
  }
}

次のコードサンプルは、Vehicle の費用モデル プロパティの構造を示しています。

{
  "model": {
    "shipments": [ ...
    ],
    "vehicles": [ ...
      {
        "fixedCost": FIXED_COST,
        "costPerKilometer": KILOMETER_COST,
        "costPerHour": HOUR_COST,
        "costPerTraveledHour": TRAVELED_HOUR_COST
      }
    ]
  }
}

シナリオ例

このセクションでは、犬のデイケア ビジネスを経営しているシナリオについて説明します。あなたは、犬を自宅から引き取るために使用するトラックのルートを最適化しています。このシナリオでは、ルートを提供する際に、犬の引き取りと車両の運行に関連する費用をオプティマイザーに考慮させます。

この例では、1 費用単位は 1 ドルを表します。つまり、リクエストの費用モデルのプロパティ値は次のようになります。

プロパティ 値 シナリオ
penaltyCost 10 予定日に犬を引き取りに来なかったお客様に課すペナルティを表します。予定日に犬を迎えに行かなかった場合、お客様はサービス合計額から 40 ドルの割引を受けます。
fixedCost 30 自動車ローンの 1 日あたりの支払い額（30 ドル）を表します。
costPerKilometer 0.08 車両が 1 km あたりに消費するガソリンの量を表します。車両の移動に必要な燃料は 1 km あたり 0.04 ガロンで、お住まいの地域の 1 ガロンあたりの費用は 2 ドルです。
costPerHour 27 車両の運転に対してドライバーに支払う金額を表します。運転手には 1 時間あたり 27 ドルを支払います。
costPerTraveledHour 2.5 移動中に犬のために車両のエアコンを使用する際に、1 時間あたりに支払う必要がある金額を表します。車両が動いていないときは、ドライバーは後部のドアを開けてエアコンをオフにすることができます。

費用パラメータに基づいて、オプティマイザーはユーザーには明らかではないトレードオフを行う可能性がありますが、最適化によって見つけることができます。

次の図は、オプティマイザーが赤色の点線のトラフィックを回避するために、緑色の破線を通る、より長いがより速いルートを選択する例を示しています。

車両には 2 つの経路が考えられます。1 つは緑色の破線で表される経路で、距離は長いですが事故は発生していません。もう 1 つは赤色の点線で表される経路で、距離は短いですが途中で自動車事故が発生しています。

このシナリオでは、2 つのルートの費用バランスは次のようになります。

最適化ツールは、費用対効果の高いルートを提供するだけでなく、レスポンス プロパティで配送ルートの合計費用の合計も提供します。

リクエストの例

次の例は、サンプル シナリオで設定された値を含む基本的な optimizeTours リクエストの構造を示しています。

{
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.8024,
              "longitude": -122.4058
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.759773,
              "longitude": -122.427063
            }
          }
        ]
        "penaltyCost": 40
      }
    ],
    "vehicles": [
      {
        "startLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "endLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "fixedCost": 30,
        "costPerKilometer": 0.08,
        "costPerHour": 27,
        "costPerTraveledHour": 2.5
      }
    ]
  }
}

レスポンスのプロパティ

OptimizeToursResponse メッセージには、ルートの完了プロセスで発生した費用を説明する費用プロパティがあります。

  • metrics.costs: 費用関連のリクエスト フィールド別に分類された、すべてのルートの合計費用。
  • metrics.totalCost: すべてのルートの合計費用。