Geotab (LogRecord)

Le type de flux Geotab (LogRecord) dans ArcGIS Velocity interroge régulièrement une table de base de données Geotab LogRecord 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. Pour plus d’informations sur Geotab, consultez la rubrique À propos de Geotab de la documentation Geotab. Le type de flux Geotab (LogRecord) diffère du type de flux Geotab (DeviceStatusInfo) par le fait qu’il demande des données de la table LogRecord de la base de données Geotab. La table LogRecord fait généralement l’objet de mises à jour plus fréquentes que la table DeviceStatusInfo de la base de données Geotab, même si elle contient un plus petit nombre d’attributs que la table DeviceStatusInfo. Cela permet à un flux Geotab (LogRecord) de recevoir plus fréquemment des mises à jour de localisation.

Exemples

Voici quelques exemples d’utilisation du flux Geotab (LogRecord) :

• Une ville souhaite superviser sa flotte de chasse-neiges pendant la saison hivernale. Le flux Geotab (LogRecord) 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 (LogRecord) 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

Tenez compte des points suivants lorsque vous utilisez le flux Geotab (LogRecord) :

• Le flux Geotab (LogRecord) 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 LogRecord. La table Device (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 Group (Groupe). Pour plus d’informations, reportez-vous au tableau Structure ci-après.
• Les données de Geotab sont très normalisées et le flux Geotab (LogRecord) suit une structure fixe par défaut. Le flux Geotab (LogRecord) définit automatiquement la localisation, la date et l’heure et l’ID de trace. Le champ d’ID de trace 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 de carburant, le fait de fournir l’ID de diagnostic DiagnosticDeviceTotalFuelId indique au flux de recueillir ces informations dans un nouveau champ d’attribut. 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 (LogRecord).
• Il est possible d’ajouter des champs supplémentaires, avec des informations sur le conducteur, à la structure par défaut du flux Geotab (LogRecord). 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 plus d’informations, reportez-vous au tableau Champs supplémentaires ci-après.
• Il est recommandé d’interroger les données Geotab toutes les 30 secondes ou plus. Pour plus d’informations, consultez la rubrique Rate Limits (Limites de taux) de la documentation Geotab.

Structure

Le tableau suivant répertorie les attributs de structure et leurs types de données disponibles pour le flux Geotab (LogRecord) :

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
groupIds	Chaîne
groupNames	Chaîne

Champs supplémentaires

Le tableau suivant répertorie les attributs supplémentaires et leurs types de données disponibles pour le flux Geotab (LogRecord) :

Attribut	Type de données
firstName	Chaîne
lastName	Chaîne
phoneNumber	Chaîne
phoneNumberExtension	Chaîne
employeeNo	Chaîne
id	Chaîne
nom	Chaîne
companyName	Chaîne

Paramètres

Le tableau suivant répertorie les paramètres Geotab (LogRecord) :

Paramètre	Description	Type de données
URL	URL utilisée pour s'authentifier avec Geotab. L'URL prend généralement la forme suivante : 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 pour l’authentification de Geotab.	Chaîne
Mot de passe	Mot de passe pour l'authentification de 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é Balayeuses. Seuls les véhicules membres du groupe Balayeuses seront 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

Considérations et limitations

Tenez compte des points suivants lorsque vous utilisez le flux Geotab (LogRecord) :

• À 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.
• Si vous spécifiez des ID de diagnostic uniques, vous pouvez utiliser des groupes pour filtrer au préalable le type des appareils 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 ajouté à tous les types de véhicules issus de Geotab, et pas seulement aux camions chasse-neiges. Les véhicules non équipés du capteur auront une valeur de diagnostic « null ». Si un groupe de chasse-neiges est défini en premier lieu, seuls les camions chasse-neiges seront extraits de Geotab et présenteront 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 ces dernières sont fournies par Geotab 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.