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

トランスポンダは、RFID、マイクロ波などの無線通信手段を使用して通行料金の自動決済を可能にする車載の無線決済デバイスです。

このソリューションは世界中で使用されており、トラックなどの大型車両の通行料金決済手段として指定されることもあります。トランスポンダで支払う利点として、利便性、処理の迅速さ、(場合によっては) 料金の割引などが挙げられます。

システムには、たとえば以下のようなものがあります。

ETC (日本)
EZ-Pass (米国)
GO-Box (オーストリア)

使用方法

トランスポンダで支払う通行料の金額を取得するには、ルート計算リクエストにreturn=tollsおよびtolls[transponders]=allオプションを追加します。その結果、次のような動作が発生します。

トランスポンダ専用の料金のみが返されます。
通行料金の概要をリクエストした場合、トランスポンダ専用の料金が計算に使用されます。

📘
注
ルートの通行料金情報のリクエストは、追加のトランザクションとしてカウントされます。

tolls[transponders]=allオプションを追加しない場合、APIは、カードや現金など、他の決済方法を使った場合の料金を返します。トランスポンダを使った場合の料金は、それが唯一の決済方法でない限り、省略されます。

例

1つ目のリクエストは、すべての通行料金をトランスポンダシステム以外の方法で支払うことができるルートを計算します。 2つ目のリクエストのようにtolls[transponders]=allを追加すると、Liefkenshoektunnelトンネルの決済方法がトランスポンダに変更されます。なお、2つ目のリクエストのレスポンスには、Liefkenshoektunnelトンネルの支払いでサポートされているトランスポンダシステムのリストが含まれています。

トランスポンダ料金ありのリクエスト

curl -gX 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": "9e10cd65-373a-490c-8391-aee1190f8828",
      "sections": [
        {
          "id": "f821525e-f4cb-4966-b6d6-5442f3fa1ead",
          "type": "vehicle",
          ...,
          "transport": {
            "mode": "car"
          },
          "tolls": [
            {
              "countryCode": "BEL",
              "tollSystemRef": 0,
              "tollSystem": "LIEFKENSHOEKTUNNEL",
              "fares": [
                {
                  "id": "f4d356a1-7e8e-49b7-8fbe-fbc6a14394ab",
                  "name": "LIEFKENSHOEKTUNNEL",
                  "price": {
                    "type": "value",
                    "currency": "EUR",
                    "value": 5.6
                  },
                  "reason": "toll",
                  "paymentMethods": [
                    "bankCard",
                    "creditCard",
                    "travelCard"
                  ]
                },
                {
                  "id": "c878e538-58ea-4968-94b7-8e22a696e0d8",
                  "name": "LIEFKENSHOEKTUNNEL",
                  "price": {
                    "type": "value",
                    "currency": "EUR",
                    "value": 7.0
                  },
                  "reason": "toll",
                  "paymentMethods": [
                    "cash"
                  ]
                }
              ],
              "tollCollectionLocations": [
                {
                  "name": "Kallo",
                  "location": {
                    "lat": 51.28629,
                    "lng": 4.28951
                  }
                }
              ]
            }
          ],
          "tollSystems": [
            {
              "name": "LIEFKENSHOEKTUNNEL"
            }
          ]
        }
      ]
    }
  ]
}

トランスポンダ料金なしのリクエスト

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

{
  "routes": [
    {
      "id": "61b324f5-7c73-4dc0-95eb-4eadd09742af",
      "sections": [
        {
          "id": "f4c48fb5-4ee1-4137-95b4-df11be61057b",
          "type": "vehicle",
          ...,
          "transport": {
            "mode": "car"
          },
          "tolls": [
            {
              "countryCode": "BEL",
              "tollSystemRef": 0,
              "tollSystem": "LIEFKENSHOEKTUNNEL",
              "fares": [
                {
                  "id": "26274842-b8ab-42eb-b7a4-37815a8884a9",
                  "name": "LIEFKENSHOEKTUNNEL",
                  "price": {
                    "type": "value",
                    "currency": "EUR",
                    "value": 4.0
                  },
                  "reason": "toll",
                  "paymentMethods": [
                    "transponder"
                  ],
                  "transponders": [
                    {
                      "system": "BP TOLLBOX"
                    },
                    {
                      "system": "DKV BOX EUROPE"
                    },
                    {
                      "system": "EUROWAG"
                    },
                    {
                      "system": "Eurotoll Tribox-Air Trucks"
                    },
                    {
                      "system": "PASSango EuroPilot Trucks "
                    },
                    {
                      "system": "PASSango Europe Trucks"
                    },
                    {
                      "system": "Telepass EU Trucks"
                    },
                    {
                      "system": "UTA"
                    },
                    {
                      "system": "Viaxxès SAT Trucks"
                    },
                    {
                      "system": "Viaxxès Trucks"
                    }
                  ]
                }
              ],
              "tollCollectionLocations": [
                {
                  "name": "Kallo",
                  "location": {
                    "lat": 51.28629,
                    "lng": 4.28951
                  }
                }
              ]
            }
          ],
          "tollSystems": [
            {
              "name": "LIEFKENSHOEKTUNNEL"
            }
          ]
        }
      ]
    }
  ]
}

トランスポンダ専用料金所を回避する

トランスポンダでしか支払えない料金所を含むルートセクションを回避するルートを計算するには、ルート計算リクエストにavoid[tollTransponders]=allオプションを追加します。

25 日前の更新