複数区間のルートの通行料金を取得
複数区間のルートの通行料のリクエストです。休憩エリアでの有料高速道路のストップオーバーが含まれています。出発時間は関係ありません。 ドライバーが、ストップオーバー後の 2 番目のセクションのハイウェイ出口ブースで通行料金の支払いを行います。
curl -X GET \
'https://router.hereapi.com/v8/routes?origin=41.465218,1.912036&destination=41.447398,1.865010&via=41.455196,1.882819&return=tolls&transportMode=car&departureTime=any&apikey={YOUR_API_KEY}'
{
"routes": [
{
"id": "bc63ecb7-dd44-4c76-a9e4-baec8629a5d1",
"sections": [
{
"id": "319cad34-5e89-4723-90fe-5b0e50c45f43",
"type": "vehicle",
"departure": {
"place": {
"type": "place",
"location": {
"lat": 41.4651747,
"lng": 1.9120686
},
"originalLocation": {
"lat": 41.465218,
"lng": 1.912036
}
}
},
"arrival": {
"place": {
"type": "place",
"location": {
"lat": 41.4551983,
"lng": 1.8828158
},
"originalLocation": {
"lat": 41.4551959,
"lng": 1.8828189
},
"waypoint": 0
}
},
"transport": {
"mode": "car"
}
},
{
"id": "0ff92e1b-3bda-4dae-bc5c-7af672f22fbb",
"type": "vehicle",
"departure": {
"place": {
"type": "place",
"location": {
"lat": 41.4551983,
"lng": 1.8828158
},
"originalLocation": {
"lat": 41.4551959,
"lng": 1.8828189
},
"waypoint": 0
}
},
"arrival": {
"place": {
"type": "place",
"location": {
"lat": 41.4473975,
"lng": 1.8650177
},
"originalLocation": {
"lat": 41.447398,
"lng": 1.8650099
}
}
},
"transport": {
"mode": "car"
},
"tolls": [
{
"countryCode": "ESP",
"tollSystem": "AUTOPISTAS AP2-AP7",
"fares": [
{
"id": "48a15121-4d1d-4218-b5e1-7ba8d5ffb289",
"name": "AUTOPISTAS AP2-AP7",
"price": {
"type": "value",
"currency": "EUR",
"value": 2.5
},
"reason": "toll",
"paymentMethods": [
"cash",
"bankCard",
"creditCard",
"transponder",
"travelCard"
]
}
]
}
]
}
]
}
]
}
複数区間で支払いが有効な場合は、複数区間のルートの通行料金を取得
一部の通行料金には、支払いポイントが定義されていません。 たとえば、料金所のある路線では、トラックがルートを走行している間、デバイスは通行料金データを蓄積します。 この場合、通行料金の合計はトランスポンダによって計算されますが、通行料金 を割り当てることができる単一の支払いポイントはありません。 その結果、ルータは、適用されるトリップのすべてのセクションについて、この通行料金を返します。 つまり、同じ通行料金が複数のセクションに表示されますが、支払いは 1 回のみです。 このため、クライアントが fares
アレイ内のオブジェクトのid
フィールドに注意を払うことが重要です。 id
は 複数のセクションにまたがって繰り返すことができます。この場合、繰り返し使用する場合は、顧客側の合計通行料金のカウントには、複数回使用しないでください。
次の例を検討してください。
curl -X GET \
'https://router.hereapi.com/v8/routes?origin=51.672015,12.200617&destination=52.018234,12.560561&via=51.848882,12.330821&return=tolls&transportMode=truck&departureTime=any&apikey={YOUR_API_KEY}'
{
"routes":
[
{
"id": "c2a14795-5cad-415d-af2b-0c1d79b8e3ce",
"sections":
[
{
"id": "7a0a73ba-af30-42fb-ba19-77c67a24df91",
"type": "vehicle",
"departure":
{
"time": "2022-08-08T11:43:00+02:00",
"place":
{
"type": "place",
"location":
{
"lat": 51.6706573,
"lng": 12.1980494
},
"originalLocation":
{
"lat": 51.672015,
"lng": 12.200617
}
}
},
"arrival":
{
"time": "2022-08-08T12:11:15+02:00",
"place":
{
"type": "place",
"location":
{
"lat": 51.8489,
"lng": 12.33076
},
"originalLocation":
{
"lat": 51.848882,
"lng": 12.3308209
},
"waypoint": 0
}
},
"transport":
{
"mode": "truck"
},
"tolls":
[
{
"countryCode": "DEU",
"tollSystemRef": 0,
"tollSystem": "TOLL COLLECT GMBH",
"fares":
[
{
"id": "7577b304-6644-44f9-a31f-48d3d848481f",
"name": "TOLL COLLECT GMBH",
"price":
{
"type": "value",
"currency": "EUR",
"value": 4.24
},
"reason": "toll",
"paymentMethods":
[
"cash",
"bankCard",
"creditCard",
"transponder",
"travelCard"
]
}
]
}
],
"tollSystems":
[
{
"id": 5200,
"name": "TOLL COLLECT GMBH",
"languageCode": "ENG"
}
]
},
{
"id": "8f7a5792-7676-4e87-8113-aeb0f3497acc",
"type": "vehicle",
"departure":
{
"time": "2022-08-08T12:11:15+02:00",
"place":
{
"type": "place",
"location":
{
"lat": 51.8489,
"lng": 12.33076
},
"originalLocation":
{
"lat": 51.848882,
"lng": 12.3308209
},
"waypoint": 0
}
},
"arrival":
{
"time": "2022-08-08T12:31:17+02:00",
"place":
{
"type": "place",
"location":
{
"lat": 52.0189731,
"lng": 12.5608645
},
"originalLocation":
{
"lat": 52.018234,
"lng": 12.5605609
}
}
},
"transport":
{
"mode": "truck"
},
"tolls":
[
{
"countryCode": "DEU",
"tollSystemRef": 0,
"tollSystem": "TOLL COLLECT GMBH",
"fares":
[
{
"id": "7577b304-6644-44f9-a31f-48d3d848481f",
"name": "TOLL COLLECT GMBH",
"price":
{
"type": "value",
"currency": "EUR",
"value": 4.24
},
"reason": "toll",
"paymentMethods":
[
"cash",
"bankCard",
"creditCard",
"transponder",
"travelCard"
]
}
]
}
],
"tollSystems":
[
{
"id": 5200,
"name": "TOLL COLLECT GMBH",
"languageCode": "ENG"
}
]
}
]
}
]
}
両方の通行料金(各セクションに 1 つずつ)が同じ通行料金 id
= 7577b304-6644-44f9-a31f-48d3d848481f
を共有していることに注意してください。 つまり、同じ通行料金が両方のセクションに適用されるため、支払いは 1 回だけで済みます。 通行料金 id
はレスポンスごとにのみ有効です。 今後のリクエストで同じ通行料金がまったく異なる場合id
があり、リクエストをまたがって再利用することは意図されていません。