渋滞要因でフローをフィルタリングする

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

0.0の値は道路が渋滞していないことを示します。値が10.0に近づくにつれ、渋滞が増加していることを示します。10.0の値は道路が封鎖されていることを示します (閉鎖)。

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

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":[]}