gRPC

El tipo de feed gRPC de ArcGIS Velocity crea un extremo de ruta gRPC integrado que se puede utilizar para enviar datos mediante programación desde clientes y aplicaciones gRPC a Velocity, ya sea en solicitudes discretas o en una transmisión continua. gRPC es un marco de llamada de procedimiento remoto de código abierto que se utiliza para conectar aplicaciones y servicios distribuidos.

Ejemplos

  • Un taller de SIG implementó un cliente gRPC personalizado que utiliza Python para enviar datos estructurados a Velocity mediante el tipo de feed gRPC.
  • Una organización con varias aplicaciones de recopilación de datos, escrita en diferentes idiomas, desea poner sus datos a disposición del análisis geoespacial. Los clientes de gRPC personalizados se desarrollan para enviar datos desde sus diversas aplicaciones a Velocity utilizando el tipo de feed gRPC.

Notas de uso

  • El feed gRPC está configurado por un usuario de Velocity, incluida la especificación del esquema y del campo clave. Una vez creado el feed, en la página de detalles del feed, están disponibles los parámetros Clave de ruta de encabezado de extremo gRPC, Ruta de encabezado de extremo gRPC y URL de extremo gRPC. Estos parámetros son necesarios cuando se crea un cliente gRPC.
  • Establezca el valor de Tipo de autenticación en ArcGIS para utilizar la autenticación OAuth2.0. Cada mensaje entrante debe incluir un token válido para el propietario del feed. Se rechazarán los mensajes sin un token válido.
  • Los datos de un cliente gRPC se deben formar como un objeto estructurado que se define por el archivo velocity_grpc.proto.
  • El tipo de feed gRPC admite llamadas síncronas o asíncronas.
  • El tipo de feed gRPC es compatible con RPC de transmisión de cliente (varias solicitudes con una sola respuesta) y RPC unaria (solicitud única con una sola respuesta).
  • Además de configurar los parámetros de conexión de feed, será necesario crear un cliente gRPC para enviar entidades a Velocity. El marco de gRPC admite muchos lenguajes de desarrollo. El repositorio GitHub realtime-grpc-feed contiene recursos esenciales tales como el archivo velocity_grpc.proto utilizado para definir el contrato entre el cliente y el servicio de feed gRPC, la documentación de desarrollador y las implementaciones de referencia que ilustran cómo crear un cliente gRPC.
  • Para obtener más información sobre las funcionalidades de gRPC y las estrategias de desarrollo de clientes, consulte la página web gRPC.

Parámetros

ParámetroDescripciónTipo de datos

Tipo de autenticación

Especifica si los mensajes entrantes se autenticarán. Las opciones son las siguientes:

  • Ninguno: no se realiza autenticación.
  • ArcGIS: cada mensaje entrante debe incluir un token válido para el propietario del feed. Se rechazarán los mensajes sin un token válido.

El token debe aparecer en los encabezados de solicitud de la siguiente manera: Autorización: Bearer <your_token>

Cadena de caracteres

Clave de ruta de encabezado de extremo gRPC

La clave que identifica el feed de los mensajes de generación de rutas. La clave se utiliza con la ruta de encabezado para dirigir los mensajes al feed.

Este parámetro lo genera y rellena Velocity después de publicar el feed.

Cadena de caracteres

Ruta de encabezado de extremo gRPC

La ruta que identifica el feed de los mensajes de generación de rutas.

Este parámetro lo genera y rellena Velocity después de publicar el feed.

Cadena de caracteres

URL de extremo gRPC

La URL completa para enviar mensajes tal y como se define en el canal del cliente gRPC.

Este parámetro lo genera y rellena Velocity después de publicar el feed.

Cadena de caracteres