Skip To Content

在 REST 端点接收 GeoJSON

“在 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 规范

具有两个 GeoJSON 要素记录的 GeoJSON FeatureCollection

用法说明

使用“在 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 定义名称(现有)

(条件分析)

在调整接收数据以创建事件数据以供 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 日期值,且无需指定预期日期格式模式。 其中包括:

  • “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 了解如何调整日期/时间值。

原始数据的参数名称

查询参数的名称,该参数的值为入站 HTTP GET 请求提供原始数据。 查询参数的值应该是格式化为 GeoJSON 要素或 GeoJSON FeatureCollection 的单个字符串。


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