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

Los siguientes son ejemplos de uso del feed gRPC:

  • Un taller de SIG implementó un cliente gRPC personalizado que utiliza Python para enviar datos estructurados a Velocity mediante el 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 feed gRPC.

Notas de uso

Tenga en cuenta lo siguiente al trabajar con el feed gRPC:

  • El feed gRPC, incluida la especificación del esquema y el campo clave, lo configura un usuario de Velocity. Una vez creado el feed, los parámetros Clave de ruta de encabezado de extremo gRPC, Ruta de encabezado de extremo gRPC y URL de extremo gRPC pasan a estar disponibles en la página de detalles del feed. Estos parámetros son necesarios cuando se crea un cliente gRPC.
  • Establezca el parámetro Tipo de autenticación como 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 mediante el archivo velocity_grpc.proto.
  • El tipo de feed gRPC admite llamadas síncronas y 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 del feed, es 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

A continuación, se indican los parámetros del feed gRPC:

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 lleva a cabo ningún tipo de 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 en el siguiente formato: Authorization: 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

Consideraciones y limitaciones

Los feeds gRPC que utilizan la autenticación de ArcGIS se pueden compartir con permisos de escritura con otros usuarios y grupos. Cuando el feed gRPC se comparte con permisos de escritura, los usuarios y grupos con los que se comparte pueden escribir datos en el feed. No comparta el feed con los permisos de escritura activados si no desea que otros usuarios y grupos puedan escribir datos en él. Los privilegios de escritura se pueden activar y desactivar desde la página de detalles del feed de Velocity. Consulte Compartir feeds para obtener más información.