計算過路費

歐洲經濟區 (EEA) 開發人員

計算路線或路線矩陣時，您可能需要考量路線上的任何通行費。在特定城市，你可以用適當幣別計算路線的預估通行費。

如需支援的收費站位置清單，請參閱 TollPass 的參考資料。

如何計算過路費

Routes API 會考量駕駛人或車輛可用的過路費折扣或通行證，以及最方便的付款方式，計算預估過路費。如果特定路線沒有可用的過路費，Routes API 會指出有過路費，但費用不明。

如要取得準確的預估通行費，請務必在要求中提供下列資訊：

  • 路線使用的車輛排放類型 (VehicleEmissionType)。如果未提供排放類型，系統會傳回汽油車的通行費。
  • 車輛和駕駛人擁有的所有收費路段通行證，使用 tollPasses。 API 會使用收費路段通行證判斷準確的通行費，並在要求中的通行證不適用於路線時，傳回現金價格。
  • 視需要指定避開收費路段。如要盡可能避開收費道路，請將 avoidTolls 新增為 RouteModifier。

使用電子收費卡計算通行費

如要使用收費站通行證計算通行費，請在要求中指定任何收費站通行證。API 隨後會傳回票證價格。

  • 如果指定無效的電子收費證，系統會忽略該證件。
  • 如果以陣列形式指定多個收費證，API 會嘗試計算每個收費證的路線價格。

各區域的收費單據行為可能有所不同。

  • 使用道路通行證可享較低費率：在部分地區，有道路通行證的駕駛人或車輛，支付的道路通行費與沒有通行證者不同。舉例來說，如果你的 Good To Go! 在美國華盛頓州西雅圖使用收費路段時，如果沒有通行證，通行費會比有通行證時高。
  • 部分道路可能需要通行證：在印尼等地區，部分道路需要通行證。如果路線需要收費證，但您未指定收費證，API 就不會傳回通行費價格。

計算路線的通行費

如要計算路線的通行費，請按照下列步驟操作：

  • 將 extraComputations 屬性設為 TOLLS。
  • 使用 routeModifiers 屬性指定車輛類型和收費路段通行證類型。
  • 如要計算整條路線的通行費，請在要求的 fields 屬性中要求 travelAdvisory；如要查看整條路線的通行費資訊，請讀取 route.travelAdvisory.tollInfo。
  • 如要計算路線各路段的通行費，請在要求的 fields 屬性中要求 legs；如要查看各路段的通行費資訊，請讀取 route.legs[i].travelAdvisory.tollInfo。

範例

以下範例要求說明如何要求路線的通行費：

const requestWithTolls = {
  origin: 'Kirkland, WA',
  destination: 'University of Washington',
  travelMode: 'DRIVING',
  extraComputations: ['TOLLS'],
  routeModifiers: {
    vehicleInfo: {
      emissionType: 'GASOLINE',
    },
    tollPasses: ['US_WA_GOOD_TO_GO'],
  },
  fields: ['path', 'legs', 'distanceMeters', 'durationMillis', 'travelAdvisory'],
};