Esri JSON es un formato para codificar una variedad de estructuras de datos geográficos. Cuando se hace referencia a Esri JSON, normalmente es en referencia al objeto featureSet, que contiene un conjunto de objetos de entidad. ArcGIS Velocity puede procesar en Esri JSON como un objeto featureSet (conjunto de entidades) o como objetos de entidad individuales en forma de líneas.
Esri JSON se admite como un formato de datos para los siguientes tipos de feed y fuente de datos:
- Feeds: Event Hub de Azure, Service Bus de Azure, IdC de AWS, HTTP Poller, Receptor HTTP, Kafka, WebSocket, RabbitMQ y MQTT
- Fuentes de datos: Blob storage de Azure, Amazon S3 y HTTP Poller
JSON Esri admitido
Velocity admite Esri JSON, que mantiene un tipo de geometría, un conjunto de campos y una referencia espacial coherentes.
Genere Esri JSON
Los datos se pueden convertir de toda una variedad de formatos a Esri JSON utilizando la herramienta Entidades de ArcGIS Pro a JSON.
Especificar la configuración de Esri JSON
Al configurar un feed o una fuente de datos, se produce un muestreo para determinar el tipo de datos que se está procesando. Si el muestreo determina que los datos están en formato Esri JSON, existen propiedades adicionales para la configuración de Esri JSON que se pueden especificar.
Propiedades de ubicación
En ciertos casos, particularmente al muestrear objetos de entidades individuales, podría ser necesario configurar información de ubicación adicional si no está presente en los datos de muestra. Por ejemplo, puede que los objetos de geometría en una matriz de entidades no incluyan la referencia espacial para cada entidad. Al muestrear un objeto featureSet, Velocity puede derivar toda la información de ubicación y no es necesario realizar ninguna configuración adicional de las propiedades de ubicación.
Consideraciones y limitaciones
Al trabajar con datos en formato Esri JSON en Velocity, existen varias consideraciones y limitaciones, que se describen a continuación.
Las propiedades de las entidades Esri JSON deben ser coherentes en todo momento
Al utilizar el formato de datos Esri JSON, los datos de atributos se representan con pares de valores de nombre dentro del objeto de atributos. El valor de cualquier propiedad debe ser un objeto nulo o un valor válido. Si una entidad no tiene un valor para una propiedad, debe representarse con un valor nulo en lugar de la ausencia de ese nombre de atributo.
Cambiar tipos de campo
Se recomienda no cambiar los tipos de campo para Esri JSON. Cuando Velocity muestrea y procesa un objeto featureSet, se deriva una representación precisa de los tipos de campo y no se deberían cambiar al configurar una fuente o un feed. La excepción a cambiar los tipos de campo son los objetos de entidad. Los objetos de entidad representan la hora en los campos de fecha como milisegundos Epoch, por lo que siempre se derivan como tipos de campo enteros sin un featureSet completo que contenga explícitamente tipos de campo. Por consiguiente, deberá ajustarlos en consecuencia. Además, en el caso de los objetos de entidad, Velocity intentará derivar otros tipos de campo basándose únicamente en las muestras recuperadas y los tipos de campo se deberían revisar en consecuencia.
Tamaño del archivo Esri JSON
Como mejor práctica, los archivos Esri JSON que se están incorporando en Velocity deben tener menos de 100 MB por archivo. Si tiene una cantidad de datos mayor, divida los archivos en archivos más pequeños (menos de 100 MB por archivo).