フローデータをリクエストする

基本的なフローリクエストは、地理空間フィルター(in)と返される位置の参照タイプ(locationReferencing)で構成されます。レスポンスには、リクエストされたエリア内にある道路セグメントの交通流情報が含まれます。

地理空間フィルターinには円、バウンディングボックス、コリドーを使用でき、それぞれ独自の形式を持ちます。

以下の例では、緯度、経度が示す点と半径で指定された円を使用しています。 in=circle:52.50811,13.47853;r=2000。

地理空間のフィルタリングタイプの詳細については、「地理空間フィルタリング」を参照してください。

locationReferencingにはtmc、olr、shapeの1つ以上を指定できます。位置のタイプには解釈できるもののみを指定し、処理できないデータを取得しないようにします。

📘
注
フロー情報の位置に興味がない場合はnoneを指定してください。レスポンスに位置参照が含まれなくなります。

位置の参照タイプの詳細については、「位置の参照」を参照してください。

返されるデータはフローアイテムの配列であり、それぞれにlocationとcurrentFlowの要素があります。

各locationには、メートル単位のlengthと、通常は道路名が含まれるdescriptionと、locationReferencingパラメーターでリクエストされたタイプに応じた、その場所で利用可能な位置の参照が含まれます。

各フローアイテムのcurrentFlow要素には、フローアイテムの速度、渋滞係数、走行可能性の情報が含まれています。

curl -H "Authorization: Bearer $TOKEN" "https://data.traffic.hereapi.com/v7/flow?in=circle:52.50811,13.47853;r=2000&locationReferencing=olr"

{
   "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配列は、読みやすいように省略されています。

リクエストされた場所で利用できる交通情報がない場合、resultsは空の配列になります。

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