GeohashRecord

文档中心 › 组件索引 › GeohashRecord

GeohashRecord Processor

类型全限定名:cn.org.acal.lynxus.processors.geohash.GeohashRecord

所属 Bundle:cn.org.acal.lynxus:lynxus-geohash-nar:2.11.8

已废弃: LYNXUS-14846: 自初始实现以来使用量少且维护有限

描述

一种基于记录的处理器,可对纬度/经度坐标中的 Geohashes 进行编码和解码。

标签

geogeohashrecord

属性

下表中,加粗的属性为必填项;其余为可选项。表格同时标注默认值、是否支持表达式语言,以及是否为敏感属性(值会被加密)。

名称默认值可选值描述
ModeENCODE
  • ENCODE
  • DECODE
指定是将纬度/经度编码为 geohash 还是将 geohash 解码为纬度/经度
Record Reader控制器服务 API:
RecordReaderFactory
cn.org.acal.lynxus-lynxus-standard-services-api-nar-2.11.8
指定用于读取传入数据的Record Reader服务
Record Writer控制器服务 API:
RecordSetWriterFactory
cn.org.acal.lynxus-lynxus-standard-services-api-nar-2.11.8
指定用于写入数据的Record Writer服务
Routing StrategySKIP
  • SKIP
  • SPLIT
  • REQUIRE
指定编码或解码执行后如何路由 FlowFile。SKIP 将丰富可以丰富的记录并跳过其余记录。SKIP 策略仅在无法解析数据时将 FlowFile 路由到 failure。否则,它将将丰富的 FlowFile 路由到 success,原始输入路由到 original。SPLIT 将已丰富的记录与未丰富的记录分开,发送到 matched,未丰富的记录发送到 unmatched;原始输入 FlowFile 发送到 original。SPLIT 策略仅在无法解析数据时将 FlowFile 路由到 failure。REQUIRE 仅在所有记录都被丰富时才将 FlowFile 路由到 success,原始输入发送到 original。如果任何记录无法丰富或无法解析,REQUIRE 策略将原始输入 FlowFile 路由到 failure
纬度记录路径在 ENCODE 模式下,此属性指定获取纬度值的记录路径。纬度值应在 [-90, 90] 范围内;无效值将以警告级别记录。在 DECODE 模式下,此属性指定放置纬度值的记录路径
支持表达式语言:是(使用 FlowFile 属性与环境/系统变量求值)
经度记录路径在 ENCODE 模式下,此属性指定获取经度值的记录路径;经度值应在 [-180, 180] 范围内;无效值将以警告级别记录。在 DECODE 模式下,此属性指定放置经度值的记录路径
支持表达式语言:是(使用 FlowFile 属性与环境/系统变量求值)
Geohash 记录路径在 ENCODE 模式下,此属性指定放置 geohash 值的记录路径;在 DECODE 模式下,此属性指定获取 geohash 值的记录路径
支持表达式语言:是(使用 FlowFile 属性与环境/系统变量求值)
Geohash 格式BASE32
  • BASE32
  • BINARY
  • LONG
在 ENCODE 模式下,此属性指定编码 geohash 的所需格式;在 DECODE 模式下,此属性指定提供的 geohash 格式
Geohash Level编码 geohash 所需的整数精度级别(1-12)
支持表达式语言:是(使用 FlowFile 属性与环境/系统变量求值)

关系 (Relationships)

名称描述自动终止
failure无法编码或解码的FlowFile将被路由至失败否
original原始输入FlowFile将被发送到该关系否
success成功编码或解码的FlowFile将被路由到成功否

写入的 FlowFile 属性

名称描述
mime.type记录编写者指示的 MIME 类型
record.count生成的FlowFile中的记录数

状态管理

该组件不存储状态。

受限 (Restricted)

该组件不受限。

输入要求

该组件要求有传入连接。

详细说明

GeohashRecord

概述

Geohash 值对应具有预定义粒度的特定区域,广泛用于标识、表示和 索引地理空间对象。GeohashRecord Processor 提供了以所需格式和 精度对 Geohash 进行编码和解码的能力。

支持的格式

  • BASE32: 最常用的字母数字版本。它更紧凑、更易读,因为舍弃了 一些可能引起混淆的字母(例如 "a" 和 "o"、"i" 和 "l")。
  • BINARY: 该格式通过直接交织纬度和经度的二进制串生成。二进制串 中的偶数位对应经度,奇数位对应纬度。
  • LONG: 虽然这种 64 位数字格式不易于人类阅读,但计算速度非常快, 也更高效。

支持的精度

在 ENCODE 模式下,用户指定期望的精度级别,应为 1 到 12 之间的整数。级别越高,生成的 Geohash 越长,精度也越高。

在 DECODE 模式下,不需要用户提供精度级别,因为这个信息包含在 给定 Geohash 值的长度中。