ディファレンス クリエーター プロセッサを使用して、イベント レコードのジオメトリと単一のジオフェンスの間の交差を決定できます。 プロセッサは、イベント レコードのジオメトリとのジオフェンスの交差部分をクリップまたは削除します。
例
ディファレンス クリエーター プロセッサの使用例を次に示します。
- ジオフェンスおよび交差しているイベント レコードの間の幾何学的な差を計算すると、除雪車が除雪したエリアと雪が残っているエリアを示すことができます。
- ジオフェンスおよび交差しているイベント レコードの間の幾何学的な差を計算すると、調査員が調査したエリアと、今後調査が必要なエリアを示すことができます。
- ジオフェンスおよび交差しているイベント レコードの間の幾何学的な差を計算すると、アセットが固定境界に接触、侵入、交差したかどうかの監視に役立てることができます。
使用上の注意
ディファレンス クリエーター プロセッサを使用する際には、以下の点に注意してください。
- ディファレンス クリエーター プロセッサでは、2 つの個別のジオメトリを指定する必要があります。 たとえば、正規表現を使用して複数のジオフェンスを指定し、各ジオフェンスの交差部分をイベント レコードのジオメトリから削除することはできません。
- また、このプロセッサでは、ジオフェンスの次元をイベント レコードのジオメトリの次元以上にする必要があります。 たとえば、ポリラインからポイント、またはポリゴンからポリラインをクリップまたは除去することはできません。
- このプロセッサでは、イベント レコードのジオメトリが格納されているフィールドを指定する必要があります。 ジオメトリ フィールド名を指定するか、GEOMETRY タグをジオイベント定義のフィールドに適用して、ジオメトリ フィールドを識別できます。
- [ジオメトリ フィールド] パラメーターには、ジオメトリのデータ タイプを含むすべてのジオイベント定義に含まれる、すべてのフィールドの名前が表示されます。 ジオメトリ フィールドを名前で選択する場合、イベント レコードのジオイベント定義に対応する正しいジオメトリ フィールドの名前を選択します。
- ディファレンス クリエーターは、イベント レコードのジオメトリを 2 つのジオメトリから計算された差分に置き換えるように構成することも、[ジオメトリの置換] パラメーターを使用して、その差分を新しいジオメトリ フィールドに挿入するように構成することもできます。 新しいフィールドを追加してイベント レコードのスキーマを変更するには、GeoEvent Server で新しいジオイベント定義を作成する必要があります。 新しいジオイベント定義は GeoEvent Server で管理され、プロセッサまたはプロセッサが使用されているジオイベント サービスに対して変更が行われた場合に削除されます。
- [新しいジオメトリ フィールドをジオメトリとしてタグ付け] パラメーターで [はい] を選択すると、後続の処理または出力でイベント レコードの実現済みジオメトリとして扱うジオメトリ フィールドが GeoEvent Server に明示的に通知されます。
パラメーター
ディファレンス クリエーター プロセッサのパラメーターを次に示します。
| パラメーター | 説明 |
|---|---|
|
Name |
GeoEvent Manager で参照用として使用されるプロセッサの記述名。 |
|
プロセッサ |
選択されたプロセッサを示します。 |
| ジオメトリ フィールド | プロセッサが交差するジオフェンスとの幾何学的な差の計算に使用する、受信イベント レコードのジオメトリ フィールドまたは [GEOMETRY] タグが付いたフィールドの名前。 |
| ジオメトリの置換 | 現在のイベント レコード ジオメトリを、クリップされたジオフェンスのジオメトリに置き換えるかどうかを指定します。 デフォルトは [はい] です。
|
| 新しいジオメトリ フィールド名 (条件) | クリップされたジオフェンスのジオメトリが格納される新しいジオメトリ フィールドの名前。 このパラメーターは、[ジオメトリの置換] が [いいえ] に設定されている場合に表示され、[はい] に設定されている場合は非表示になります。 |
| 新しいジオメトリ フィールドをジオメトリとしてタグ付け (条件) | プロセッサによって作成された新しいジオメトリ フィールドに [GEOMETRY] タグを付けるかどうかを決定します。 [GEOMETRY] タグは、複数のジオメトリ フィールドが存在する場合に、GeoEvent Server がイベント レコードの実現済みジオメトリを識別するために使用します。 デフォルトは [いいえ] です。 このパラメーターは、[ジオメトリの置換] が [いいえ] に設定されている場合に表示され、[はい] に設定されている場合は非表示になります。 |
| 新しいジオイベント定義名 (条件) | 新しいジオイベント定義に与えられる名前。 新しいジオイベント定義は、受信イベント レコードのスキーマと新たなジオメトリ フィールドの組み合わせです。 このパラメーターは、[ジオメトリの置換] が [いいえ] に設定されている場合に表示され、[はい] に設定されている場合は非表示になります。 |
| ジオフェンス | GeoEvent Server に登録されているジオフェンスのカテゴリと名前。 プロセッサはジオフェンスを使用して、交差するイベント レコードとの幾何学的な差を計算します。 生成されるジオメトリは、ジオフェンスのクリップされた部分です。 category/name の形式で、正規表現パターンのペアとして指定する必要があります。 たとえば、Pavilions/Alpha は、イベント レコードのジオメトリがあるカテゴリ Pavilions のジオフェンス Alpha を使用します。 注意:複数のジオフェンス category/name の式は、カンマ区切りリストとして指定できません。 たとえば、Countries/France, Countries/Germany の指定は、ジオフェンス France または Germany を指定するのに使用できません。 注意:カテゴリと名前の両方に正規表現を使用します。 式 .*/.* には、すべてのカテゴリのすべてのジオフェンスが含まれ、このプロセッサは 2 つのジオフェンスのみを操作するため、このパターンはほとんど使用されません。 正規表現パターンでは大文字/小文字が区別されることを忘れないでください。 |
検討事項および制限事項
イベント データをフィーチャ サービスに送信する前に、既存のイベント レコード ジオメトリを、計算された差を表すジオメトリで置き換えることを検討してください。 フィーチャ サービスでは 1 つのジオメトリ タイプ フィールドのみをサポートしているため、[GEOMETRY] タグが付けられていないフィールドは変換され、文字列として保持されます。