ルートまたはルート マトリックスを計算するときは、ルートの通行料金を考慮することをおすすめします。一部の都市では、ルートの通行料金の見積もりを適切な通貨で計算できます。
ルート マトリックスの通行料金を取得するには、ルート マトリックスの通行料金を計算するをご覧ください。
サポートされている有料の所在地の一覧については、TollPass のリファレンスをご覧ください。
通行料金の計算方法
Routes API は、運転手や車両が利用できる通行料金の割引やパス、最も便利な支払い方法を考慮して、推定通行料金を計算します。特定のルートで利用可能な通行料金がない場合、Routes API は料金不明の通行料金が存在することを示します。
通行料金の正確な見積もりを得るには、リクエストに次の情報を含めてください。
- ルートで使用される車両の排出量タイプ(
VehicleEmissionType
)。排出量タイプが指定されていない場合は、ガソリン燃料車両の通行料金が返されます。 TollPass
を使用して車両と運転手が持っているすべての通行証。API は通行証を使用して正確な通行料金を決定し、リクエスト内の通行券が経路の周辺ではない場合、現金価格を返します。- 必要に応じて有料道路の通行を避けるよう指定します。できるだけ有料道路を避けたい場合は、
avoidTolls
をRouteModifier
として追加します。
通行証を使って通行料金を計算する
通行証を使用して通行料金を計算するには、リクエストの一部として通行証を指定します。その後、API がパスの料金を返します。
無効な通行証を指定した場合、そのパスは無視されます。
複数の通行証を配列として指定すると、API は各パスの経路の料金を計算しようとします。
通行証の動作は地域によって異なります。
通行証があると料金が低くなる場合: 一部の地域では、通行証があれば、運転手や車両とそうでない場合とは異なる通行料金がかかります。たとえば、米国ワシントン州シアトルで Good To Go! 通行証を利用すると、通行料はパスがない場合よりも安くなります。
道路によっては通行証が必要な場合があります: インドネシアなど、一部の地域では、通行証が必要な道路があります。通行証が必要な経路に通行証が指定されていない場合、API は通行料金を返しません。
経路の通行料を計算する
次の例では、computeRoutes
メソッドを使用して、通行証使用時の料金と推定料金の情報を返します。この例では、次の操作を行います。
通行料金情報の計算を有効にするには、
extraComputations
配列フィールドをTOLLS
に設定します。リクエストの
routeModifiers
フィールドを使用して、車両タイプと通行証の種類を指定します。返される通行料金は、指定された車両タイプとパスで使用される料金に基づきます。複数のパスを指定すると、最も安価な料金が返されます。レスポンス フィールド マスクを使用して、レスポンスで通行料金情報を返すようにメソッドを構成します。この例では、リクエストのレスポンス フィールド マスクに次のプロパティが含まれています。
routes.travelAdvisory.tollInfo
フィールド: ルート全体の情報を返します。routes.legs.travelAdvisory.tollInfo
: 各区間の情報を返します。
通行料金情報のリクエスト
curl -X POST -d '{ "origin":{ "location":{ "latLng":{ "latitude":42.340173523716736, "longitude":-71.05997968330408 } } }, "destination":{ "location":{ "latLng":{ "latitude":42.075698891472804, "longitude": -72.59806562080408 } } }, "travelMode": "DRIVE", "extraComputations": ["TOLLS"], "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)オブジェクト内の Toll に関する情報が含まれます。この例では、経路全体と経路の各区間の通行料金情報を返します。
{ "routes": [ { "legs": [ { "travelAdvisory": { "tollInfo": { "estimatedPrice": [ { "currencyCode": "USD", "units": "4", "nanos": 400000000 } ] } } } ], "distanceMeters": 150338, "duration": "6650s", "travelAdvisory": { "tollInfo": { "estimatedPrice": [ { "currencyCode": "USD", "units": "4", "nanos": 400000000 } ] } } } ] }