EsriJSON

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

Le format de données EsriJSON 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, Site Web (Interrogation), Extrémité (Réception), Kafka, WebSocket, RabbitMQ, MQTT.
• Sources de données : Stockage Azure Blob, Amazon S3, Site Web (Interrogation).

Format EsriJSON pris en charge

Velocity prend en charge le format EsriJSON 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 EsriJSON

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

Spécifier la configuration EsriJSON

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 EsriJSON est identifié, d’autres propriétés relatives à la configuration EsriJSON peuvent être spécifiées.

Propriétés de localisation

Dans certains cas, en particulier lors de l’échantillonnage de chaque objet Feature, 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 est par exemple courant 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 importantes ci-dessous doivent être prises en compte lors de l’utilisation de données au format EsriJSON dans Velocity.

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

Dans le format de données EsriJSON, les données attributaires sont représentées par des paires nom-valeur dans l’objet attributaire. Toute propriété doit avoir une valeur 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 généralement recommandé de ne pas modifier les types de champ pour EsriJSON. 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 Feature. Dans la mesure où les objets Feature 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 et doivent donc être ajustés en conséquence. De plus, dans le cas des objets Feature, 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 EsriJSON

La taille de chaque fichier EsriJSON ingéré doit être inférieure à 100 Mo. Si vous avez davantage de données à ingérer, il est recommandé de les fractionner pour créer des fichiers d’une taille inférieure à 100 Mo chacun.