ArcGIS Velocity 中的“HTTP 轮询器”数据源会将 HTTP 请求发送到指定的 URL。 由此获取在 web 浏览器中通过浏览至同一 URL 即可检索到的数据。
示例
一位 GIS 分析师希望将存储在 Web 服务器上 .csv 文件中的区域面加载到 Velocity。
用法说明
- 必须可以通过 Internet 从外部访问 HTTP 端点。
- 要轮询的 HTTP 相应或文件大小不能超过 16 MB。 如果要轮询的数据或文件超过 16 MB，则不会提取要素。
- 配置源连接参数后，需要配置输入数据以定义方案和关键参数。
- 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>>）。
参数
| 参数 | 描述 | 数据类型 |
|---|---|---|
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 全局变量。 | 键值对 |
注意事项和限制
- 必须可以通过 Internet 从外部访问 HTTP 端点。
- 在使用 OAuth 创作源时，请注意以下内容：
- 在创作过程中会发生对授权服务器和关联的数据端点的多次请求。 一些 API 对某些请求实施限速，这可能会影响源的创作。
- 出于安全原因，在编辑身份验证参数时，必须重新配置访问令牌 POST 主体。