費用模式

成本屬性定義於 ShipmentModel.shipments.Shipment 和 ShipmentModel.vehicles.Vehicle

Route Optimization API 的主要目標是找出成本最低的路線。因此，成本模型是路線最佳化的主要驅動因素。

成本模型是一組屬性，用於指定全域、車輛和運送成本。

成本模型屬性支援下列最佳化目標：

  • 有效率地指派車輛和規劃路線
  • 符合成本效益的取貨和運送時間
  • 優先處理重要貨件

結構

如圖所示，成本模型屬性的結構如下：

本文僅著重介紹重要的成本模型參數。如需完整的成本參數組合，請參閱參考文件。

基本檢查清單

下列檢查清單說明基本知識，可避免潛在的費用相關錯誤。這份清單可協助您驗證要求，並排解回應問題。

屬性

下表列出並說明成本模型屬性。

父項 屬性名稱 物業類型 單次 房源說明
Shipment penaltyCost 數字 略過出貨 略過出貨產生的費用。
如果完成運送的費用超過罰款費用，API 會略過運送。
  • 設定 penaltyCost 會優先顯示費用較高的運送方式。
  • 如未設定運送 penaltyCost，則運送為必填。
  • 如果明確將運送 penaltyCost 設為零，除非其他限制要求，否則 API 一律會略過運送。
Vehicle fixedCost 數字 運送地址 使用這輛車輛處理運送作業時，會套用固定費用。
costPerHour 數字 小時 每小時車輛營運成本，包括運輸、等待、造訪和休息時間。
隨著這項成本增加，最佳化工具會嘗試找出更快的路線，但不一定是最短的路線。
這項屬性簡單完整，可有效做為獨立的單車費用。
costPerKilometer 數字 公里 車輛每行駛一公里的費用，可代表燃料費用或攤銷的車輛維護費用。
costPerTraveledHour 數字 小時 車輛每小時的營運成本，僅限運輸期間，不含等待、拜訪和休息時間。這項設定會優先選擇較快的路線，而非較短的路線。

範例

本節涵蓋三種範例：

程式碼範例

下列程式碼範例顯示 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 美元。也就是說，要求中的成本模型屬性值如下：

屬性 值 情境
penaltyCost 10 代表顧客未在預定日期接回狗狗時，你向顧客收取的罰款。只要你未在預定日期接狗，顧客就能從服務總額中扣除 40 美元。
fixedCost 30 代表車貸每日費用，也就是每天 30 美元。
costPerKilometer 0.08 代表車輛每公里消耗的汽油量。車輛每公里需要 0.04 加侖的燃料，而你所在地區的燃料價格為每加侖 2 美元。
costPerHour 27 代表你支付給駕駛的車輛駕駛費用。你支付給司機的時薪為 27 美元。
costPerTraveledHour 2.5 代表在路上時，你每小時必須為狗狗支付的車輛空調費用。車輛靜止時，駕駛人可以打開後門並關閉空調。

根據成本參數，最佳化工具可能會做出使用者不易察覺，但可透過最佳化找到的折衷方案。

下圖為範例，最佳化工具可能會選擇綠色虛線，這條路線雖然較長，但速度較快，可避開紅色虛線的車流。

車輛有兩條可能路線，一條以綠色虛線表示，距離較長但沒有任何事故，另一條以紅色虛線表示，距離較短但中間有車禍。

在這個情境中，兩條路徑的費用平衡如下：

除了提供符合成本效益的路線，最佳化工具也會在回應屬性中，提供運送路線的總費用。

要求範例

以下範例顯示基本 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 訊息具有費用屬性，可說明完成路線時產生的費用：