摘要
地理标记器处理器可使用感兴趣区域（也称为 Geofence）的名称丰富事件记录，事件记录几何与地理围栏之间存在特定的空间关系。 该处理器的独特之处在于其可执行事件丰富和空间过滤。 例如，可配置地理标记器处理器以追加任何 Geofence（在其中可找到事件记录几何）的名称。 由地理标记器处理器处理的事件记录将追加一个含有任何 Geofence（在其中可找到事件记录几何）名称的字段。
示例
- 地理标记器处理器可用于实时记录停车执法官员在哪些城市街区巡逻。 官员轮班过程中在不同城市街区进行巡逻的情况下，可以保存有关哪位官员访问过哪些街区的记录。
- 处理器可用于对影响宗地的活动野火名称进行地理标记。 随着野火表面积的增长，可以用当前正在影响该宗地的野火名称进行地理标记。
- 该处理器可用于监视飓风对所波及的各县的影响。 当飓风与各县相交时，可以通过受影响的、已进行地理标记的县列表来丰富飓风事件记录。
用法说明
- 在配置地理标记器处理器之前必须将 Geofence 从要素服务导入至 GeoEvent Server。 有关在 GeoEvent Server 中处理 GeoFence 的详细信息，请参阅管理 GeoFence。
- 配置地理标记器处理器时，请选择一个空间运算符来指定满足条件的关系，以便处理器对事件记录进行标记。 例如，您可能希望使用与事件记录面相交的任何 Geofence 名称来标记 GeoEvent，从而实现对事件记录的丰富。
- 处理器将为所接收到的每个事件记录发出一个事件记录。 当事件记录的几何满足处理器正在评估的空间关系时，相关 Geofence 的名称将写入指定的目标字段。 如果事件记录的几何不满足处理器正在评估的任何已识别 Geofence 的空间关系，则会将空值追加到 GeoTag 字段值。
- 地理标记器处理器支持各种空间运算符，其中包括：包含、交叉、不相交、进入、等于、退出、内部、相交、外部、重叠、接触和位于。 空间运算符假定，任何能够满足运算符的已定义空间关系且被考虑在内的 Geofence 足可触发地理标记器处理器来丰富正被处理的 GeoEvent。 例如，如果使用相交空间运算符并考虑对不重叠感兴趣区域建模的几十个 Geofence，则区域与 GeoEvent 几何相交的所有 Geofence 名称将被添加到处理的 GeoEvent 中。
- 当指定包含事件数据几何的字段的名称时，地理标记器处理器将接受字段的名称或应用到 GeoEvent 定义中的某个字段的标签（通常为 GEOMETRY 标签）。
- 地理标记器需要通过 GeoEvent Server 创建一个新的 GeoEvent 定义来更改事件记录方案。 新的 GeoEvent 定义将由 GeoEvent Server 管理，并且如果处理器或者使用该处理器的 GeoEvent 服务发生改变，则该定义将被删除。
- 处理器提供了三种用于格式化已丰富值的选项。 分隔值表示应以简单的逗号分隔的列表形式写入 Geofence 名称。 其他两个值（组和列表）将已丰富值的格式规定为 JSON 组或 JSON 列表内的元素。
- 几何字段参数将显示具有几何类型的所有 GeoEvent 定义中每个字段的名称。 按名称选择几何字段时，请选择与事件数据的 GeoEvent 定义相对应的几何字段的名称。
参数
| 参数 | 描述 |
|---|---|
| 名称 | 用于在 GeoEvent Manager 中引用的处理器的描述性名称。 |
| 处理器 | 所选处理器的名称。 |
| Geofence | GeoEvent Server 中的 Geofence 的类别和名称。 将评估 Geofence 以了解其与入站事件数据之间的空间关系。 所需格式为类别/名称，指定为一对正则表达式模式。 例如：
注：类别和名称均使用正则表达式。 例如，Weather/.* 用于包含 Weather 类别中的所有 Geofence 以进行地理标记。 表达式 .*/.* 用于评估所有注册到 GeoEvent Server 的 Geofence，无论类别或名称如何。 请注意，正则表达式模式匹配区分大小写。 |
| 空间运算符 | 用于进行地理标记的空间运算符。 空间运算符定义如何在空间上评估 Geofence 与事件数据的关系。 默认值为包含。 可用的空间运算符包括：
|
| 几何字段 | 入站事件数据中几何字段或 GEOMETRY 标记字段的名称。 处理器使用事件数据的几何来评估与 Geofence 的空间关系以进行地理标记。 |
| 目标字段 | 要写入地理标记值的目标字段。 默认为现有字段。
注：当处理器配置为写入新字段时，写入指定字段的数据可以格式化为分隔值或 JSON 组或 JSON 列表。 当配置为写入现有字段时，满足处理器正在评估的空间关系的 Geofence 名称将作为分隔文本追加到现有字段的值。 写入现有字段时，不支持使用格式为 JSON 组或 JSON 列表的 Geofence 名称来丰富已处理事件记录的选项。 |
| 地理标记字段名称 （条件分析） | 用于存储经过地理标记的值的新字段名称。 此属性在目标字段设置为新字段时显示，设置为现有字段时隐藏。 |
| 地理标记格式 （条件分析） | GeoTag 字段中经过地理标记的值的格式。 可以将经过地理标记的值格式化为逗号分隔的列表、JSON 组或 JSON 列表。 默认值为分隔值。
此属性在目标字段设置为新字段时显示，设置为现有字段时隐藏。 |
| 新建 GeoEvent 定义名称 （条件分析） | 分配给新 GeoEvent 定义的名称。 新 GeoEvent 定义将组合入站事件记录的方案和包含经过地理标记的值的新 GeoTag 字段。 此属性在目标字段设置为新字段时显示，设置为现有字段时隐藏。 |
| 现有字段名称 （条件分析） | 用于存储地理标记值的事件记录中现有字段的名称。 现有字段必须是字符串才能接收经过地理标记的值。 注：可以使用定义菜单来标识入站事件数据的 GeoEvent 定义。 选择 GeoEvent 定义将缩小可供选择的字段的范围。 可以使用字段菜单来标识经过地理标记的值的现有字段的特定名称。 此属性在目标字段设置为现有字段时显示，设置为新字段时隐藏。 |
| 在地理标记中包括 Geofence 类别 | 指定是否在经过地理标记的值中包括 Geofence 类别。 默认为是。
|
注意事项和限制
- 常常将 Geofence 视为对感兴趣区域建模，这表示 Geofence 始终为面几何。 正如受支持的空间运算符列表表明，Geofence 也可以是点几何或折线几何。 可以对与事件记录相关的面几何进行测试，以判断该几何是否与几何为点或折线的 Geofence 存在相交、交叉或包含关系。
- 设置空间运算符参数时考虑 Geofence 的几何和事件记录的几何。 根据所涉及的几何类型，某些空间运算符可能无效。 例如，如果事件记录是点而 Geofence 是面，则不能使用包含空间运算符。 点不能包含面。 有关空间关系的详细信息，请参阅空间过滤器。