Skip To Content

订阅外部 WebSocket 以获取 GeoJSON

“订阅外部 WebSocket 以获取 GeoJSON”输入连接器可用于接收和改编从外部服务器 WebSocket 广播的事件数据,其格式为 GeoJSON。 有关 GeoJSON 数据记录格式示例的详细信息,请参阅 GeoJSON 规范

此输入连接器将作为客户端运行,并且必须能够订阅服务器托管的 WebSocket。 如果您正在寻找作为服务器运行的输入连接器,并且允许客户端应用程序订阅数据并将数据发送到输入,请考虑使用在 WebSocket 上接收 GeoJSON

用法说明

使用“订阅外部 WebSocket 以获取 GeoJSON”输入连接器时,应记住以下事项:

  • 通过外部服务器托管的 WebSocket,可以使用此输入连接器来接收格式为 GeoJSON 的数据。
  • 此输入连接器将作为客户端运行,并订阅服务器的托管 WebSocket 来接收服务器广播的数据。
  • 此输入连接器可将 GeoJSON 入站适配器与 WebSocket 入站传输进行配对。
  • GeoJSON 要素记录应同时包含几何和属性成员。
  • 适配器可处理单个 GeoJSON 要素记录和 GeoJSON FeatureCollection 记录。
  • 要素 JSON 一样,GeoJSON 是通用 JSON 的子类型。 用于处理这些特定格式的 GeoEvent Server 适配器不同。
  • 有关 GeoJSON 数据记录格式的详细信息和示例,请参阅 GeoJSON 规范
  • 适配器不支持根据字段构建几何功能。
  • 此连接器支持 WebSocket (ws) 和 WebSocket Secure (wss) 协议。
  • 将数据发送到 WebSocket 端点的客户端必须使用 ws://<machine_name>.<domain>:6180/path
  • 将数据发送到 WebSocket Secure 端点的客户端必须使用 wss://<machine_name>.<domain>:6143/path

参数

以下是“订阅外部 WebSocket 以获取 GeoJSON”输入连接器的参数:

参数描述

名称

用于在 GeoEvent Manager 中引用的输入连接器的描述性名称。

远程服务器 WebSocket URI(客户端模式)

完整的 URL 端点,包括协议、主机名或 IP 地址、端口和路径。 默认值为 localhost。 更新此参数以反映服务器托管的 WebSocket 的 URI。

创建 GeoEvent 定义

指定是否应将新的或现有的 GeoEvent 定义用于入站事件数据。 GeoEvent Server 需要 GeoEvent 定义,以了解入站事件数据属性字段和数据类型。

  • - 将根据收到的第一个事件记录的模式创建新的 GeoEvent 定义。
  • - 不会创建新的 GeoEvent 定义。 选择与入站事件数据的方案匹配的现有 GeoEvent 定义。

GeoEvent 定义名称(新)

(条件分析)

分配给新 GeoEvent 定义的名称。 如果已存在具有指定名称的 GeoEvent 定义,则会使用现有的 GeoEvent 定义。 收到的第一个数据记录将用于确定后续数据记录的预期方案,将根据第一个数据记录的方案创建新的 GeoEvent 定义。

此参数在创建 GeoEvent 定义设置为时显示,设置为时隐藏。

GeoEvent 定义名称(现有)

(条件分析)

在调整接收数据以创建事件数据以供 GeoEvent 服务处理时使用的现有 GeoEvent 定义的名称。

此参数在创建 GeoEvent 定义设置为时显示,设置为时隐藏。

默认空间参考

空间参考系统的熟知 ID (WKID) 或熟知文本 (WKT),其中表示的是几何的坐标。 此参数没有默认值。

此参数已被弃用。 GeoJSON 规范指出所有坐标都使用世界大地测量系统 1984 (WGS 1984) 数据在地理坐标参考系中表示,经度和纬度单位为十进制度。

预期日期格式

该模式用于匹配日期/时间值的预期字符串表示形式,并将它们转换为 Java 日期值。 模式的格式遵循 Java SimpleDateFormat 类约定。

GeoEvent Server 更偏好以 ISO 8601 标准表示的日期/时间值,通常被识别为日期值的日期/时间值的多个字符串表示可以转换为 Java 日期值,且无需指定预期日期格式模式。 其中包括:

  • “2019-12-31T23:59:59”- ISO 8601 标准格式
  • 1577836799000 - Java 日期(时间长整型;UTC)
  • “Tue Dec 31 23:59:59 -0000 2019”- 常见的 web 服务字符串格式
  • “12/31/2019 11:59:59 PM”- 美国使用的通用格式(12 小时制)
  • “12/31/2019 23:59:59”- 美国使用的通用格式(24 小时制)

如果收到的日期/时间值使用并非上述五种之一的约定表示,则必须指定一个预期日期格式模式以便 GeoEvent Server 了解如何调整日期/时间值。


在本主题中
  1. 用法说明
  2. 参数