複数区間のルートの通行料金を取得する

これは、出発時間に関係のない、休憩エリアのストップオーバーを伴う有料高速道路を含む複数セクションルートのトールのリクエストです。ドライバーはストップオーバーを通過後の2番目のセクションの、ハイウェイ出口のブースで通行料金を支払います。

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

curl -gX 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",
          ...,
          "transport": {
            "mode": "car"
          }
        },
        {
          "id": "0ff92e1b-3bda-4dae-bc5c-7af672f22fbb",
          "type": "vehicle",
          ...,
          "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 -gX 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",
          ...,
          "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",
          ...,
          "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 = 7577b304-6644-44f9-a31f-48d3d848481f になっています。つまり、同じ通行料金が両方のセクションに適用されるため、支払いは 1 回だけで済みます。また、通行料金 id はレスポンスごとにのみ有効です。今後のリクエストでは同じ料金にまったく異なる id が設定される可能性がありますが、リクエストをまたがって再利用することは意図されていません。

先月の更新