Esri JSON

Esri JSON est un format de codage de diverses structures de données géographiques. Lorsqu’il est fait référence au format Esri JSON, le plus souvent, cela est en référence à l’objet featureSet, où contient un ensemble d’objets entités. ArcGIS Velocity peut ingérer le format Esri JSON en tant qu’objet featureSet (ensemble d’entités) ou en tant qu’objets entités individuels sous forme de lignes.

Le format de données Esri JSON est pris en charge pour les types de flux et de source de données suivants :

• Flux : Azure Event Hub, Azure Service Bus, AWS IoT, Interrogation HTTP, Réception HTTP, Kafka, WebSocket, RabbitMQ et MQTT
• Sources de données : Stockage Blob Azure, Amazon S3 et Interrogation HTTP

Format Esri JSON pris en charge

Velocity prend en charge le format Esri JSON qui gère un type de géométrie, un jeu de champs et une référence spatiale cohérents.

Générer le format Esri JSON

De nombreux formats de données peuvent être convertis en Esri JSON à l’aide de l’outil ArcGIS Pro Entités vers JSON.

Spécifier la configuration Esri JSON

Lors de la configuration d’un flux ou d’une source de données, un échantillonnage est effectué pour déterminer le type des données ingérées. Si, au cours de l’échantillonnage, le format de données Esri JSON est identifié, d’autres propriétés relatives à la configuration Esri JSON peuvent être spécifiées.

Propriétés de localisation

Dans certains cas, en particulier lors de l’échantillonnage de chaque objet entités, il peut être nécessaire de configurer des informations de localisation supplémentaires si elles ne sont pas présentes dans les données d’échantillonnage. Il se peut, par exemple, que les objets géométriques dans une matrice d’entités ne comprennent pas la référence spatiale de cette entité. Lors de l’échantillonnage d’un objet featureSet, Velocity peut déduire l’ensemble des informations de localisation. Aucune configuration supplémentaire des propriétés de localisation n’est requise.

Considérations et limitations

Les limites et informations décrites ci-après doivent être prises en compte lors de l’utilisation de données au format Esri JSON dans Velocity.

Les propriétés d’entité Esri JSON doivent être cohérentes

Dans le format de données Esri JSON, les données attributaires sont représentées par des paires nom-valeur dans l’objet attributaire. Toute propriété doit avoir une valeur valide ou être nulle. Si une propriété d’une entité n’a pas de valeur, elle doit être représentée par une valeur nulle (ce qui n’est pas équivalent à l’absence de ce nom d’attribut).

Modification des types de champ

Il est recommandé de ne pas modifier les types de champ pour Esri JSON. Lorsque Velocity échantillonne et ingère des objets featureSet, une représentation précise des types de champ en est dérivée et ceux-ci ne doivent pas être modifiés lors de la configuration d’une source ou d’un flux. Il existe cependant une exception : les objets entités. Les objets entités représentent le temps dans les champs de date sous forme de millisecondes (epoch), ils sont toujours dérivés en tant que champs entiers sans objet featureSet complet qui contienne explicitement les types de champ. Vous devez donc les ajuster comme il convient. De plus, dans le cas des objets entités, Velocity tente de dériver d’autres types de champ en se basant uniquement sur les échantillons récupérés. Les types de champ doivent être examinés en conséquence.

Taille des fichiers Esri JSON

La taille de chaque fichier Esri JSON ingéré dans Velocity doit être inférieure à 100 Mo. Si vous avez un plus grand volume de données, divisez les fichiers en fichiers plus petits (moins de 100 Mo par fichier).