“在 REST 端点接收 GeoJSON”输入连接器可用于在由 ArcGIS GeoEvent Server 托管的 REST 端点上接收和改编格式为 GeoJSON 的事件数据。 给定一个标准 GeoEvent Server 配置时,数据提供商应期望通过 HTTP/POST 将数据发送到格式为 https://<machine_name>.<domain>:6143/geoevent/rest/receiver/name 的端点,其中 name 是已配置的输入连接器的名称。
想要发送多个数据记录的客户端应将这些数据记录组织为 FeatureCollection,如下图所示。 GeoJSON 入站适配器将 FeatureCollection 中的每个要素记录作为单独的事件数据记录进行处理。 将对以下说明的 GeoJSON 进行改编以针对要处理的 GeoEvent 服务生成两个事件数据记录。
有关 GeoJSON 数据记录格式示例的详细信息,请参阅 GeoJSON 规范。
用法说明
使用“在 REST 端点接收 GeoJSON”输入连接器时,应记住以下事项:
- 使用此输入连接器接收使用 HTTP/POST 发送到 GeoEvent Server 托管的 REST 端点的格式为 GeoJSON 的数据。
- 此输入连接器将 GeoJSON 入站适配器与 HTTP 入站传输进行配对。
- 典型的 GeoJSON FeatureCollection 如上图所示。 此示例中的集合具有两个 GeoJSON 要素记录。
- 适配器将处理单个 GeoJSON 要素记录和 GeoJSON FeatureCollection 记录。
- 和要素 JSON 一样,GeoJSON 是通用 JSON 的子类型。 用于处理这些特定格式的 GeoEvent Server 适配器不同。
- 有关 GeoJSON 数据记录格式的详细信息和示例,请参阅 GeoJSON 规范。
- 配置并保存一个新的“在 REST 端点接收 GeoJSON”输入连接器会创建一个 GeoEvent Server 托管的 REST 端点。
- 通过在保存输入后对其进行编辑,可以恢复 GeoEvent Server 托管 REST 端点的完全限定路径。
- 可以将 GeoEvent Server 配置为对其 REST 接收器应用不同的基本 URL 和通过 6143 以外的端口进行连接。
- 数据提供商必须在其 HTTP/POST 的标头中包含与正在发送的数据关联的 MIME 类型。
- 您配置的输入应指定传输将接受的 MIME 类型。
- 此输入连接器期望的 MIME 类型为 application/json,这是客户端和服务器之间 JSON 交换的默认 MIME 类型。
- 有效的 GeoJSON 要素记录包括几何和属性。 此连接器无法根据接收为属性值的坐标构建几何。 所有 GeoJSON 要素记录使用 World Geodetic System 1984 (WGS84) 基准面,坐标值的经度和纬度单位为十进制度。 使用此连接器时,请勿指定默认空间参考。
参数
以下是“在 REST 端点接收 GeoJSON”输入连接器的参数:
参数 | 描述 |
---|---|
名称 | 用于在 GeoEvent Manager 中引用的输入连接器的描述性名称。 |
创建 GeoEvent 定义 | 指定是否应将新的或现有的 GeoEvent 定义用于入站事件数据。 GeoEvent Server 需要 GeoEvent 定义,以了解入站事件数据属性字段和数据类型。
|
GeoEvent 定义名称(新) (条件分析) | 分配给新 GeoEvent 定义的名称。 如果已存在具有指定名称的 GeoEvent 定义,则会使用现有的 GeoEvent 定义。 收到的第一个数据记录将用于确定后续数据记录的预期方案,将根据第一个数据记录的方案创建新的 GeoEvent 定义。 此参数在创建 GeoEvent 定义设置为是时显示,设置为否时隐藏。 |
GeoEvent 定义名称(现有) (条件分析) | 在调整接收数据以创建事件数据以供 GeoEvent 服务处理时使用的现有 GeoEvent 定义的名称。 此参数在创建 GeoEvent 定义设置为否时显示,设置为是时隐藏。 |
默认空间参考 | 空间参考系统的熟知 ID (WKID) 或熟知文本 (WKT),其中表示的是几何的坐标。 此参数没有默认值。 |
可接受的 MIME 类型(服务器模式) | 指定输入连接器将接受的 MIME 类型。 使用逗号分隔值,例如 text/plain,application/xml,text/xml。 MIME 类型通常由类型/子类型结构组成,当服务器必须指定从客户端接受的数据的 Internet 媒体类型时,可使用 MIME 类型。 默认值是 application/json,这是在客户端和服务器之间交换 JSON 时的官方 MIME 类型。 有关官方 MIME 类型的详细信息,请参阅互联网地址编码分配机构 (IANA)。 有关 ArcGIS Server 未使用的 MIME 类型的详细信息,请参阅 ArcGIS Server 未使用的 MIME 类型。 |
预期日期格式 | 该模式用于匹配日期/时间值的预期字符串表示形式,并将它们转换为 Java 日期值。 模式的格式遵循 Java SimpleDateFormat 类约定。 而 GeoEvent Server 更偏好以 ISO 8601 标准表示的日期/时间值,通常被识别为日期值的日期/时间值的多个字符串表示可以转换为 Java 日期值,且无需指定预期日期格式模式。 其中包括:
如果收到的日期/时间值使用并非上述五种之一的约定表示,则必须指定一个预期日期格式模式以便 GeoEvent Server 了解如何调整日期/时间值。 |
原始数据的参数名称 | 查询参数的名称,该参数的值为入站 HTTP GET 请求提供原始数据。 查询参数的值应该是格式化为 GeoJSON 要素或 GeoJSON FeatureCollection 的单个字符串。 |