添加 XYZ 值处理器

汇总

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

示例

• 应用程序可能需要将事件记录的位置表示为单独的坐标，而非要素 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 定义的方案。

参数

参数	描述
名称	用于在 GeoEvent Manager 中引用的处理器的描述性名称。
处理器	所选处理器的名称。
几何字段	几何字段或者处理器将用于从中提取 X、Y 和 Z 坐标值的事件记录的 GEOMETRY 已标记字段的名称。指定的几何字段必须为点几何。
输出 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 定义。
• 处理器不会从其他几何类型（如多点、包络、折线和面）中获取坐标值数组。仅支持提取点几何的坐标值。