添加 XYZ 值处理器

添加 XYZ 值处理器用于从 GeoEvent 的点几何获取 X、Y 和 Z 坐标。 坐标值将作为新 GeoEvent 定义中的唯一字段追加。

示例

以下是添加 XYZ 值处理器的用例：

• 应用程序可能需要将事件记录的位置表示为单独的坐标，而非要素 JSON、GeoJSON 或通用 JSON 的几何表示。
• 此处理器可用于从要素 JSON（例如，来自要素服务的要素的点几何）中提取坐标。
• 此处理器提取的 X、Y 和 Z 值可用作方位角计算器处理器的输入起点或目的地。

用法说明

使用添加 XYZ 值处理器时，请记住以下事项：

• 该处理器仅支持从表示为要素 JSON 的点几何中提取坐标值。 因此，该处理器最好与从轮询 ArcGIS Server 以获取要素或在 REST 端点接收要素输入连接器导入的事件数据配对。
• 发送到处理器的事件记录必须具有包含点几何的 GeoEvent 定义。 几何值用于为每个事件记录派生 X、Y 和 Z 坐标值。
• X、Y 和 Z 字段的默认名称值分别为 x、y 和 z，可对这些值进行更改。 例如，X 字段参数可指定为经度，Y 字段参数可指定为纬度，Z 字段参数可指定为海拔高度或高度。
• X 字段、Y 字段和 Z 字段参数均为必需参数。 可以将此处理器与字段映射器处理器或字段缩减器处理器配对以修改处理器创建的输出 GeoEvent 定义的方案。

参数

以下是添加 XYZ 值处理器的参数：

参数	描述
名称	用于在 GeoEvent Manager 中引用的处理器的描述性名称。
处理器	指定所选的处理器。
几何字段	事件记录中的几何字段或具有 GEOMETRY 标记的字段的名称，处理器将从该字段中提取 X、Y 和 Z 坐标值。 指定的几何字段必须为点几何。
输出 GeoEvent 定义	指定由处理器创建的 GeoEvent 定义的名称。 创建的 GeoEvent 定义会将 X，Y 和 Z 坐标字段附加为新方案的一部分。
X 字段	存储 X 坐标值的字段名称。 该字段将添加到由处理器创建的新 GeoEvent 定义。 默认设置为 x。
Y 字段	存储 Y 坐标值的字段名称。 该字段将添加到由处理器创建的新 GeoEvent 定义。 默认设置为 y。
Z 字段	存储 Z 坐标值的字段名称。 该字段将添加到由处理器创建的新 GeoEvent 定义。 默认设置为 z。 注： 如果点几何没有 Z 坐标值，则系统会将默认值 0.0 添加到对应的字段。

注意事项和限制

使用添加 XYZ 值处理器时，需要牢记几点注意事项：

• 该处理器使用传入的 GeoEvent 定义上的几何字段或标签来标识点几何并获取 X、Y 和 Z 坐标值。 如果几何字段或标签不存在，则将需要创建几何字段或将 GEOMETRY 标签应用于现有字段，然后才能配置此处理器。 如果传入的几何字段名称为 geometry，或者 GEOMETRY 标签已使用，则此限制不适用。
• 由于添加了新字段，因此处理器将创建新 GeoEvent 定义。 通过添加新字段来更改事件记录的方案始终需要 GeoEvent Server 创建新的 GeoEvent 定义。
• 处理器不会从其他几何类型（如多点、包络、折线和面）中获取坐标值数组。 仅支持提取点几何的坐标值。