通行料金の計算

欧州経済領域（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'],
};