Le type de flux Feature Layer (Couche d’entités) de ArcGIS Velocity interroge les entités d’une couche d’entités ArcGIS Online ou ArcGIS Server.
Exemples
Les exemples suivants illustrent des cas d’utilisation du flux :
- Un utilisateur configure un flux faisant référence à une couche d’entités hébergée par ArcGIS Server pour charger des entités ajoutées par les utilisateurs.
- Un analyste SIG fournit l’URL d’une couche d’entités ArcGIS Server (par exemple, https://sampleserver6.arcgisonline.com/arcgis/rest/services/Wildfire/FeatureServer/2) contenant les entités à charger minute par minute pour les utiliser dans une analyse en temps réel.
Remarques sur l’utilisation
Gardez les points suivants à l’esprit lorsque vous utilisez le flux :
- Le flux interroge la couche d’entités pour charger les entités selon la fréquence définie à l’étape Feed Polling Interval (Intervalle d’interrogation de flux) de l’assistant de configuration de flux.
- La valeur du champ d’horodatage est le champ de date qui permet d’obtenir les entités les plus récentes. Vous pouvez définir la valeur du champ d’horodatage à l’étape correspondante. Si aucune valeur de champ d’horodatage n’est spécifiée, à chaque intervalle, le flux de couche d’entités charge les entités de la couche d’entités en tant qu’événements à traiter.
- Si une valeur de champ d’horodatage est spécifiée, lorsque Velocity interroge la couche d’entités pour la première fois, toutes les entités dont la valeur du champ d’horodatage datetime figure dans la dernière minute écoulée et est inférieure à l’heure de la première interrogation du flux, et qui répondent aux critères de la clause WHERE sont chargées. Pour chaque interrogation suivante, seules les entités dont la valeur du champ d’horodatage est comprise entre l’heure de la dernière interrogation et l’heure de l’interrogation actuelle, et qui répondent aux critères de la clause WHERE sont chargées.
- Velocity exige que le stockage des valeurs d’horodatage au format UTC (temps universel coordonné) Si une valeur d’horodatage est spécifiée, mais que les valeurs ne sont pas stockées au format UTC, l’interrogation de la couche d’entités risque de renvoyer des données inattendues.
- Lorsque vous recherchez un élément de couche d’entités, vous pouvez effectuer un filtrage par dossiers, favoris, groupes, organisation, ou par entités depuis ArcGIS Online. Vous pouvez ensuite filtrer davantage par date de modification, date de création et balises.
- Les couches d’entités ArcGIS Server peuvent également être chargées à l’aide d’une URL. Il doit s’agir de l’URL REST du répertoire des services ArcGIS Server (par exemple, https://sampleserver6.arcgisonline.com/arcgis/rest/services/Wildfire/FeatureServer/2). Cette URL doit se terminer par /FeatureServer/# ou /MapServer/#, où # est le numéro de la couche.
- Pour charger une couche d’entités sécurisée à partir d’une URL, vous devez d’abord ajouter un service ou un document à partir de l’URL dans ArcGIS Online et choisir de stocker les informations d’identification. Vous pouvez ensuite accéder à l’élément ArcGIS Online inscrit pour sélectionner la couche d’entités sécurisée.
- Lorsqu’une fréquence d’interrogation est définie, les interrogations ont lieu à intervalles réguliers à partir de l’heure de démarrage du flux. Par exemple, si un flux est configuré pour interroger les données toutes les cinq minutes, et qu’il démarre à 8:03, la première demande de données a lieu à 8:05, la suivante à 8:10, et ainsi de suite.
- Faites attention lorsque vous définissez l’intervalle d’interrogation. Vous devez vous assurer que la couche d’entités interrogée peut renvoyer des réponses dans l’intervalle d’interrogation spécifié. Il est recommandé de tester le temps de réponse d’une requête adressée à cette couche d’entités, à l’aide de la requête appliquée lors de la configuration du flux. La durée de l’intervalle d’interrogation ne doit jamais être inférieure au temps de réponse moyen à cette requête. Pour plus d’informations sur la planification des intervalles d’interrogation de flux, reportez-vous à la rubrique Programmation de l’intervalle d’interrogation de flux.
- Une fois que vous avez configuré les paramètres de connexion de la couche d’entités, consultez la rubrique Configurer les données en entrée pour savoir comment définir la structure et les paramètres clés.
Paramètres
Les paramètres du flux sont les suivants :
| Paramètre | Explication | Type de données |
|---|---|---|
| Clause WHERE | Le paramètre WHERE clause (Clause WHERE) indique une clause SQL (Structured Query Language) utilisée pour filtrer les entités chargées à partir de la couche d’entités spécifiée. L’option par défaut est de charger toutes les entités à l’aide de 1=1. Le paramètre WHERE clause (Clause WHERE) par défaut peut être modifié pour inclure des valeurs attributaires et des conditions logiques spécifiques. La syntaxe de la clause WHERE SQL-92 pour les champs de la couche est prise en charge dans la plupart des couches d’entités. Les couches d’entités générées par Velocity et s’exécutant dans une source de données spatio-temporelles présentent des restrictions : seul un sous-ensemble d’opérateurs SQL-92 est pris en charge. Voici la liste des opérateurs SQL-92 pris en charge avec ces couches d’entités :
Vous pouvez mettre à jour ce paramètre à l’étape visant à filtrer les données. | QueryString |
| Champs en sortie | Le paramètre Out fields (Champs en sortie) spécifie les champs à charger à partir de la couche d’entités dans Velocity. La valeur par défaut est un astérisque (*), qui indique tous les champs chargés. Si des champs spécifiques sont indiqués, ils doivent être répertoriés par leurs noms, séparés par des virgules. Par exemple : OBJECTID,device_id,timestamp,horizontal_accuracy,latitude,longitude Vous pouvez mettre à jour ce paramètre à l’étape visant à filtrer les données. | Chaîne |
| Output spatial reference (Référence spatiale en sortie) (facultatif) | Le paramètreOutput spatial reference (Référence spatiale en sortie) spécifie l’identifiant connu (WKID) d’une référence spatiale. Le WKID par défaut est 4326. Velocity charge les données de la couche d’entités avec la référence spatiale définie dans ce paramètre. Vous pouvez mettre à jour ce paramètre à l’étape visant à filtrer les données. | Chaîne |
| Journalisation supplémentaire (facultatif) | Indique si la journalisation des requêtes au format brut émises par Velocity est activée. La valeur par défaut est False. Remarque :Activez ce paramètre à des fins de dépannage uniquement et désactivez-le à l’issue du dépannage. Une fois le paramètre activé, démarrez le flux. Les journaux de niveau Debug (Débogage) sont disponibles sur la page des journaux du flux. Contactez le Support technique Esri pour obtenir de l’aide dans le cadre du dépannage. | Booléen |
| Champ d’horodatage | Spécifie un champ de date pour extraire uniquement les dernières entités. Si aucune valeur de champ d’horodatage n’est spécifiée, à chaque intervalle, le flux charge toutes les entités de la couche d’entités en tant qu’événements à traiter. Si une valeur de champ d’horodatage est spécifiée, lorsque Velocity interroge la couche d’entités pour la première fois, il charge toutes les entités dont la valeur du champ d’horodatage datetime figure dans la dernière minute écoulée et est inférieure à l’heure de la première interrogation du flux, et qui répondent aux critères de la clause WHERE. Pour chaque interrogation suivante, seules les entités dont la valeur du champ d’horodatage est comprise entre l’heure de la dernière interrogation et l’heure de l’interrogation actuelle, et qui répondent aux critères de la clause WHERE, sont chargées. | Chaîne |
Considérations et limitations
Tenez compte des points suivants lorsque vous utilisez le flux :
- La couche d’entités doit être accessible via Internet.
- La durée de l’intervalle d’interrogation ne doit jamais être inférieure au temps de réponse moyen d’une requête de couche d’entités.
- Velocity ne prend pas en charge les couches qui demandent des crédits pour les interrogations de données.
Vous avez un commentaire à formuler concernant cette rubrique ?