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