Routes API は現在プレビュー版(一般提供前)です。一般提供前のプロダクトや機能では、サポートが制限されることがあります。また、一般提供前のプロダクトや機能の変更は、他の一般提供前のバージョンと互換性がない可能性があります。一般提供前のサービスには、Google Maps Platform サービス固有の規約が適用されます。詳細については、リリース ステージの説明をご覧ください。

通行料金を計算する

ルートまたはルート マトリックスを計算する際は、ルートの通行料金を考慮に入れることをおすすめします。一部の都市では、適切な通貨でルートの推定通行料金を計算できます。

下記の利用可能な有料道路のリストをご覧ください。

有料道路の計算方法

Routes API では、運転手や車両で利用可能な通行料金の割引やパス、最も便利な支払い方法を考慮して、推定の通行料金を計算します。特定のルートに利用可能な通行料金がない場合、Routes API は有料の通行料金が存在することを示します。

通行料金情報を正確に計算するため、Routes API では次のオプションを指定できます。

  • ルートに使用された車両の排出タイプ(VehicleEmissionType)。排出タイプを指定しない場合は、ガソリン燃料の車両の通行料金が返されます。
  • 該当する運転手や車両の通行料金(TollPass)。通行料金が指定されていない場合、API は現金価格を返します。
  • RouteModifier: avoidTolls(有料道路を使わない)

通行証を使用するときの通行料金の計算

一部の地域では、有料道路のドライバーや車両で、有料道路のドライバーや車両の通行料金とは別の料金が発生します。たとえば、米国ワシントン州シアトルで Good To Go! 定期券を所持している場合、パスを使わなかった場合よりも通行料金が安くなります。

インドネシアなどの地域では、有料道路を必要とする道路があります。有料道路が必須ではないルートでは、料金は表示されません。

リクエストの中で通行料金を指定した場合、API は通行料金を返そうとします。

  • 無効な通行料金を指定した場合、この通行は無視されます。

  • 複数の有料道路を配列として指定できます。API は、各パスのルートパス料金を計算します。

ルートの通行料金を計算する

次の例では、通行証を使用した場合に computeRoutes メソッドを使用して、通行料金と推定料金を返します。

リクエストの routeModifiers フィールドを使用して、車両の種類と通行証の種類を指定します。返される通行料金は、指定した車両の種類とパスで使用される料金に基づきます。複数のパスが指定されている場合、最も料金の安い価格が返されます。

有料道路の情報をリクエストする

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "routeModifiers":{
    "vehicleInfo":{
      "emissionType": "GASOLINE"
    },
    "tollPasses": [
      "US_MA_EZPASSMA",
      "US_WA_GOOD_TO_GO"
    ]
  }
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.travelAdvisory.tollInfo,routes.legs.travelAdvisory.tollInfo' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

通行料金情報を含むレスポンス

レスポンスには、TollInfo(REST)または TollInfo(gRPC)オブジェクトの通行料金に関する情報が含まれています。

通行情報を返すようにメソッドを構成するには、レスポンス フィールド マスクを使用します。ルート全体の情報を返すように routes.travelAdvisory.tollInfo フィールドを設定し、各区間の情報を返すように routes.legs.travelAdvisory.tollInfo を設定します。

{
  "routes": [
    {
      "legs": [
        {
          "travelAdvisory": {
            "tollInfo": {
              "estimatedPrice": [
                {
                  "currencyCode": "USD",
                  "units": "4",
                  "nanos": 400000000
                }
              ]
            }
          }
        }
      ],
      "distanceMeters": 150338,
      "duration": "6650s",
      "travelAdvisory": {
        "tollInfo": {
          "estimatedPrice": [
            {
              "currencyCode": "USD",
              "units": "4",
              "nanos": 400000000
            }
          ]
        }
      }
    }
  ]
}

ルート マトリックスの通行料金を計算する

次の例では、通行証を使用した場合に computeRouteMatrix メソッドを使用して、料金情報を含むルートの通行情報を返します。

リクエストの routeModifiers フィールドを使用して、車両の種類と通行証の種類を指定します。返される通行料金は、指定した車両の種類とパスで使用される料金に基づきます。複数のパスが指定されている場合、最も料金の安い価格が返されます。

有料ルート情報のリクエスト

curl -X POST -d '{
"origins": [
  {
    "waypoint": {
      "location": {
        "latLng": {
          "latitude":42.340173523716736,
          "longitude":-71.05997968330408
        }
      }
    },
    "routeModifiers": {
      "vehicleInfo":{
        "emissionType": "GASOLINE"
      },
      "tollPasses": [
        "US_MA_EZPASSMA",
        "US_WA_GOOD_TO_GO"
      ]
    }
  }
],
"destinations": [
  {
    "waypoint": {
      "location": {
        "latLng": {
          "latitude":42.075698891472804,
          "longitude": -72.59806562080408
        }
      }
    }
  }
],
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE"
}'
-H 'Content-Type: application/json'
-H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: originIndex,destinationIndex,travel_advisory.tollInfo,duration,distanceMeters,status' 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

ルート マトリックスの有料道路に関する情報の回答

レスポンスには、TollInfo(REST)または TollInfo(gRPC)オブジェクトの通行料金に関する情報が含まれています。

通行情報を返すようにメソッドを構成するには、レスポンス フィールド マスクを使用して、マスクの travelAdvisory.tollInfo フィールドを設定します。

[
  {
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {},
    "distanceMeters": 150338,
    "duration": "5382s",
    "travelAdvisory": {
      "tollInfo": {
        "estimatedPrice": [
          {
            "currencyCode": "USD",
            "units": "4",
            "nanos": 400000000
           }
        ]
      }
    }
  }
]

サポートされている有料道路

現在、通行情報は次の国や地域でご利用いただけます。

地域コード国 / 地域都道府県
AR アルゼンチン ブエノスアイレス
AU オーストラリア ブリスベン
AU オーストラリア シドニー
ブラジル ブラジル 全国
ID インドネシア 全国
IN インド 全国
MX メキシコ メキシコシティ
米国 米国 Alabama
米国 米国 アラスカ
米国 米国 カリフォルニア
米国 米国 Colorado
米国 米国 デラウェア
米国 米国 フロリダ
米国 米国 イリノイ
米国 米国 アイオワ
米国 米国 インディアナ
米国 米国 カンザス
米国 米国 ルイジアナ
米国 米国 メイン
米国 米国 メリーランド
米国 米国 マサチューセッツ
米国 米国 ミシガン
米国 米国 ミネソタ
米国 米国 ミズーリ
米国 米国 ニューハンプシャー
米国 米国 ニュージャージー
米国 米国 ニューヨーク
米国 米国 ノースカロライナ
米国 米国 オハイオ
米国 米国 ペンシルバニア
米国 米国 ロードアイランド
米国 米国 サウスカロライナ
米国 米国 テキサス
米国 米国 ユタ
米国 米国 バージニア
米国 米国 ワシントン
米国 米国 ウェストバージニア

この情報は、より多くの通話データが利用可能になったときに更新されます。