通用的工作流程不是使 IoT 系统请求外部数据,而是从组织的 IoT 基础设施中的设备推送数据。 一种方式是向 Web 服务器发出 HTTP POST 请求。 ArcGIS Velocity 中的 HTTP 接收器源将创建一个内置的 HTTP 端点,该端点可用于以编程方式将数据从 IoT 设备和应用程序通过 HTTP POST 请求发送到 Velocity。
示例
以下是 HTTP 接收器源的用例:
- 组织的设备已配置为使用 POST 请求将数据推送至指定的 Velocity HTTP 端点。
- GIS 分析师编写了一个 Python 脚本来处理要素并在每次脚本运行时,使用 POST 请求将数据推送至指定的 Velocity HTTP 端点。
用法说明
使用 HTTP 接收器源时,请谨记以下内容:
- 以纯文本形式发送 HTTP POST 请求。
- HTTP 接收器源由用户配置,包括方案和关键字段。 创建源后,可以在源详细信息页面上的 HTTP 端点路径下访问 URL。 此为可以使用 HTTP POST 请求推送数据的目标 URL。
- 将验证类型参数设置为 ArcGIS,使用开放授权 (OAuth) 2.0 身份验证。 每个传入消息都必须包含源所有者的有效令牌。 没有有效令牌的消息将被拒绝。
- 配置源连接参数后,请参阅配置输入数据了解如何定义方案和关键字段。
参数
以下是 HTTP 接收器源的参数:
参数 | 描述 | 数据类型 |
---|---|---|
HTTP 端点路径 | 用于发送消息的完整 URL。 此 URL 将在源启动后由 Velocity 生成并填充。 | 字符串 |
身份验证类型 | 指定用于传入消息的身份验证类型。 可选项包括:无、ArcGIS 和基础。 如果指定了无,则不执行身份验证。 如果指定了 ArcGIS,则每个传入消息都必须包含源所有者的有效令牌。 没有有效令牌的消息将被拒绝。 请求标题中的令牌样式必须为 Authorization: Bearer <your token>。 | 字符串 |
其他日志记录 | 指定是否对 Velocity 发送的原始 HTTP 请求和响应进行日志记录。 注:仅启用此参数以进行故障排除,并在完成故障排除时禁用。 在启用参数后启动源,调试级别日志即会出现在源日志页面上。 如有必要,请联系 Esri 技术 支持,获取帮助。 | 布尔 |
用户名 | 指定访问 HTTP 接收器的用户名。 当身份验证类型设置为基础时,才可使用此参数。 | 字符串 |
密码 | 指定访问 HTTP 接收器的密码。 当身份验证类型设置为基础时,才可使用此参数。 | 字符串 |
注意事项和限制
可以与其他用户和群组共享 HTTP 接收器源,该源使用 ArcGIS 身份验证类型并且具有写入权限。 在共享具有写入权限的 HTTP 接收器源后,与之共享该源的用户和群组可以将数据写入源。 如果您不希望其他用户和群组将数据写入源,请勿共享启用写入权限的源。 可以在 Velocity 的源详细信息页面中启用和禁用写入权限。