ユニオン クリエーター プロセッサーは、イベント レコードの関連ジオメトリーと、ジオフェンスとしてインポートした 1 つ以上のジオメトリーとの幾何学的ユニオンを生成するときに使用します。
例
ユニオン クリエーター プロセッサーの使用例を次に示します。
- このプロセッサーを使用して、交差するジオフェンスでイベント レコードのジオメトリーを改善できます。 ジオメトリーのユニオンは、イベントが発生したジオフェンス (またはエリア) のオーバーレイを示すために後処理ワークフローで使用できます。
- このプロセッサーを使用して、ポイント イベントの観測データからマルチポイント フィーチャを作成できます。 受信ポイント ベントはフィーチャ サービスに送信され、ジオフェンスとして格納されます。 受信した新しい各ポイントを使用して、ジオフェンスとして過去の観測データとユニオンすることができます。 生成されるジオメトリーは、アクティブなポイント イベント観測データと過去のジオフェンス イベント観測データのほぼリアルタイムのコレクションとを組み合わせるマルチポイント フィーチャです。
使用上の注意
ユニオン クリエーター プロセッサーを使用する際には、以下の点に注意してください。
- ユニオン クリエーター プロセッサーは、イベント レコードのジオメトリーと、ジオフェンスとして登録されている 1 つ以上のジオメトリーを使用します。 たとえば、正規表現を使用して複数の異なるジオフェンスを指定して、ユニオンを決定できます。
- このプロセッサーでは、ジオメトリーが格納されたイベント レコードのフィールドを指定する必要があります。 ジオメトリー フィールド名を指定するか、ジオイベント定義のフィールドに適用する [GEOMETRY] タグを使用して、ジオメトリー フィールドを識別できます。
- ディファレンス クリエーターは、イベント レコードのジオメトリーを指定されたジオメトリーのユニオンに置き換えるか、[ジオメトリーの置換] パラメーターを使用して、そのユニオンを新しいジオメトリー フィールドに挿入するように構成できます。 新しいフィールドをイベント レコードに追加すると、イベント レコードのスキーマが変更されるため、GeoEvent Server は新しいジオイベント定義を作成する必要があります。 新しいジオイベント定義は GeoEvent Server で管理され、プロセッサーまたはプロセッサーが使用されているジオイベント サービスに対して変更が行われた場合に削除されます。
- 2 つの個別のジオメトリーのみを操作するディファレンス クリエーター プロセッサーやシンメトリック ディファレンス クリエーター プロセッサーなどの他のプロセッサーとは異なり、ユニオン クリエーター プロセッサーでは正規表現が許容されるため、複数のジオフェンスを指定できます。 受信したイベント レコードのジオメトリーのユニオンは、ジオフェンスとしてインポートした 1 つ以上のジオメトリーとともに取得できます。
パラメーター
ユニオン クリエーター プロセッサーのパラメーターについて、以下で説明します。
| パラメーター | 説明 |
|---|---|
|
Name |
GeoEvent Manager で参照用として使用されるプロセッサの記述名。 |
|
プロセッサ |
選択されたプロセッサを示します。 |
| ジオメトリー フィールド | ジオフェンスとのユニオンの計算に使用する、受信イベント レコードのジオメトリー フィールドまたは [GEOMETRY] タグが付いたフィールドの名前。 |
| ジオメトリーの置換 | アクティブなイベント レコードのジオメトリーを、イベント レコードのジオメトリーとジオフェンスのユニオンに置き換えるかどうかを指定します。 デフォルトは [はい] です。
|
| 新しいジオメトリー フィールド名 (条件) | イベント レコードとジオフェンスのジオメトリーのユニオンが格納される新しいジオメトリー フィールドの名前。 このパラメーターは、[ジオメトリーの置換] が [いいえ] に設定されている場合に表示され、[はい] に設定されている場合は非表示になります。 |
| 新しいジオメトリー フィールドをジオメトリーとしてタグ付け (条件) | プロセッサーによって作成された新しいジオメトリー フィールドに [GEOMETRY] タグを付けるかどうかを指定します。 [GEOMETRY] タグは、複数のジオメトリー フィールドが存在する場合に、GeoEvent Server がイベント レコードのジオメトリーを識別するために使用します。 デフォルトは [いいえ] です。 このパラメーターは、[ジオメトリーの置換] が [いいえ] に設定されている場合に表示され、[はい] に設定されている場合は非表示になります。 |
| 新しいジオイベント定義名 (条件) | 新しいジオイベント定義に与えられる名前。 新しいジオイベント定義は、受信イベント レコードのスキーマと新たなジオメトリー フィールドの組み合わせです。 このパラメーターは、[ジオメトリーの置換] が [いいえ] に設定されている場合に表示され、[はい] に設定されている場合は非表示になります。 |
| ジオフェンス | GeoEvent Server に登録されているジオフェンスのカテゴリと名前。 プロセッサーはジオフェンスを使用して、イベント レコードのジオメトリーとの幾何学的ユニオンを計算します。 プロセッサーは正規表現をサポートしているため、カテゴリの複数のジオフェンスまたは複数のカテゴリを指定できます。 category/name の形式で、正規表現パターンのペアとして指定する必要があります。次に例を示します。
注意:
|
検討事項および制限事項
ユニオン クリエーター プロセッサーを使用する際には、以下の点を考慮してください。
- ユニオン クリエーター プロセッサーを構成するときは、関係するイベント レコードとジオフェンスのジオメトリーを検討してください。 たとえば、イベント レコードのポイント ジオメトリーと、ジオメトリーがポリゴンであるジオフェンスをユニオンすると、ポリゴン ジオメトリーのみが生成されます。 イベント レコードのポリゴン ジオメトリーと、ジオメトリーもポリゴンであるジオフェンスをユニオンすると、両方のポリゴン ジオメトリーが生成されます。
- イベント データをフィーチャ サービスに送信する前に、既存のイベント レコードのジオメトリーをユニオン ジオメトリーに置き換えることを検討してください。 フィーチャ サービスでは 1 つのジオメトリー タイプ フィールドのみをサポートします。このフィールドは [GEOMETRY] タグが付けられていないフィールドが付けられている必要があります。 2 番目のジオメトリー フィールドの値は、イベント レコードのデータ値を保持するよう文字列に変換できます。