ルートインポートサービスを使って通行料金を取得する

ルートインポート (v8/import) サービスは、通行料金を直接返すことはできません。この情報は、2つのAPIコールを使用して取得できます。まず、v8/importリクエストを送信してルートハンドルを取得します。次に、v8/routesエンドポイントを呼び出して、通行料金情報を取得します。

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

ルートハンドルを取得する

次のリクエストを/importエンドポイントに送信して、一連のトレースポイントからルートを計算し、そのルートのルートハンドルを取得します。ルートハンドルを取得するには、リクエストにreturn=routeHandleパラメーターを含める必要があります。

curl -gX POST 'https://router.hereapi.com/v8/import?'\
'return=routeHandle&'\
'transportMode=car&'\
'apiKey=YOUR_API_KEY' \
  -H 'Content-Type: application/json' -d '
{
  "trace": [
    {
      "lat": 47.385112,
      "lng": 14.921353
    },
    {
      "lat": 47.386529,
      "lng": 14.916923
    },
    {
      "lat": 47.387452,
      "lng": 14.910906
    }
  ]
}
'

レスポンス

APIは次のレスポンスを返します。ルートハンドルはrouteHandleフィールドに保存されています。レスポンス例は途中で省略されています。

{
  "routes": [
    {
      "id": "1fda55c6-3bcf-4bc8-94f6-0965a653691d",
      "sections": [
        {
          "id": "bb2265af-758b-435d-8dec-7fef0c1e71f2",
          "type": "vehicle",
          ...,
          "transport": {
            "mode": "car"
          }
        }
      ],
      "routeHandle": "AGcA_v___wUAAQCWAAAAeNpjmMbAwMTAwMCekVqUapWcq6qTzgnkMqwUSDbn4lkZMadLyHBTIoxeAaQFgTQDFoBuwvf8eDEmns6iWV3X521KhNFdUJoBB1DY63GEEUgzAgCDECUtY66_Xg"
    }
  ]
}

ルートハンドルの通行料金の金額を取得する

次のリクエストを/routesエンドポイントに送信して、指定されたルートハンドルを持つルートの通行料金情報を取得します。レスポンスに通行料金情報を含めるには、return=tollsを含めます。

📘
注
ルートハンドルはいつでも無効にできます。これらの例で使用されているルートハンドルは、あくまでもデモンストレーション用です。このリクエストを試すには、独自のルートハンドルを作成してください。

curl -gX GET 'https://router.hereapi.com/v8/routes/AGcA_v___wUAAQCWAAAAeNpjmMbAwMTAwMCekVqUapWcq6qTzgnkMqwUSDbn4lkZMadLyHBTIoxeAaQFgTQDFoBuwvf8eDEmns6iWV3X521KhNFdUJoBB1DY63GEEUgzAgCDECUtY66_Xg?'\
'return=tolls&'\
'transportMode=car&'\
'apiKey=YOUR_API_KEY'

レスポンス

APIはルートの詳細を返します。通行料金情報はtolls配列に含まれています。レスポンス例は途中で省略されています。

{
  "routes": [
    {
      "id": "2ab023cd-938a-49fc-8716-fe93c63973a0",
      "sections": [
        {
          "id": "b678110e-1c95-4882-a340-d69138487d66",
          "type": "vehicle",
          ...,
          "transport": {
            "mode": "car"
          },
          "tolls": [
            {
              "countryCode": "AUT",
              "tollSystemRef": 0,
              "tollSystem": "VIGNETTE AUSTRIA",
              "fares": [
                {
                  "id": "f37b1c4f-cbde-4ef7-9067-e4da106fd0a4",
                  "name": "VIGNETTE AUSTRIA",
                  "price": {
                    "type": "value",
                    "currency": "EUR",
                    "value": 8.6
                  },
                  "reason": "toll",
                  "paymentMethods": [
                    "passSubscription"
                  ],
                  "pass": {
                    "returnJourney": false,
                    "validityPeriod": {
                      "period": "days",
                      "count": 1
                    }
                  }
                },
                {
                  "id": "bef6419c-a0e4-422d-904a-3efd3ea0eb4d",
                  "name": "VIGNETTE AUSTRIA",
                  "price": {
                    "type": "value",
                    "currency": "EUR",
                    "value": 11.5
                  },
                  "reason": "toll",
                  "paymentMethods": [
                    "passSubscription"
                  ],
                  "pass": {
                    "returnJourney": false,
                    "validityPeriod": {
                      "period": "days",
                      "count": 10
                    }
                  }
                },
                {
                  "id": "c6fd7fc3-e17a-4561-ba53-b0d38b3b6e68",
                  "name": "VIGNETTE AUSTRIA",
                  "price": {
                    "type": "value",
                    "currency": "EUR",
                    "value": 28.9
                  },
                  "reason": "toll",
                  "paymentMethods": [
                    "passSubscription"
                  ],
                  "pass": {
                    "returnJourney": false,
                    "validityPeriod": {
                      "period": "months",
                      "count": 2
                    }
                  }
                },
                {
                  "id": "c04d5c2e-36d4-474f-9d89-d2a2633c77b4",
                  "name": "VIGNETTE AUSTRIA",
                  "price": {
                    "type": "value",
                    "currency": "EUR",
                    "value": 96.4
                  },
                  "reason": "toll",
                  "paymentMethods": [
                    "passSubscription"
                  ],
                  "pass": {
                    "returnJourney": false,
                    "validityPeriod": {
                      "period": "extendedAnnual"
                    }
                  }
                }
              ]
            }
          ],
          "tollSystems": [
            {
              "name": "VIGNETTE AUSTRIA"
            }
          ]
        }
      ]
    }
  ]
}

先月の更新