摘要
可以使用方位角计算器处理器通过将起点和目的地位置作为源来计算点事件记录的方位角。 处理器将作为新 GeoEvent 定义的一部分在新字段中返回方位角值。 从北向顺时针进行测量,将方位角指定为正双精度值,范围为 0 到 360。
示例
以下为方位角计算器处理器的用例:
- 获取移动车辆的方位角可以提供关于其方向或前进方向的见解,该方向或前进方向与诸如配送位置等静态目的地有关。
- 保持两个移动资产之间的方位角可以提供现场信息以进行实时追踪,例如已标记的动物救援。
- 从该处理器获得的方位角值可以用作扇形视域计算器处理器的输入。
用法说明
使用方位角计算器处理器时,请记住以下事项:
- “方位角计算器处理器”可以生成替代事件记录点几何的折线几何。 折线可表示起点和目的地之间的方位角线段或有效绘制线。
- 起点和目的地源必须来自相同 GeoEvent 定义中的属性字段。 处理器不支持使用多个输入来计算方位角值。
- 可以使用包含点要素的几何类型字段、包含表示为整数的 X 和 Y 坐标的单独字段或者两者的组合来定义起点和目的地源。 例如,起点可以为配送车辆当前点几何,而目的地可以为一家企业,其位置表示为与配送车辆相关联的相同事件记录的单独 X 和 Y 坐标字段。
- 方位角值作为以度为单位的整数返回。 值的范围为从 0 到 360 度,将方位角表示为从北方向顺时针测量的度数。 例如,原点以东的目的地将产生 90.0 度的方位角。 原点以南的目的地将产生 180.0 度的方位角。
- 有关构成起点和目的地源的有效点几何的详细信息,请参阅几何对象。
参数
以下为方位角计算器处理器的参数:
参数 | 描述 |
---|---|
名称 | 用于在 GeoEvent Manager 中引用的处理器的描述性名称。 |
处理器 |
指定所选的处理器。 |
源 GeoEvent 定义 | 用于指定入站事件记录的 GeoEvent 定义的名称。 GeoEvent 定义可用于标识包含起点和目的地位置的属性字段。 |
原点源 | 用于指定事件记录中起点值的源。 处理器将使用起点来计算方位角。 默认值为起点几何。
|
原点字段 (条件分析) | 包含起点位置的几何字段的名称。 起点几何必须为点。 此参数在起点源设置为起点几何时显示,设置为坐标时隐藏。 |
原点 X 字段 (条件分析) | 包含起点 X 坐标的整型字段的名称(例如,longitude)。 此参数在起点源设置为坐标时显示,设置为起点几何时隐藏。 |
原点 Y 字段 (条件分析) | 包含起点 Y 坐标的字段名称(例如,latitude)。 此参数在起点源设置为坐标时显示,设置为起点几何时隐藏。 |
目标源 | 用于指定事件记录中目的地值的源。 处理器将使用目的地来计算方位角。 默认值为目的地几何。
|
目标字段 (条件分析) | 包含目的地位置的几何字段的名称。 目的地几何必须为点。 此参数在目的地源设置为目的地几何时显示,设置为坐标时隐藏。 |
目标 X 字段 (条件分析) | 包含目的地 X 坐标的整型字段的名称(例如,longitude)。 此参数在目的地源设置为坐标时显示,设置为目的地几何时隐藏。 |
目标 Y 字段 (条件分析) | 包含目的地 Y 坐标的整型字段的名称(例如,latitude)。 此参数在目的地源设置为坐标时显示,设置为目的地几何时隐藏。 |
创建方位角线段 | 用于指定是否将事件记录的几何从点要素更改为表示方位角线段的折线要素。 方位角线段是在起点和目的地位置之间绘制的线。 默认为否。
|
输出方位角字段 | 用于存储方位角值的新字段的名称。 从北向顺时针进行测量,将方位角值指定为正双精度值,范围为 0.0 到 360.0。 |
输出 GeoEvent 定义 | 新的 GeoEvent 定义的名称。 新 GeoEvent 定义将对入站事件记录的方案和其他方位角字段进行组合。 |
注意事项和限制
“方位角计算器处理器”将仅从起点和目的地派生方位角,作为单个事件记录的一部分。 如果起点和目的地来自两个不同的源,请考虑使用事件连接器处理器或字段丰富器(要素服务)处理器来实时连接单个数据源以计算方位角。