ジオタガー プロセッサを使用して、対象地域 (ジオフェンスとも呼ばれる) の名前の情報をジオイベントに付加できます。この対象地域とジオイベントのジオメトリとの間には、指定された空間リレーションシップがあります。
ジオタグは、イベントへの情報付加と空間フィルターを行います。たとえば、ジオイベントのジオメトリを内部に含むことが検出されたすべてのジオフェンスの名前を付加するようにジオタガー プロセッサを構成できます。ジオタガー プロセッサが処理したジオイベントにはフィールドが追加され、そのフィールドには、ジオイベントのジオメトリを含むことが検出されたすべてのジオフェンスの名前が格納されます。
備考:
ジオタガー プロセッサを構成する前に、ジオフェンスをフィーチャ サービスから GeoEvent Server にインポートしておく必要があります。GeoEvent Server でのジオフェンスの操作方法の詳細は、「ジオフェンスの管理」をご参照ください。
ジオタガー プロセッサを構成する場合、このプロセッサがジオイベントにタグ付けするために満たす必要のあるリレーションシップを指定する空間演算子を選択する必要があります。たとえば、ジオイベントのポリゴンが交差するすべてのジオフェンスの名前でタグ付けすることによって、ジオイベントに情報を付加することができます。
ジオタガー プロセッサがサポートする空間演算子には、Contains Any、Crosses Any、Disjoint Any、Enter Any、Equals Any、Exit Any、Inside Any、Intersects Any、Outside Any、Overlaps Any、Touches Any、および Within Any があります。これらの演算子は、ジオタガー プロセッサが対象となる (演算子の定義済み空間リレーションシップを満たす) ジオフェンスを使用して、処理中のジオイベントへの情報付加を開始できるということを想定します。
たとえば、Intersects Any 空間演算子を選択して、重複していない対象地域をモデリングする数 10 個のジオフェンスを対象にした場合、ジオイベントのジオメトリと交差するエリアが含まれるすべてのジオフェンスの名前が、処理中のそのジオイベントに追加されます。
備考:
ある地域のモデリングとしてジオフェンスを使用することがよくあり、ジオフェンスは一般的にはポリゴン ジオメトリであると考えられます。サポートされている空間演算子のリストが示すように、ジオフェンスをポイント ジオメトリやポリライン ジオメトリにすることもできます。ジオイベントに関連付けられているポリゴン ジオメトリをテストして、そのポリゴン ジオメトリが、ポイント ジオメトリまたはポリライン ジオメトリを持つジオフェンスと交差またはクロスしているか、あるいはそのジオフェンスを含んでいるかを確認できます。
ジオイベントのジオメトリが格納されたフィールドの名前を指定する場合、ジオタガーは、ジオイベント定義内のイベント フィールドの名前またはフィールドに適用されたタグ (通常は GEOMETRY タグ) のいずれかを受け取ることができます。
ジオタガー プロセッサによってジオイベントのスキーマが変更されるため、GeoEvent Server は新しいジオイベント定義を作成する必要があります。新しいジオイベント定義は、GeoEvent Server で管理され、プロセッサまたはプロセッサが属するジオイベント サービスに対して変更が行われた場合に削除されます。生成される新しいジオイベント定義の名前、およびジオタガー プロセッサが付加情報の値を書き込むフィールドの名前を指定します。
ジオタガー プロセッサによる付加情報の値の書式設定方法として、3 つのオプションを使用できます。[区切り値] は、ジオフェンス名をシンプルなカンマ区切りのリストとして書き込むことを指定します。他の 2 つのオプションは、付加情報の値を、JSON リストとして、または JSON グループ内のエレメントとして書式設定します。ジオフェンス カテゴリの名前を付加情報に含めるようにジオタガー プロセッサを構成し、アメリカの州と郡をジオフェンスの別のカテゴリとして返す場合、ジオタガーによる付加情報の書式は次のようになります。
- リスト: ["UnitedStates/California","Counties/San_Bernardino"]
- グループ: [{"Category":"UnitedStates","Name":"California"},{"Category":"Counties", "Name":"San_Bernardino"}]
ジオタガー プロセッサの詳細については、GeoEvent Server チュートリアルから GeoEvent Server の概要のチュートリアルをご参照ください。