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