トランスポンダを使用する通行料金の取得

通行料金の運賃は、支払い方法によって大幅に異なる場合があります。 特に、トランスポンダは通常、はるかに安い価格に対応しており、トランスポンダを持っているユーザーは、他の運賃をまったく表示したくない場合があります。 このパラメータ tolls[transponder] を使用すると、このようなトランスポンダを所有していることをユーザーが指定できます。 現在許可されている値はallのみですが、パラメータを指定しない場合、ユーザーにはトランスポンダがまったくないことを意味します。

このパラメータを指定すると、次の 2 つの影響があり

• 指定されたトランスポンダのいずれかが通行料金の支払いを行うことができる場合、トランスポンダを使用する通行料金のみが返されます。
• 指定されたトランスポンダのいずれかが通行料金の支払いを行い、通行料金の要約がリクエストされた場合、トランスポンダの通行料金を使用してこの要約が計算されます。

例

このリクエストの結果生じるルートは、通行料金の支払いを必要とする道路を通過し、支払い手段としてトランスポンダを受け入れます。

curl -X GET \
'https://router.hereapi.com/v8/routes?origin=51.255598,4.260537&destination=51.316223,4.337377&return=tolls&transportMode=car&departureTime=any&apikey={YOUR_API_KEY}'

{
    "routes":
    [
        {
            "id": "dfc779fd-381e-44a0-a31b-7e9d6d86ef69",
            "sections":
            [
                {
                    "id": "917a1520-b8f0-4895-8e7a-a9cfcbc56fa5",
                    "type": "vehicle",
                    "departure":
                    {
                        "time": "2022-09-12T13:04:12+02:00",
                        "place":
                        {
                            "type": "place",
                            "location":
                            {
                                "lat": 51.2559314,
                                "lng": 4.2599393
                            },
                            "originalLocation":
                            {
                                "lat": 51.255598,
                                "lng": 4.260537
                            }
                        }
                    },
                    "arrival":
                    {
                        "time": "2022-09-12T13:17:29+02:00",
                        "place":
                        {
                            "type": "place",
                            "location":
                            {
                                "lat": 51.31641,
                                "lng": 4.33678
                            },
                            "originalLocation":
                            {
                                "lat": 51.3162229,
                                "lng": 4.337377
                            }
                        }
                    },
                    "transport":
                    {
                        "mode": "car"
                    },
                    "tolls":
                    [
                        {
                            "countryCode": "BEL",
                            "tollSystemRef": 0,
                            "tollSystem": "LIEFKENSHOEKTUNNEL",
                            "fares":
                            [
                                {
                                    "id": "c4f1d917-3a7a-43f0-8c90-47ebca012647",
                                    "name": "LIEFKENSHOEKTUNNEL",
                                    "price":
                                    {
                                        "type": "value",
                                        "currency": "EUR",
                                        "value": 3.56
                                    },
                                    "reason": "toll",
                                    "paymentMethods":
                                    [
                                        "transponder"
                                    ]
                                },
                                {
                                    "id": "c0e97aa0-4d49-4bbe-a09e-774710ac852e",
                                    "name": "LIEFKENSHOEKTUNNEL",
                                    "price":
                                    {
                                        "type": "value",
                                        "currency": "EUR",
                                        "value": 6
                                    },
                                    "reason": "toll",
                                    "paymentMethods":
                                    [
                                        "cash"
                                    ]
                                },
                                {
                                    "id": "bf1ea0f5-559a-4112-95bb-562e12397aa0",
                                    "name": "LIEFKENSHOEKTUNNEL",
                                    "price":
                                    {
                                        "type": "value",
                                        "currency": "EUR",
                                        "value": 4.95
                                    },
                                    "reason": "toll",
                                    "paymentMethods":
                                    [
                                        "bankCard",
                                        "creditCard",
                                        "travelCard"
                                    ]
                                }
                            ],
                            "tollCollectionLocations":
                            [
                                {
                                    "name": "Kallo",
                                    "location":
                                    {
                                        "lat": 51.28629,
                                        "lng": 4.28951
                                    }
                                }
                            ]
                        }
                    ],
                    "tollSystems":
                    [
                        {
                            "id": 7057,
                            "name": "LIEFKENSHOEKTUNNEL",
                            "languageCode": "ENG"
                        }
                    ]
                }
            ]
        }
    ]
}

トンネルの通行料金のコストをカバーするには、3 種類の運賃が考えられます。 ただし、このいずれかが有効なのは、トランスポンダを使用して支払う場合のみです。 これは、リクエストにtolls[transponders]=all を追加するときに明らかになります。

curl -X GET \
'https://router.hereapi.com/v8/routes?origin=51.255598,4.260537&destination=51.316223,4.337377&return=tolls&transportMode=car&departureTime=any&tolls[transponders]=all&apikey={YOUR_API_KEY}'

{
    "routes":
    [
        {
            "id": "a5702b49-3dbc-42a4-b938-49fd3e869c73",
            "sections":
            [
                {
                    "id": "110e80a7-2165-4106-b534-77f461b67aa1",
                    "type": "vehicle",
                    "departure":
                    {
                        "time": "2022-09-12T13:08:40+02:00",
                        "place":
                        {
                            "type": "place",
                            "location":
                            {
                                "lat": 51.2559314,
                                "lng": 4.2599393
                            },
                            "originalLocation":
                            {
                                "lat": 51.255598,
                                "lng": 4.260537
                            }
                        }
                    },
                    "arrival":
                    {
                        "time": "2022-09-12T13:21:53+02:00",
                        "place":
                        {
                            "type": "place",
                            "location":
                            {
                                "lat": 51.31641,
                                "lng": 4.33678
                            },
                            "originalLocation":
                            {
                                "lat": 51.3162229,
                                "lng": 4.337377
                            }
                        }
                    },
                    "transport":
                    {
                        "mode": "car"
                    },
                    "tolls":
                    [
                        {
                            "countryCode": "BEL",
                            "tollSystemRef": 0,
                            "tollSystem": "LIEFKENSHOEKTUNNEL",
                            "fares":
                            [
                                {
                                    "id": "343afda9-850c-480a-a54c-e45ff4a642b3",
                                    "name": "LIEFKENSHOEKTUNNEL",
                                    "price":
                                    {
                                        "type": "value",
                                        "currency": "EUR",
                                        "value": 3.56
                                    },
                                    "reason": "toll",
                                    "paymentMethods":
                                    [
                                        "transponder"
                                    ]
                                }
                            ],
                            "tollCollectionLocations":
                            [
                                {
                                    "name": "Kallo",
                                    "location":
                                    {
                                        "lat": 51.28629,
                                        "lng": 4.28951
                                    }
                                }
                            ]
                        }
                    ],
                    "tollSystems":
                    [
                        {
                            "id": 7057,
                            "name": "LIEFKENSHOEKTUNNEL",
                            "languageCode": "ENG"
                        }
                    ]
                }
            ]
        }
    ]
}

この場合、トランスポンダでの支払いに対応する運賃のみが結果に含まれます。