ルートまたはルート マトリックスを計算する際は ルート上での通行料も考慮することをおすすめします。 一部の都市については、 適切な通貨でのルートの通行料金。
ルート マトリックスの通行料金を取得するには、ルート マトリックスの通行料金を計算するをご覧ください。
サポートされている有料道路の地域のリストについては、 TollPass。
通行料金の計算方法
Routes API は、推定通行料金を計算します。 通行料金の割引やパスも考慮に入れる 最も便利な支払い方法です 特定のルートで利用可能な通行料金がない場合は、Routes API は不明な料金の通行料金の存在を示します。
通行料金を正確に見積もるには、次の情報を含めてください リクエスト内:
- ルートで使用される車両の排出量タイプ(
VehicleEmissionType
)。排出量タイプが指定されていない場合、ガソリン車の通行料が返されます。 - 車両とドライバーが持っているすべての通行料パス(
TollPass
)。API は通行料パスを使用して正確な通行料を決定し、リクエスト内の通行料パスがルート固有のものでない場合は現金価格を返します。 - 必要に応じて有料道路を使わないようにします。可能であれば有料道路を避けるようにするには、
avoidTolls
をRouteModifier
として追加します。
通行料金パスを使用して通行料金を計算する
通行券を使って通行料金を計算するには、通行証を 表示されます。API はパスの料金を返します。
無効な通行料パスを指定した場合、そのパスは無視されます。
複数の通行券を配列として指定すると、API は 各パスのルートの料金を計算できます。
通行券の処理方法は地域によって異なります。
通行料金が通行料パスで割引になる場合がある: 地域によっては、通行料パスを持っているドライバーや車両は、パスを持っていないドライバーや車両とは異なる通行料を支払う場合があります。たとえば、 頑張りましたね! 米国ワシントン州シアトルの通行料は あります。
一部の道路では通行料パスが必要になる場合があります: インドネシアなど、一部の地域では通行料パスが必要な道路があります。交通機関の通行料金の 通行券が必要な経路では、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)オブジェクト。この たとえば、ルート全体および各区間の通行料金情報を 表示されます。
{ "routes": [ { "legs": [ { "travelAdvisory": { "tollInfo": { "estimatedPrice": [ { "currencyCode": "USD", "units": "4", "nanos": 400000000 } ] } } } ], "distanceMeters": 150338, "duration": "6650s", "travelAdvisory": { "tollInfo": { "estimatedPrice": [ { "currencyCode": "USD", "units": "4", "nanos": 400000000 } ] } } } ] }