“订阅外部 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 定义设置为否时显示，设置为是时隐藏。 |
默认空间参考 | 空间参考系统的熟知 ID (WKID) 或熟知文本 (WKT)，其中表示的是几何的坐标。 此参数没有默认值。 此参数已被弃用。 GeoJSON 规范指出所有坐标都使用世界大地测量系统 1984 (WGS 1984) 数据在地理坐标参考系中表示，经度和纬度单位为十进制度。 |
预期日期格式 | 该模式用于匹配日期/时间值的预期字符串表示形式，并将它们转换为 Java 日期值。 模式的格式遵循 Java SimpleDateFormat 类约定。 而 GeoEvent Server 更偏好以 ISO 8601 标准表示的日期/时间值，通常被识别为日期值的日期/时间值的多个字符串表示可以转换为 Java 日期值，且无需指定预期日期格式模式。 其中包括：
如果收到的日期/时间值使用并非上述五种之一的约定表示，则必须指定一个预期日期格式模式以便 GeoEvent Server 了解如何调整日期/时间值。 |