Jam Factor でフローをフィルタリング

このフィールドjamFactorには、道路上の交通量の値が表示されます。 値は 0.0 ～ 10.0 です。

値が 0.0 の場合、道路に渋滞がないことを示します。 値が 10.0 に近づくと、輻輳が増加していることを示します。 値 10.0 は、道路の閉塞（閉鎖）を表すために予約されています。

フローをリクエストする場合、minJamFactorからmaxJamFactorまでの間にJam Factorがあるフローアイテムのみを受信するようにレスポンスをフィルタリングできます。

curl \
   -X GET \
   -H "Authorization: Bearer $TOKEN" \
   'https://data.traffic.hereapi.com/v7/flow?in=circle:52.50811,13.47853;r=2000&locationReferencing=olr&minJamFactor=1.0&maxJamFactor=2.1'

{
   "sourceUpdated":"2021-06-08T10:07:23Z",
   "results":[
      {
         "location":{
            "description":"Alt-Friedrichsfelde",
            "length":966.0,
            "olr":"CCoBEAAmJQmadyVXRQAJBQQBAkcACgUEAYpTAAfI/7QACQUEAQK3ADAAgxM="
         },
         "currentFlow":{
            "speed":13.888889,
            "speedUncapped":14.722222,
            "freeFlow":13.888889,
            "jamFactor":1.2,
            "confidence":0.99,
            "traversability":"open"
         }
      },
      {
         "location":{
            "description":"Rosenfelder Straße",
            "length":929.0,
            "olr":"CCoBEAAmJQmeJyVXKAAJBQQBArcACgUEAYpoAPgaAEkACQUEAQJFADCDTQA="
         },
         "currentFlow":{
            "speed":13.888889,
            "speedUncapped":14.722222,
            "freeFlow":13.611112,
            "jamFactor":2.0,
            "confidence":0.99,
            "traversability":"open"
         }
      },
      ...
   ]
}

上記のレスポンスは、読みやすさのために切り捨てられました。

要求されたJam Factorの範囲内で、リクエストされた場所で交通情報が利用できない場合、results は 空のアレイになります。

{"sourceUpdated":null,"results":[]}