“轮询外部网站以查找 GeoJSON”输入连接器可用于从外部网站检索和改编格式为 GeoJSON 的事件数据。 有关 GeoJSON 数据记录格式的详细信息和示例,请参阅 GeoJSON 规范。
当从 Web 服务器或 Web 服务返回多个事件数据记录时,应将其组织为 FeatureCollection,如下图所示。 GeoJSON 入站适配器将 FeatureCollection 中的每个要素记录作为单独的事件数据记录进行处理。
用法说明
使用“轮询外部网站以查找 GeoJSON”输入连接器时,应记住以下事项:
- 使用此输入连接器在 web 服务器或 web 服务中查询格式为 GeoJSON 的数据,并对其进行改编以创建可供处理的事件记录。
- 此输入连接器将 GeoJSON 入站适配器与 HTTP 入站传输进行配对。
- GeoJSON 要素记录应同时包含几何和属性成员。
- 组织为 GeoJSON FeatureCollection 的一部分的典型事件记录如上图所示。
- 适配器将管理单个 GeoJSON 要素记录和 GeoJSON FeatureCollection 记录。
- 和要素 JSON 一样,GeoJSON 是通用 JSON 的子类型。 将使用多种 GeoEvent Server 适配器处理这些特定格式。
- 有关 GeoJSON 数据记录格式的详细信息和示例,请参阅 GeoJSON 规范。
- 适配器不支持根据字段构建几何功能。
- HTTP 方法参数指定用于在 Web 服务中查询数据的 HTTP 请求的类型。 默认使用 HTTP/GET 请求。
- 可以使用参数参数指定查询参数,以帮助选择感兴趣的数据。
- 将查询参数指定为 HTTP/GET 请求的一部分,从而通过缩小返回的项目数来提高性能。
- 任何指定查询参数的名称和值取决于外部 Web 服务支持的请求。
- 此输入连接器假设外部 web 服务器或 web 服务将接受 HTTP/GET 请求而无需身份验证。 对于需要身份验证的外部网站,请考虑创建自定义输入连接器,该连接器需要将通用 JSON 入站适配器与支持基本、证书或 OAuth 身份验证的 HTTP 入站传输进行配对。
- 仅接收新数据参数用于向源请求仅返回先前未发现的或新更新的数据。 此功能取决于正确将“最后修改时间”合并到其对 HTTP 请求的响应的标头中的数据源。 如果响应标头未指示最后更新内容的日期或时间,GeoEvent Server 将假定响应中的数据表示新数据或最近更新的数据。 您可以在 RFC 7232 HTTP 规范中查看有关响应标头中“最后修改时间”使用的详细信息。
参数
以下是“轮询外部网站以查找 GeoJSON”输入连接器的参数:
参数 | 描述 |
---|---|
名称 | 用于在 GeoEvent Manager 中引用的输入连接器的描述性名称。 |
URL | 将数据托管为 GeoJSON 的外部网站的基本 URL。 GeoEvent Server 将向该 URL 发出轮询请求以检索 GeoJSON 数据。 |
创建 GeoEvent 定义 | 指定是否应将新的或现有的 GeoEvent 定义用于入站事件数据。 GeoEvent Server 需要 GeoEvent 定义,以了解入站事件数据属性字段和数据类型。
|
GeoEvent 定义名称(新) (条件分析) | 分配给新 GeoEvent 定义的名称。 如果已存在具有指定名称的 GeoEvent 定义,则会使用现有的 GeoEvent 定义。 收到的第一个数据记录将用于确定后续数据记录的预期方案,将根据第一个数据记录的方案创建新的 GeoEvent 定义。 此参数在创建 GeoEvent 定义设置为是时显示,设置为否时隐藏。 |
GeoEvent 定义名称(现有) (条件分析) | 在调整接收数据以创建事件数据以供 GeoEvent 服务处理时使用的现有 GeoEvent 定义的名称。 此参数在创建 GeoEvent 定义设置为否时显示,设置为是时隐藏。 |
HTTP 方法 | 轮询提供数据源的外部服务器时要使用的 HTTP 请求方法 GeoEvent Server。 默认使用 HTTP/GET 请求。
|
提交自 提交正文 提交正文 MIME 类型 提交参数 (条件分析) | 默认情况下,HTTP 方法设置为 GET 时,这些参数是隐藏的。 有关详细信息,请参阅下文的限制部分。 |
默认空间参考 | 空间参考系统的熟知 ID (WKID) 或熟知文本 (WKT),其中表示的是几何的坐标。 此参数没有默认值。 此参数已被弃用。 GeoJSON 规范指出所有坐标都使用世界大地测量系统 1984 (WGS 1984) 数据在地理坐标参考系中表示,经度和纬度单位为十进制度。 |
仅接收新数据 | 指定适配器是否在数据源响应的标头中查找最近修改值,并尝试使用此值来避免处理已接收且未更新的数据。 此参数的名称可能具有误导性。 传输将始终接收数据源在其对连接器查询的响应中包含的任何数据。 但是,指定仅接收新数据时,传输将缓存其上次请求的日期/时间,并且仅在来自数据源的响应包含的最近修改值大于传输的缓存值时才会将收到的数据转发到适配器。 指定最近修改值为可选功能。 实际上,没有多少数据源在其响应中包含该值。 此参数的默认值为是,但是如果未找到最近修改值,则此参数会被忽略,因为确定响应中的数据是新数据还是更新数据所需的日期/时间不可用。
有关在响应标头中使用最近修改的详细信息,请参阅 RFC 7232 HTTP 规范。 |
频率(以秒为单位) | 轮询外部 Web 服务器或 Web 服务以获取数据的间隔(以秒为单位)。 默认为 10 秒(每 10 秒进行一次轮询请求)。 |
头文件参数名称: 值列表 | 轮询外部 Web 服务器或 Web 服务时要包含在请求的 HTTP 标头中的参数。 应使用名称:以逗号分隔的值对(包括冒号)指定标头参数。 |
参数 | 指定一个或多个要追加到基本 URL 的查询参数。 查询参数特定于每个 Web 服务,不受所有服务支持。 支持时,查询参数有助于指定特别感兴趣的数据。 此参数没有默认值。 查询参数通常包含在 URL 参数中。 |
使用 URL 代理 | 指定 GeoEvent Server 是否在发出 HTTP 请求时使用 URL 代理。 默认为否。
|
URL 代理 (条件分析) | 发出 HTTP 请求时使用的 URL 代理。 此参数在使用 URL 代理设置为是时显示,设置为否时隐藏。 |
预期日期格式 | 该模式用于匹配日期/时间值的预期字符串表示形式,并将它们转换为 Java 日期值。 模式的格式遵循 Java SimpleDateFormat 类约定。 而 GeoEvent Server 更偏好以 ISO 8601 标准表示的日期/时间值,通常被识别为日期值的日期/时间值的多个字符串表示可以转换为 Java 日期值,且无需指定预期日期格式模式。 其中包括:
如果收到的日期/时间值使用并非上述五种之一的约定表示,则必须指定一个预期日期格式模式以便 GeoEvent Server 了解如何调整日期/时间值。 |
可接受的 MIME 类型(客户端模式) (条件分析) | 指定此连接器在接收其对数据源的查询的响应时将接受的 MIME 类型。 外部 Web 服务的响应指定发送到 GeoEvent Server 的任何数据的实际 MIME 类型。 此连接器解析以下 MIME 类型,这些类型是此参数的默认值: text/json,application/json 有关官方 MIME 类型的详细信息,请参阅互联网地址编码分配机构 (IANA)。 有关 ArcGIS Server 未使用的 MIME 类型的详细信息,请参阅 ArcGIS Server 未使用的 MIME 类型。 此参数在 HTTP 方法设置为 Get 时显示,设置为 Post 或 Put 时隐藏。 |
HTTP 超时(秒) | 指定输入连接器等待来自其查询的外部 Web 服务的响应的最长时间(以秒为单位)。 该值必须是介于 1 到 2147483 之间的整数。 默认值为 30 秒(如果没有收到响应,HTTP 请求将在 30 秒后超时)。 |
注意事项和限制
始终使用 HTTP/GET 请求(不包含内容正文)轮询输入,并且使用查询参数指定感兴趣的数据。 以下参数仅适用于将数据发送到外部 Web 服务器或 Web 服务的输出连接器。 确保将 HTTP 方法参数设置为 HTTP/GET(默认值),以使下方参数保持隐藏状态。
参数 | 描述 |
---|---|
提交自 (条件分析) | 指定此连接器是使用 HTTP/POST 还是 HTTP/PUT 请求。
此参数在 HTTP 方法设置为 Post 或 Put 时显示,设置为 Get 时隐藏。 |
提交正文 (条件分析) | 指定要包含在 HTTP/POST 或 HTTP/PUT 请求的内容正文中的数据。 此参数在提交自设置为内容正文时显示,设置为参数时隐藏。 |
提交正文 MIME 类型 (条件分析) | 指定 HTTP 请求的内容正文中包含的 MIME 数据类型。 MIME 类型通常由类型/子类型结构组成,用于指定 HTTP 客户端/服务器使用和接受的 Internet 媒体类型。 此参数在提交自设置为内容正文时显示,设置为参数时隐藏。 |
提交参数 (条件分析) | 指定要包含在 HTTP 请求中的参数。 应使用名称:以逗号分隔的值对(包括冒号)指定参数。 此参数没有默认值。 此参数在提交自设置为参数时显示,设置为内容正文时隐藏。 |