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

複数区間のルートの通行料のリクエストです。休憩エリアでの有料高速道路のストップオーバーが含まれています。出発時間は関係ありません。 ドライバーが、ストップオーバー後の 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があり、リクエストをまたがって再利用することは意図されていません。

」に一致する結果は 件です

    」に一致する結果はありません