gRPC

ArcGIS Velocity 中的 gRPC 源类型可创建一个内置 gRPC 路径端点,该端点可用于以编程方式将数据从 gRPC 客户端和应用程序以离散请求或连续流的形式发送至 Velocity。gRPC 是一个开源的远程过程调用框架,用于连接分布式应用程序和服务。

示例

  • GIS 研讨会实现了一个自定义 gRPC 客户端,该客户端将使用 Python 将结构化数据发送到使用 gRPC 源类型的 Velocity
  • 拥有多个数据收集应用程序(以不同语言编写)的组织希望将其数据用于地理空间分析。 可以开发自定义 gRPC 客户端以将数据从其各种应用程序发送至使用 gRPC 源类型的 Velocity

用法说明

  • gRPC 源由 Velocity 用户配置,包括方案和关键字段指定。 创建源后,将在源详细信息页面上提供 gRPC 端点标头路径键gRPC 端点标头路径gRPC 端点 URL 参数。 在创建 gRPC 客户端时,这些参数为必填项。
  • 身份验证类型值设置为 ArcGIS 以使用 OAuth2.0 身份验证。 每个传入消息都必须包含源所有者的有效令牌。 没有有效令牌的消息将被拒绝。
  • 需要将来自 gRPC 客户端的数据格式化为由velocity_grpc.proto 文件定义的结构化对象。
  • gRPC 源类型支持同步或异步调用。
  • gRPC 源类型支持客户端流式 RPC(多个请求,单个响应)和一元 RPC(单个请求,单个响应)。
  • 除了配置源连接参数之外,还需要创建一个 gRPC 客户端以将要素发送至 Velocity。 gRPC 框架支持多种开发语言。 realtime-grpc-feed Github 资料档案库包含基本资源,例如用于定义客户端与 gRPC 源服务之间协定的 velocity_grpc.proto 文件、开发人员文档以及说明如何创建 gRPC 客户端的参考实现。
  • 有关 gRPC 功能和客户端开发策略的详细信息,请参阅 gRPC 网页。

参数

参数描述数据类型

身份验证类型

指定是否将对传入消息进行身份验证。 选项如下:

  • - 不执行身份验证。
  • ArcGIS - 每个传入消息都必须包含源所有者的有效令牌。 没有有效令牌的消息将被拒绝。

令牌必须包含在标头中,格式为:Authorization: Bearer <your_token>

字符串

gRPC 端点标头路径键

标识用于路径选择消息的源的键。 该键将与标头路径配合使用以将消息路由到源。

此参数将在源发布后由 Velocity 生成并填充。

字符串

gRPC 端点标头路径

标识用于路径选择消息的源的路径。

此参数将在源发布后由 Velocity 生成并填充。

字符串

gRPC 端点 URL

gRPC 客户端通道中定义的用于发送消息的完整 URL。

此参数将在源发布后由 Velocity 生成并填充。

字符串


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