ArcGIS Velocity 中的“HTTP 轮询器”数据源会将 HTTP 请求发送到指定的 URL。 由此获取在 web 浏览器中通过浏览至同一 URL 即可检索到的数据。
示例
一位 GIS 分析师希望将存储在 Web 服务器上 .csv 文件中的区域面加载到 Velocity。
用法说明
使用 HTTP 轮询器数据源时，请谨记以下信息：
- 配置源连接参数后，需要配置输入数据以定义方案和关键参数。
- URL 参数和自定义标题参数均支持分析全局变量，用于计划循环大数据分析。 默认情况下，这些全局变量将转换为新纪元时间（自 1970 年 1 月 1 日 (UTC) 以来的毫秒数）。 下面是可用分析变量及其表示的时间。
- $analytic.AnalyticLastScheduledStartTime - 计划开始最后一次运行分析的时间。
- $analytic.AnalyticScheduledStartTime - 计划开始当前运行分析的时间。
- $analytic.AnalyticLastEndTime - 结束最后一次运行分析的时间。
- $analytic.AnalyticStartTime - 当前分析运行的开始时间。 此时间与 $analytic.AnalyticScheduledStartTime 之间的差值为启动延迟。
- 如果使用 OAuth 身份验证，则以下内容适用：
- HTTP 轮询器源支持使用 OAuth 2.0 进行遵循客户端凭据或密码授予类型的 HTTP 端点的身份验证。 这些 OAuth 授权类型遵循的方案包括配置 HTTP 请求以获取访问令牌。 这些数据请求是通常配置为任何 HTTP 轮询器源类型的一部分的数据请求的补充。
- 在配置访问令牌请求期间，系统将提示您从 OAuth 授权服务器的响应中识别访问令牌。
- 当返回数据请求的配置时，必须使用 $accessToken 全局变量来定义将使用访问令牌的位置。 这通常是在带有值 Bearer $accessToken 的 Authorization 自定义标题中。 $accessToken 也可用于 POST 正文、URL 参数以及 URL（例如，https://<<company.domain>>/$accessToken/<<method>>?<<url params>>）。
参数
下面是 HTTP 轮询器源的参数：
| 参数 | 描述 | 数据类型 |
|---|---|---|
URL | 外部可访问 HTTP 端点的完整 URL。 此参数支持 $accessToken 全局变量。 | 字符串 |
HTTP 方法 | 指定用于 HTTP 端点的 HTTP 方法，即 GET 或 POST。 如果选择 POST，则可以指定消息正文。 | 字符串 |
POST 正文 | 发送 POST HTTP 请求时要包含的消息正文。 由此可在 x-www-form-urlencoded 与其他通用文本内容类型之间提供选择。 它还用于设置 Content-type 标题。 仅当 HTTP 方法参数设置为 POST 时，此参数才适用。 此参数支持分析和 $accessToken 全局变量。 | 字符串 |
身份验证 | 指定用于访问 HTTP 端点的身份验证的类型。 这些选项包括无、基础、证书和 OAuth。 | 字符串 |
用户名 | 用于访问 HTTP 端点的用户名。 仅当身份验证参数设置为基础时应用此参数。 | 字符串 |
密码 | 用于访问 HTTP 端点的密码。 仅当身份验证参数设置为基础时应用此参数。 | 密码 |
证书 URL | 用于访问 HTTP 端点的客户端证书的 URL 位置。 仅当身份验证参数设置为证书时应用此参数。 | 字符串 |
密码 | 客户端证书密码（如果已设置）。 仅当身份验证参数设置为证书时应用此参数。 | 密码 |
自定义标题 | 发送到指定 HTTP 端点的 HTTP 请求中将包含可选的自定义标题。 例如，自定义标题可用于指定第三方 API 密钥或身份验证标题。 此参数支持分析和 $accessToken 全局变量。 | 键值对 |
URL 参数 | 要包含在发送到指定 HTTP 端点的 HTTP 请求 URL 中的可选 URL 参数。 虽然也可以在 URL 参数中设置参数，但是在此处输入的 URL 参数将覆盖为 URL 参数提供的任何匹配参数。 在此处定义的参数将始终使用 URL 编码。 此参数支持分析和 $accessToken 全局变量。 | 键值对 |
注意事项和限制
下面是在使用 HTTP 轮询器源时的注意事项和限制：
- 必须可以通过 Internet 从外部访问 HTTP 端点。
- 要轮询的 HTTP 相应或文件大小不能超过 16 MB。 如果要轮询的数据或文件超过 16 MB，则不会消耗要素。
- 使用 OAuth 身份验证时，以下内容适用：
- 在创作过程中会发生对授权服务器和关联的数据端点的多次请求。 一些 API 对某些请求实施限速，这可能会影响源的创作。
- 出于安全原因，在编辑身份验证参数时，必须重新配置访问令牌 POST 正文。