“在 REST 端点接收 GeoJSON”输入连接器可用于在由 ArcGIS GeoEvent Server 托管的 REST 端点上接收和改编格式为 GeoJSON 的事件数据。给定一个标准 GeoEvent Server 配置时，数据提供商应期望通过 HTTP/POST 将数据发送到格式化为 https://<machine_name>.<domain>:6143/geoevent/rest/receiver/name 的端点，其中名称为配置的输入连接器的名称。
想要发送多个数据记录的客户端应将这些数据记录组织为 FeatureCollection，如下图所示。GeoJSON 入站适配器将 FeatureCollection 中的每个要素记录作为单独的事件数据记录进行处理。将对以下说明的 GeoJSON 进行改编以针对要处理的 GeoEvent 服务生成两个事件数据记录。
有关 GeoJSON 数据记录格式示例的详细信息，请参阅 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 (WGS 84) 基准面以十进制度表示经度和纬度单位。不要在使用此连接器时指定默认空间参考。
参数
| 参数 | 说明 |
|---|---|
名称 | 用于在 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 媒体类型时使用。默认值是 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 的单个字符串。 |