機能クラスでフローをフィルタリングする

道路は機能クラスによって分類されます。次の表に、道路ネットワークセグメントの機能クラスまたは機能道路クラス(FRC)の階層的分類を示します。

道路の機能クラスの値	機能クラス名
1	このクラスの道路は、大都市圏と都市圏を結ぶ、最高速度での大量の車両の通行を目的としています。速度の変化はあったとしても、ほとんどありません。このクラスの道路へのアクセスは通常制御されています。
2	このクラスの道路は、主要道路(FRC1)への交通手段を提供し、最短時間で都市間および都市を通過するために使用されます。速度の変化はあったとしても、ほとんどありません。
3	このクラスの道路は1級道路(FRC2)と相互接続し、1級道路(FRC2)よりも移動レベルは劣りますが、大量の交通車両が移動できます。
4	このクラスの道路では、大量の交通車両が近隣地域間を適度な速度で移動できます。これらの道路は、上位の機能クラスの道路に接続し、近隣地域間の交通を収集および分散します。
5	このクラスの道路の交通車両の量と移動レベルは、他の道路のレベルより少なくなっています。

フローをリクエストする場合、特定の機能クラスを持つ道路に関連するフロー情報のみを受信するようにレスポンスをフィルタリングできます。フィルターは、1つの機能クラスまたは機能クラスのリストを参照できます。

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

{
   "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"
         }
      },
      ...
   ]
}

上のレスポンスは、読みやすいように省略されています。

機能クラスフィルターを使用してリクエストされた場所で利用できる交通情報がない場合、resultsは空の配列になります。

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