フロー
フローデータは、特定の道路での交通状況についての情報を提供します。 カバーされている道路ネットワーク の各セグメントについて、フローは速度の値と、交通状況を特性化する追加情報を提供します。
注
フロー情報は フィールドjamFactor
を介して閉鎖された道路を示しますが、閉鎖が特に重要なユースケースでは、代わりにインシデントを使用する必要があります。
リクエストパラメータ
フローデータまたはインシデントデータを取得する場合、 2 つの必須リクエストパラメータがあります。
-
in
- 地理空間フィルタ -
locationReferencing
- 場所の参照
これらのパラメータの使用方法の詳細については、次のトピックを参照してください。
さらに、次の 3 つのフィルタパラメータがあります。
-
minJamFactor
とmaxJamFactor
は、 値currentFlow.jamFactor
に基づいてレスポンスをフィルタリングします。 詳細 については、「 jam factorでフローをフィルタリングする方法」を参照してください。 -
functionalClasses
は、表示されている道路の機能的な道路クラスによって、レスポンスの位置をフィルタリングします。 詳細について は、「機能クラスでフローをフィルタリングする方法」を参照してください。 - このパラメータ
advancedFeatures
は、レスポンスに高度なトラフィックフィーチャーが含まれていることをリクエストするために使用されます。 詳細について は、「カバレッジフローの詳細」および「レーンレベルフロー」を参照してください。
注
このパラメータadvancedFeatures
を含むリクエストは、高度なトラフィックに基づいてトランザクションカテゴリに分類されます。 詳細について は、 HERE platform の使用条件を参照してください。
レスポンスデータモデル
フローエンドポイントからのレスポンスによって、フローオブジェクトのリストとソースデータの最終更新時刻が提供されます。
各フロー オブジェクトは、位置参照を含む フィールドlocation
と、現在の交通状況を説明する フィールドcurrentFlow
で構成されます。
位置参照オブジェクトの詳細について は、「位置参照」を参照してください。
Speeds
現在のフローオブジェクトには、 3 つの速度値が含まれています。
-
freeFlow
-交通渋滞がない場合の道路沿いの基準速度(メートル/秒)。 -
speed
-道路沿いの予想速度(メートル/秒)。法定速度制限を超えない。 -
speedUncapped
-道路沿いの予想速度(メートル/秒)。法定速度を超える場合がある
Jam Factor
このフィールドjamFactor
には、道路の交通量の値が表示されます。 0.0 ~ 10.0の値は、期待される移動品質を示します。
値が 0.0 の場合、道路に渋滞がないことを示します。 値が 10.0 に近づくと、輻輳が増加していることを示します。 値 10.0 は、道路の閉塞(閉鎖)を表すために予約されています。
Jam Tendency
このフィールドjamTendency
は、輻輳が増加しているか、減少しているか、一定であるかを示します。 輻輳傾向には、次の値が使用されます。
-
+2
- 渋滞が急速に増加 -
+1
- 渋滞が増加 -
0
- 渋滞が一定 -
-1
- 渋滞が軽減 -
-2
- 渋滞が急速に緩和
デフォルト値は 0
で、この属性が存在しない場合に使用されます。
Travesability
traversability
は 、道路を走行できるかどうかを示しています。 このパラメータには、次の 3 つの値のいずれかを指定できます。
-
open
-道路が開いており、走行可能。 -
closed
-道路が閉鎖されている(ブロックされている)ため、jamFactor
走行できません(IS 10.0)。 -
reversibleNotRoutable
-道路はリバーシブルであるが、現在はルーティングできない。 詳細については、以下を参照してください。
この走行可能性のステータスは、リバーシブルレーン(動く中央線)を通過する際の情報源として最適です。 このデータは、ベース マップデータを含む他のソースよりも正確です。公開されている可逆的な情報は、日々の交通量や特別なイベントに基づいて変更できるためです。
アプリケーションは 任意の方法reversibleNotRoutable
で処理できますが、「ルーティング不可」を示し、この道路の交通情報を地図表示に表示しないようにするために使用することをお勧めします。
リバーシブル道路では、道路の方向を切り替えている日の一部では、両方向のルートが不可能になります。 リバーシブル道路の一部がreversibleNotRoutable
ではなく closed
としてマークされる可能性があります。 これが発生すると、工事や大きな事故により、リバーシブル道路の両方向が通行止めになる可能性があります
デフォルト値は open
です 。
ジャンクションのTravesability
このパラメータは、交差点の走行可能性を示し、道路閉鎖に伴って交差点を通過できるかどうかを示すために使用されます。
-
allOpen
- すべてのジャンクションは、開放 -
allClosed
- すべてのジャンクションは閉鎖 -
intermediateClosedEdgeOpen
- 道路の始点と終点のジャンクションは、開放、中間のジャンクションが閉鎖 -
startOpenOthersClosed
- 最初のエッジジャンクションは、開放、他のすべてのジャンクションが閉鎖 -
endOpenOthersClosed
- 最後のエッジジャンクションは、開放、他のすべてのジャンクションは閉鎖
デフォルト値はintermediateClosedEdgeOpen
です 。フィールドは、値がこのデフォルト値と異なる場合にのみ表示されます。
Confidence
confidence
フィールドの値は、速度計算に含まれるリアルタイムデータの比率を示します。 0.0 ~ 1.0 の正規化された値で、次の意味を持ちます。
- 0.7 <<=
confidence
1.0 はリアルタイムの速度を表示 - 0.5 <<=
confidence
0.7 は履歴速度を表示 - 0.0 <<=
confidence
0.5 は制限速度を表示
このフィールドを使用して、位置情報のデータがリアルタイムのプローブソースから取得されたものか、履歴情報からのみ取得されたものかを特定できます。 すべてのConfidenceデータ 0.71 以上はリアルタイム情報に基づいています。Confidenceの値が 0.75 以上の場合は、Confidenceの高いリアルタイム情報を示します。 Confidence
の値が 0.70 の場合、データは履歴データからのみ取得されます。
Lanes
このフィールドlanes
は、現在の道路の車線レベルのフローデータがあり 、パラメータadvancedFeatures
にlanes
が含まれている場合にのみ表示 されます。
注
advancedFeatures
パラメータを含むリクエストは、 Advanced Traffic に基づいてトランザクションカテゴリに分類されます。 詳細について は、 HERE platform の使用条件を参照してください。
lanes
フィールドの内容の詳細について は、「レーンレベルのフロー」を参照してください。
Sub-Segments
多くの場合、使用されている位置参照スキームよりも詳細なスケールでフローデータが利用できます。 このような場合 、このフィールドsubSegments
には 2 つ以上のサブセグメントオブジェクトが含まれます。
サブセグメントは移動方向に順序付けられ、現在のフローオブジェクトに記述されている道路全体に合計されます。 各サブセグメントにはフィールド length
があります(道路またはサブセグメントの始点と終点の間の距離(メートル単位))。
フィールドlength
に加えて、サブセグメント オブジェクトにはフィールドsubSegments
自体を除く、現在のフロー オブジェクトに表示されるすべてのフィールドが含まれます
Advanced Features
注
advancedFeatures
パラメータを含むリクエストは、 Advanced Traffic に基づいてトランザクションカテゴリに分類されます。 詳細について は、 HERE platform の使用条件を参照してください。
Deep Coverage Flow
パラメーターadvancedFeatures
にオプション deepCoverage
を含めること で、フローのディープカバレッジをリクエストできます。
ディープカバレッジは、都市部の都市道路に重点を置いた、主要な交通カバレッジの増加を提供します。
Lane Level Flow
場合によっては、複数車線の道路 (主に自動車専用道路/高速道路や主要道路) の特定の車線で利用可能なフロー情報があります。
パラメーター advancedFeatures
にオプションlanes
を含めること で、フローのレーンレベルをリクエストできます。
このパラメータlanes
では、同じ方向に向かう別々のレーンごとに定義されたフローが有効に なります。これには、標準のスプリットレーンと HOV レーンが含まれます。
車線レベルの交通量は、オブジェクトCurrentFlow
内の道路全体、または オブジェクトSubSegment
の下のサブセグメントとして表すことができます。レーンレベルのフローが提供されると、レーンレベル以外の速度も提供され、レーンレベルのトラフィックがリクエストされた場合でも、クライアントはレーンレベルの情報を使用しないように選択できます。
各 LANE オブジェクトには、次のフィールドがあります。
-
laneNumbers
-レーン番号は、HEREマップ方式のレーン番号付けを使用します。左側のレーンは1で、左側のレーンの右側にある各レーンには順番に番号が付けられます。 例えば、3車線の道路では、左車線は1、中央車線は2、右車線は3です。 レーン1は、運転側に関係なく、常に左車線になります。 複数の車線番号が提示された場合、すべての車線に交通状況が表示されます。レーン番号は常に連続しています。 -
laneType
-特別な車線タイプを示すために入力されます hov
。詳細については、以下を参照してください。 -
speedUncapped
- フローの説明に従って、キャップなしの速度。 -
jamFactor
-jamFactor (フローの説明)。
High-Occupancy Vehicle (HOV) lane
laneType
で、hov
をもつレーンは、乗車定員の多い車両レーンに指定されています。その使用は、地域の道路規制によって制限されています。 HOV レーンが存在しない国もあります。
HOV レーンは 、パラメーターadvancedFeatures
にlanes
が含まれている場合にのみ提供 されます。