通行料金情報を取得するには、パラメーターreturn
にtolls
を含めます。 この情報は、次の Trnsport Modeで利用できます。
ルートの各セクションには、該当する通行料金のリストが含まれています。料金には、名前、支払い方法、現地通貨での価格、必要に応じて希望の通貨で変換された価格が含まれます。 通行料金の粒度は、ルート全体(ビネットの場合)から個々の道路セグメント(キロメートルあたりの有料トラック料金の場合)までさまざまです。
通行料金のシステムによっては、支払い方法、車両の特性、通過時間、その他の要因によって通行料金の価格が異なる場合があります。 車両の特性は transportMode
vehicle[hovOccupancy]
、トラックプロファイルを使用して(ある程度)指定できます。また、トラックモードでは、トラックプロファイルを使用して指定できます。 ETA からの通過時間を計算する出発時間を指定します。 さまざまな通行料金システムが複雑なため、価格はベストエフォート方式で提供されます。
通行料金価格の通貨変換を要求するには、currency=USD
などの通貨の 3 文字のコードを入力します。
これは、通行時間および車両高さに基づいて請求されるトンネルを通過するルートの通行料金の USD 単位のリクエストです。
curl -X GET \
'https://router.hereapi.com/v8/routes?origin=51.307986,4.327722&destination=51.282912,4.286618&return=tolls&transportMode=truck&vehicle[height]=310&departureTime=2021-01-01T21:00:00¤cy=USD&apikey={YOUR_API_KEY}'
{
"routes": [
{
"id": "395379a4-2db7-485e-ad10-911ffce911cf",
"sections": [
{
"id": "700c42a0-a981-4817-a250-74037c7699ba",
"type": "vehicle",
"departure": {
"time": "2021-01-01T21:00:00+01:00",
"place": {
"type": "place",
"location": {
"lat": 51.3079803,
"lng": 4.3277143
},
"originalLocation": {
"lat": 51.307986,
"lng": 4.3277219
}
}
},
"arrival": {
"time": "2021-01-01T21:06:15+01:00",
"place": {
"type": "place",
"location": {
"lat": 51.2828957,
"lng": 4.286669
},
"originalLocation": {
"lat": 51.2829119,
"lng": 4.2866179
}
}
},
"transport": {
"mode": "truck"
},
"tolls": [
{
"countryCode": "BEL",
"tollSystem": "LIEFKENSHOEKTUNNEL",
"fares": [
{
"id": "26051851-9c7f-4635-933f-bd3022c1743e",
"name": "LIEFKENSHOEKTUNNEL",
"price": {
"type": "value",
"currency": "EUR",
"value": 14.16
},
"convertedPrice": {
"type": "value",
"currency": "USD",
"value": 17.08
},
"reason": "toll",
"paymentMethods": [
"transponder"
]
},
{
"id": "7ee701ba-5967-4236-aa74-38deb0cc063c",
"name": "LIEFKENSHOEKTUNNEL",
"price": {
"type": "value",
"currency": "EUR",
"value": 19
},
"convertedPrice": {
"type": "value",
"currency": "USD",
"value": 22.91
},
"reason": "toll",
"paymentMethods": [
"cash"
]
},
{
"id": "266bfb58-9114-4254-a785-7b1941a6383d",
"name": "LIEFKENSHOEKTUNNEL",
"price": {
"type": "value",
"currency": "EUR",
"value": 17.6
},
"convertedPrice": {
"type": "value",
"currency": "USD",
"value": 21.23
},
"reason": "toll",
"paymentMethods": [
"bankCard",
"creditCard",
"travelCard"
]
}
]
}
]
}
]
}
]
}