フロー (交通量)

フローデータは、特定の道路における交通の流れに関する情報を提供します。フローは対象となる道路ネットワークの各セグメントについて、交通状況を特徴付ける追加情報と併せて速度値を提供します。

📘
注
フロー情報はjamFactorフィールドを介して閉鎖された道路を示しますが、閉鎖が特に重要なユースケースでは、代わりにインシデントを使用します。

リクエストパラメーター

フローデータまたはインシデントデータを取得するときに必須となるリクエストパラメーターは次の2つです。

in - 地理空間フィルター
locationReferencing - 位置の参照

これらのパラメーターの使用方法の詳細については、次を参照してください。

これに加えて、次の3つのフィルターパラメーターがあります。

minJamFactorおよびmaxJamFactorは、currentFlow.jamFactor値に基づいてレスポンスをフィルタリングします。詳細については、「渋滞要因でフローをフィルタリングする」を参照してください。
functionalClassesはレスポンスの位置を、それが表す道路の機能道路クラスによってフィルタリングします。詳細については、「機能クラスでフローをフィルタリングする」を参照してください。
advancedFeaturesパラメーターを使用して、レスポンスに高度なトラフィック機能を含めることをリクエストします。詳細については、「高度なトラフィック」を参照してください。

📘
注
advancedFeaturesパラメーターを含むリクエストは、高度なトラフィックに基づいてトランザクションカテゴリーに分類されます。詳細については、「HEREプラットフォーム利用規約」を参照してください。

レスポンスデータモデル

フローエンドポイントからのレスポンスによって、フローオブジェクトのリストとソースデータの最終更新時間が提供されます。

各フローオブジェクトは、位置の参照を含むlocationフィールドと、現在の交通状況を説明するcurrentFlowフィールドで構成されます。

位置の参照オブジェクトの詳細については、「位置の参照」を参照してください。

速度

現在のフローオブジェクトには、次の3つの速度値があります。

freeFlow - 交通量がないときの道路の基準速度 (メートル/秒)。
speed - 道路上での予想速度 (メートル/秒) (法定速度制限を超えない)。
speedUncapped - 道路上での予想速度 (メートル/秒) (法定速度制限を超える場合がある)。

渋滞要因

jamFactorフィールドには道路上の交通量の値が表示されます。期待される移動品質を0.0～10.0の値で示します。

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

渋滞傾向

jamTendencyフィールドは渋滞が増加しているか、減少しているか、または一定であるかを示します。渋滞傾向には次の値が使用されます。

+2 - 渋滞が急速に増加
+1 - 渋滞が増加
0 - 渋滞が一定している
-1 - 渋滞が減少
-2 - 渋滞が急速に減少

デフォルト値の0は、この属性が存在しない場合に使用されます。

通行可能性

traversabilityは、その道路を走行できるかどうかを示します。このパラメーターには次の3つの値のいずれかが使用されます。

open - 道路が開いており走行可能。
closed - 道路が閉鎖 (封鎖) されており走行不可 (jamFactorが10.0)。
reversibleNotRoutable - 道路がリバーシブル車線であり、現在はルーティング不可。詳細は以下を参照してください。

この通行可能性ステータスは、リバーシブル車線を含むルートを検索するときの情報源として最適です。このデータは、ベースマップデータを含む他のソースよりも正確です。公開されている可逆的な情報は、日々の交通量や特別なイベントに基づいて変更できるためです。

アプリケーションはreversibleNotRoutableを任意の方法で処理できますが、「ルーティング不可」を示し、この道路のトラフィックを地図に表示しないようにするために使用することをお勧めします。

リバーシブル道路では、車線の向きが切り替えられている間、両方向の車線がルーティングに使用できなくなります。リバーシブル道路の一部がreversibleNotRoutableではなくclosedとしてマークされる可能性があります。そうするとリバーシブル道路の両方向が閉鎖されますが、これは工事や大きな事故が発生した場合に発生し得るものです。

デフォルト値はopenです。

ジャンクションでの通行可能性

このパラメーターはジャンクションでの通行可能性を示し、道路閉鎖に伴ってジャンクションを通過できるかどうかを示すために使用されます。

allOpen - すべてのジャンクションが通行可能
allClosed - すべてのジャンクションが閉鎖
intermediateClosedEdgeOpen - 道路の始点と終点のジャンクションは通行可能だが、途中にあるジャンクションが閉鎖
startOpenOthersClosed - 最初のエッジジャンクションは通行可能、他のすべてのジャンクションは閉鎖
endOpenOthersClosed - 最後のエッジジャンクションは通行可能、他のすべてのジャンクションは閉鎖

デフォルト値はintermediateClosedEdgeOpenです。フィールドは値がこのデフォルト値と異なる場合にのみ表示されます。

信頼性

confidenceフィールドの値は、速度計算に含まれるリアルタイムデータの割合を示します。値は0.0から1.0の間で正規化され、値には次の意味があります。

0.7 < confidence <= 1.0はリアルタイムの速度を表示
0.5 < confidence <= 0.7は過去の速度を表示
0.0 < confidence <= 0.5 indicates speed limit

このフィールドを使用して、位置情報のデータがリアルタイムのプローブソースから取得されたものか、履歴情報からのみ取得されたものかを特定できます。すべてのConfidenceデータ0.71以上はリアルタイム情報に基づいています。Confidenceの値が0.75以上の場合は、Confidenceの高いリアルタイム情報を示します。信頼性の値が0.70の場合、そのデータは履歴データからのみ取得されています。

車線

lanesフィールドは、現在の道路の車線レベルのフローデータがあり、advancedFeaturesパラメーターにlanesが含まれている場合にのみ表示されます。

詳細については、「高度なトラフィック」を参照してください。

📘
注
advancedFeaturesパラメーターを含むリクエストは、高度なトラフィックに基づいてトランザクションカテゴリーに分類されます。詳細については、「HEREプラットフォーム利用規約」を参照してください。

lanesフィールドの内容の詳細については、「車線レベルのフロー」を参照してください。

サブセグメント

多くの場合、使用されている位置の参照スキームよりも詳細なスケールでフローデータを利用できることがあります。この場合、subSegmentsフィールドには2つ以上のサブセグメントオブジェクトが含まれます。

サブセグメントは移動方向に順序付けられ、すべてを合わせると現在のフローオブジェクトに記述されている道路全体になります。それぞれのサブセグメントにはlengthフィールドがあります (道路またはサブセグメントの始点と終点の間の距離 (メートル単位))。

lengthフィールドに加えて、サブセグメントオブジェクトには現在のフローオブジェクトに表示されるすべてのフィールドが含まれます (subSegmentsフィールド自体を除く)。