リアルタイムのビッグ データ解析で使用できます。
[インシデントの検出] ツール は、一連の開条件およびオプションの閉条件を使用してフィーチャを評価し、条件を満たす観測データの連続的セットごとに一意のインシデントを作成します。
ワークフロー図
例
以下は、[インシデントの検出] ツールの使用例です。
- 車列内の各車両が、その位置および速度を規則的間隔で送信します。 ある車両の報告された速度が、示された位置に掲示されている速度制限を超えた場合、[インシデントの検出] ツールがインシデントを開始します。 この車両によって報告されたその後の観測データごとに、速度が速度制限を超え続けている場合、インシデントが継続中状態に維持されます。 この車両が掲示されている速度制限内の速度を報告した場合、インシデントが終了されます。
- バルブで現在測定されている圧力を報告するパイプライン上の圧力センサーが、正常な動作範囲外の圧力を示しています。 インシデントの検出は、インシデントを開始し、圧力が正常な範囲から外れていることをセンサーが示す限り、インシデントは継続中状態に維持されます。 圧力が正常に戻った場合、インシデントが終了されます。
- トラックの車列が、危険物を運んでいる車両が禁止されているトンネルに近づいています。 各車両がその位置を報告し、ArcGIS Velocity が、貨物の現在のマニフェストに基づいて、車両ごとの受信情報に情報を更新します。 トラックのうちの 1 台は、危険と見なされる酸化剤を運んでいます。 トンネルへのトラックの近接および貨物の属性に基づいてインシデントが開始されます。 トラックがトンネルから離れて迂回した場合、インシデントが終了されます。
- 特定のルート地域に割り当てられた配送車両は、一定期間だけ地域の外に移動します。 車両が指定の地域から出るとインシデントが開き、車両が指定の地域に戻るとインシデントが閉じます。
使用上の注意
[インシデントの検出] ツールを操作する際には、以下の点に注意してください。
- [開条件] パラメーターは必須ですが、[閉条件] パラメーターは任意です。 [閉条件] パラメーター値が明示的に設定されない場合、[開条件] の論理否定演算子が閉条件として使用されます。
- [空間リレーションシップ] オプションが [交差する] に設定された場合、暗黙的な [閉条件] 値は [Disjoint] になります。
- [空間リレーションシップ] オプションが [進入] または [退出] に設定された場合、暗黙的な [閉条件] 値はそれぞれ [退出] または [進入] になります。
- リアルタイム解析で、[空間リレーションシップ] の [開条件] または [閉条件] に [進入] または [退出] が使用される場合、このツールはステートフルな形式で動作します。 ツールはステートフルな形式で動作しながら、シーケンシャルな観測データを比較して、観測データ間の状態の変化を検出できます。 このツールは、現在の観測データを以前の観測データと比較する必要がないため、他の空間リレーションシップのオプションを使用する場合にはステートレスな方法で実行されます。 ステートレスな方法で実行すると、リソースの使用量が大幅に減少します。
- ステートフルな方法で動作する場合、[インシデントの検出] ツールは、Track ID ごとの現在の観測データの状態ストアを維持します。 新しい観測データを受信すると、同じ Track ID の現在の観測データと比較されます (存在する場合)。 新しい観測データのタイムスタンプが、状態ストア内の現在の観測データよりも新しい場合、現在の観測データは置き換えられます。 同じ Track ID の現在の観測データと同じタイムスタンプが付与されている場合、ツールは 2 つの観測データを区別できません。 これにより、ツールが状態ストア内の現在の観測データが新しい観測データを置き換えず、新しい観測データが状態ストアに追加されないため、この Track ID に対する今後の観測データは、新しいタイムスタンプが付与された新しい観測データを受信するまで、状態ストアに残っている現在の観測データと比較されます。 これが発生すると、ツールは警告をログに記録します。
- このツールは 2 つの入力を持っていますが、[空間リレーションシップ] を [開条件] または [閉条件] パラメーターに選択する場合、[結合データ] パラメーターのみが使用可能です。
- Arcade 条件式は、[開条件] または [閉条件] パラメーターに対して設定できます。
- リアルタイム解析で [有効期間で終了] パラメーターが [はい] に設定されている場合、[結合先のタイム ウィンドウ] の有効期限が切れると、開いているインシデントは閉じます。 [いいえ] に設定されている場合、開いているインシデントは開いたままになります。 [結合先のタイム ウィンドウ] の有効期限が切れると、[開条件] パラメーターの空間リレーションシップまたは属性式が満たされると、新しいインシデントが作成されます。
- [開条件] パラメーターで [空間リレーションシップ] を選択し、[進入] または [退出] の空間演算子を使用している場合、[最初の観測データで進入をトリガー] または [最初の観測データで退出をトリガー] チェックボックスをオンにすると、各 Track ID で受信または処理された最初の対象フィーチャが [進入] の場合はいずれかの結合フィーチャの内部、または [退出] の場合はすべての結合フィーチャの外部に存在する場合、対象フィーチャの現在の位置を以前の対象フィーチャと比較する必要なしに、インシデントが開くことを示すことができます。 デフォルトはオフです。
- リアルタイム解析の [結合先のタイム ウィンドウ] パラメーターは、インシデントが未解決のままになる最長期間と同じか、それ以上に設定する必要があります。 この期間より古い観測データは、リソースを管理するためにメモリから削除されます。 予想される最長のインシデント継続時間よりも大きな値を設定することをおすすめします。 たとえば、インシデントが開いたままになると予想される最長時間が 20 時間の場合、インシデントが早期に閉じられないようにするために、この値を 24 時間に設定できます。
- 出力インシデントに対して計算される [IncidentDuration] 値はミリ秒単位で表されます。
- 結合ポートにフィードが接続されている場合、インシデントはターゲット フィードと結合フィードの両方で変化しているフィーチャに基づいて検出されます。
- 動的ジオフェンシングを実行する場合、[タイム ウィンドウの結合] パラメーターを設定する必要があります。 結合フィードに [終了時間] オプションに指定されたキー フィールドが含まれておらず、結合フィーチャの最新の観測データがこのウィンドウよりも古い場合、観測データはツールのメモリから削除され、解析から除外されます。 結合フィードに [終了時間] オプションに指定されたキー フィールドが含まれている場合、フィーチャはフィールドの値に応じたタイミングか、終了時間または結合タイム ウィンドウが終了するタイミングのどちらか早い方で、ジオフェンス ストアで有効期限切れになります。
- 動的ジオフェンシングが実行されている場合、Arcade 条件式はターゲット フィーチャに対してのみ有効です。
- 入力と結合のジオメトリ タイプに基づいて使用可能な空間リレーションシップ メソッドの概要を以下の表に示します。
入力と結合のジオメトリ タイプ | 含む | 横切る | Disjoint | Enter キー | 等しい | 終了 | 交差する | 最近接測地線 | 最近接平面 | 重複する | 接する | 含まれる |
---|---|---|---|---|---|---|---|---|---|---|---|---|
ポイントとポイント | ||||||||||||
ポイントとポリライン | ||||||||||||
ポイントとポリゴン | ||||||||||||
ポリラインとポイント | ||||||||||||
ポリラインとポリライン | ||||||||||||
ポリラインとポリゴン | ||||||||||||
ポリゴンとポイント | ||||||||||||
ポリゴンとポリライン | ||||||||||||
ポリゴンとポリゴン |
パラメーター
以下は、[インシデントの検出] ツールのパラメーターです。
パラメーター | 説明 | データ タイプ |
---|---|---|
ターゲット データ | [開条件] パラメーターと [閉条件] パラメーターを使用してインシデントが検出されたデータ。 | フィーチャ |
[結合データ] (オプション) | [開条件] パラメーターまたは [閉条件] パラメーターの空間リレーションシップで使用されるデータ。 | フィーチャ |
開条件 | インシデントの開始を定義する条件のセット。 これは、空間条件、時間範囲、および属性条件式のセットを含むことができます。
注意:[開条件] パラメーターの空間リレーションシップとして [Disjoint] または [退出] が使用されている場合、インシデントを開くには、ターゲット フィーチャが [結合データ] パラメーター ソースのフィーチャから完全に分断されている必要があります。 その他のすべての空間リレーションシップ オプションで、ターゲット フィーチャが [結合データ] パラメーター ソースのいずれかのフィーチャを含む空間リレーションシップに適合してさえいればインシデントを開くことができます。 | パラメーター |
[閉条件] (オプション) | インシデントの終了を定義する条件のセット。 [開条件] パラメーターと同様に、これは、空間条件、時間範囲、および属性条件式のセットを含むことができます。
注意:[閉条件] パラメーターの空間リレーションシップとして [Disjoint] または [退出] が使用されている場合、インシデントを開くには、ターゲット フィーチャが [結合データ] パラメーター ソースのフィーチャから完全に分断されている必要があります。 その他のすべての空間リレーションシップ オプションで、ターゲット フィーチャが [結合データ] パラメーター ソースのいずれかのフィーチャを含む空間リレーションシップに適合してさえいればインシデントを開くことができます。 | パラメーター |
インシデントのみを返す | [はい] の場合 - インシデントに関連する観測データのみを返します。 [いいえ] の場合 - すべての観測データを返します。 | Boolean |
トラッキング | 処理されるフィーチャを一意に識別するために使用されるフィールド。 ターゲット フィーチャ レイヤーに Track ID フィールドが指定されている場合、[Track ID] 値は自動的に設定されます。 | フィールド |
結合先のタイム ウィンドウ (リアルタイム解析のみ) | この期間より古い観測データは、リソースを管理するためにメモリから削除されます。 この値は、インシデントが未解決のままになる最長期間以上に設定する必要があります。 予想される最長のインシデント時間よりも大きな値を設定することをおすすめします。 | String |
タイム ウィンドウの結合 (リアルタイム解析のみ) | 結合フィードの有効期限 (動的ジオフェンス)。 結合フィーチャの最新の観測データが指定したタイム ウィンドウより古い場合、その結合フィーチャは削除され、解析には含まれません。 結合フィードに [終了時間] オプションに指定されたフィールドが存在する場合、このパラメーターはオプションです。 注意:このパラメーターは、ターゲット レイヤーと結合レイヤーの両方がフィードである場合にのみ使用できます。 | String |
有効期限で終了 (リアルタイム解析のみ) | [はい] - [結合先のタイム ウィンドウ] 値の有効期限が切れると、開いているインシデントは閉じます。 [いいえ] - [結合先のタイム ウィンドウ] 値の有効期限が切れても、開いているインシデントは開いたままになります。 [結合先のタイム ウィンドウ] 値の有効期限が切れると、空間リレーションシップまたは属性式が満たされると、新しいインシデントが作成されます。 | Boolean |
出力レイヤー
出力レイヤーには、以下のフィールドに加えて、受信フィーチャのスキーマが含まれます。
フィールド名 | 説明 | フィールド タイプ |
---|---|---|
IncidentID | インシデントの一意な ID。 | String |
IncidentStatus | インシデントの現在のステータス。 ステータスは、[Started]、[Ongoing]、または [Ended] のいずれかです。 | String |
IncidentDuration | インシデントが未解決だったミリ秒数。 | Integer |