Le type de flux Geotab (DeviceStatusInfo) dans ArcGIS Velocity interroge régulièrement une table de base de données Geotab DeviceStatusInfo pour obtenir des données de localisation automatique de véhicules (AVL) en temps réel en envoyant une demande HTTP à une URL spécifiée. Ce type de flux diffère du type de flux Geotab (LogRecord) par le fait qu’il demande des données de la table DeviceStatusInfo de la base de données Geotab. La table DeviceStatusInfo contient un plus grand nombre d’attributs que la table LogRecord, mais ses mises à jour sont généralement moins fréquentes que celles de la table LogRecord de la base de données Geotab.
Exemples
Les exemples suivants illustrent des cas d’utilisation du flux :
- Une ville souhaite superviser sa flotte de chasse-neiges pendant la saison hivernale. Le flux Geotab (DeviceStatusInfo) permet d’observer la localisation en temps réel de chaque camion et de recueillir des informations complémentaires, comme l’occupation éventuelle d’un chasse-neige, l’état de remplissage du bac à sel de déverglaçage, etc.
- Une entreprise de gestion des déchets souhaite améliorer l’efficacité de sa flotte au moyen d’une analyse dynamique. Le flux Geotab (DeviceStatusInfo) permet de collecter la localisation, le conducteur, le poids de charge, le temps d’inactivité et le niveau de carburant en temps réel de chaque véhicule.
Remarques sur l’utilisation
Gardez les points suivants à l’esprit lorsque vous utilisez le flux :
- Le flux Geotab (DeviceStatusInfo) construit les événements à partir des données des tables de la base de données Geotab. Par exemple, les attributs de localisation, de vitesse et de relèvement sont extraits de la table DeviceStatusInfo. La table de l’appareil est utilisée pour extraire des informations d’attributs supplémentaires telles que le numéro d’identification de véhicule (VIN), l’immatriculation, etc. Les noms de groupes et les ID de groupes associés à chaque appareil sont obtenus à partir de la table de groupe. Pour plus d’informations, reportez-vous à la section Structure ci-dessous.
- Les données de Geotab sont très normalisées, et le flux Geotab (DeviceStatusInfo) suit une structure fixe par défaut. Le flux définit automatiquement la localisation, la date et l’heure, ainsi que l’ID de suivi. Le champ d’ID de suivi peut être modifié.
- Des ID de diagnostic facultatifs peuvent être fournis pour agrémenter la structure de valeurs d’attributs supplémentaires. Par exemple, si un véhicule est équipé d’un capteur qui surveille la consommation totale de carburant, le fait de fournir l’ID de diagnostic DiagnosticDeviceTotalFuelId déclenche la collecte de ces informations dans un nouveau champ d’attribut par le flux. Les champs de diagnostic sont représentés dans la structure du flux.
- Il est possible de spécifier un ou plusieurs groupes facultatifs afin de limiter le type des données d’appareil qui sont extraites du flux Geotab (DeviceStatusInfo).
- Il est possible d’ajouter des champs supplémentaires, avec des informations sur le conducteur, à la structure par défaut du flux Geotab (DeviceStatusInfo). Ne sélectionnez que des champs dont les valeurs sont fournies par Geotab. Si un champ est inconnu, il se peut que sa valeur soit nulle, que la chaîne soit vide ou qu’il contienne une chaîne prédéfinie par Geotab. Pour en savoir plus, consultez la section Champs supplémentaires ci-dessous.
- Il est recommandé d’interroger les données Geotab toutes les 30 secondes ou plus.
Structure
Le tableau suivant répertorie les attributs de structure et leurs types de données pour le flux :
| Attribut | Type de données |
|---|---|
| device_id | Chaîne |
| vehicleName | Chaîne |
| vehicleSerialNumber | Chaîne |
| vin | Chaîne |
| vehicleEngineType | Chaîne |
| vehicleLicensePlate | Chaîne |
| vehicleLicenseState | Chaîne |
| deviceType | Chaîne |
| dateTime | Chaîne |
| latitude | Flottant 64 bits |
| longitude | Flottant 64 bits |
| speed | Flottant 64 bits |
| bearing | Entier 32 bits |
| groupIds | Chaîne |
| groupNames | Chaîne |
Champs supplémentaires
Les champs attributaires supplémentaires et les types de données correspondants pour le flux sont indiqués ci-dessous.
| Attribut | Type de données |
|---|---|
firstName | Chaîne |
lastName | Chaîne |
phoneNumber | Chaîne |
phoneNumberExtension | Chaîne |
employeeNo | Chaîne |
id | Chaîne |
name | Chaîne |
companyName | Chaîne |
Paramètres
| Paramètre | Description | Type de données |
|---|---|---|
| URL | URL utilisée pour authentifier Geotab, par exemple, https://[myserver].geotab.com/apiv1. | Chaîne |
| Base de données | Nom de la base de données Geotab. | Chaîne |
| Nom d’utilisateur | Nom d’utilisateur utilisé pour authentifier Geotab. | Chaîne |
| Mot de passe | Mot de passe utilisé pour authentifier Geotab. | Mot de passe |
| Groupes (facultatifs) | Noms de groupes facultatifs utilisés pour filtrer les membres des entités. Par exemple, les balayeuses de voirie peuvent faire partie d’un groupe nommé Sweepers. Seuls les véhicules membres du groupe Sweepers sont extraits pour un traitement en temps réel. Remarque :Pour spécifier plusieurs groupes, utilisez un point-virgule (;). | Chaîne |
| ID de diagnostic (facultatifs) | ID de diagnostic facultatifs utilisés pour obtenir des valeurs de diagnostic. Par exemple, DiagnosticDeviceTotalFuelId est l’ID de diagnostic utilisé pour extraire la consommation totale de carburant des véhicules équipés du capteur adéquat. Un champ de valeur de diagnostic et un champ d’horodatage de diagnostic sont ajoutés pour chaque ID de diagnostic. Remarque :Pour spécifier plusieurs ID de diagnostic, utilisez un point-virgule (;). | Chaîne |
| Champs supplémentaires | Liste de champs supplémentaires permettant d’enrichir la structure du flux avec des informations sur le conducteur. Remarque :Ne sélectionnez que des champs dont les valeurs sont fournies par Geotab. Sinon, la valeur résultante des champs risque d’être nulle, de correspondre à une chaîne vide ou de contenir une chaîne prédéfinie par Geotab. | Chaîne |
| Journalisation supplémentaire (facultatif) | Indique si la journalisation des requêtes et réponses HTTP au format brut envoyées par Velocity à l’API Geotab est activée. Remarque :Activez ce paramètre à des fins de dépannage 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 d’Esri pour obtenir de l’aide dans le cadre du dépannage. | Booléen |
Considérations et limitations
Tenez compte des points suivants lorsque vous utilisez le flux :
- À chaque intervalle d’interrogation, Geotab fournit les données qu’il a compilées lors de la dernière interrogation ; les données compilées après cette interrogation ne sont pas incluses. Les données fournies peuvent être plus anciennes que l’horodatage de la dernière interrogation effectuée par le flux.
- Les valeurs de diagnostic sont mises à jour à un rythme différent de celui des autres données d’appareil. C’est pourquoi chaque champ de diagnostic s’accompagne d’un champ d’horodatage. Déterminez si les valeurs de diagnostic ont un lien temporel avec le dernier horodatage des autres données extraites de Geotab.
- Lorsque vous spécifiez des ID de diagnostic uniques, vous pouvez utiliser des groupes pour filtrer d’abord le type des appareils issus de Geotab. Chaque ID de diagnostic améliore la structure pour tous les véhicules de Geotab. Ainsi, un diagnostic qui capture l’état d’une lame de chasse-neige sera-t-il ajouté à tous les types de véhicules issus de Geotab, et pas seulement aux camions chasse-neiges. Pour les véhicules sans capteur, la valeur de diagnostic est nulle. Si un groupe de chasse-neiges est défini en premier lieu, seuls les camions chasse-neiges sont extraits de Geotab et présentent le champ de diagnostic personnalisé pour l’état de la lame de chasse-neige en question.
- Les champs supplémentaires ne possèdent des valeurs que si Geotab les fournit dans la base de données. Prenez en compte les informations communiquées par les appareils Geotab de votre organisation avant de sélectionner des champs supplémentaires. Les champs sans valeur sont nuls, correspondent à une chaîne vide ou contiennent une chaîne prédéfinie par Geotab.
- Si les informations d’identification d’utilisateur ne sont pas valides, le flux relance la connexion jusqu’à trois fois. Des erreurs relatives aux informations d’identification non valides apparaissent dans les journaux. Le flux tente automatiquement de redémarrer après un délai d’attente, en fonction du calendrier de récurrence configuré.
Vous avez un commentaire à formuler concernant cette rubrique ?