Colonnes dans le fichier CSV

L’outil d’entrepôt de données vous permet d’exporter un fichier de données brutes contenant tous les paquets reçus de votre appareil, sans aucun filtrage ni calcul effectué côté plateforme. Ces paramètres représentent des informations initialement décodées à partir du paquet de votre appareil dans un format lié au protocole, présenté de manière lisible par l’être humain. Vous n’avez pas besoin de connaître le protocole pour lire et vérifier les informations contenues dans ces paquets.

Pour apprendre à télécharger ces informations, vous pouvez vous référer à notre précédent article. Ici, nous souhaitons aller plus loin en expliquant comment lire ce fichier et interpréter les différentes colonnes qu’il contient.

Ouverture d’un fichier

Le nom du fichier contient toujours les éléments suivants :

• ID de l’appareil : Le numéro d’identification de l’appareil, représentant souvent son IMEI.

• Libellé de l’appareil sur la plateforme : Un libellé pour faciliter la recherche du fichier.

• Heure de début et de fin : Représentant le début et la fin du fichier au format jour_mois_année_heures_minutes_AM/PM.

• Fuseau horaire au format UTC.

Vous pouvez ouvrir le fichier de données brutes avec n’importe quel éditeur de texte, tel que WordPad, Notepad++ ou Sublime Text. Ce format est facilement compris par les programmes et les machines, mais peut ne pas être aussi clair pour les personnes. Pour simplifier la lecture du fichier, nous vous recommandons d’utiliser un tableur. Ouvrez simplement le fichier CSV avec Excel, Google Sheets ou tout autre tableur. Dans le tableur, tous les paramètres seront dans leurs propres colonnes. De plus, vous pouvez figer la première ligne pour voir les noms des colonnes dans tout le fichier.

Paramètres de données brutes

Le fichier inclura les paramètres sélectionnés dans des colonnes, ainsi qu’une entrée constante : msg_time.

Ces paramètres peuvent être classés comme simples ou complexes.

Colonnes simples

Les paramètres simples fournissent des noms complets et représentent principalement des informations de suivi spécifiques.

• msg_time: Heure à laquelle le traceur a enregistré un point. Toujours inclus dans la sortie CSV. Indiqué selon le fuseau horaire choisi.

• server_time: Heure de réception du message par le serveur. Indiqué selon le fuseau horaire choisi.

• gps_fix_type

  • NO_FIX : Le traceur GPS a marqué l’emplacement comme non valide.

  • HAS_FIX : Le traceur GPS a marqué l’emplacement comme valide.

  • LAST_KNOWN_POSITION : Dans le cas où le traceur fournit l’entrée actuelle et d’autres états au sein de la dernière position connue.

  • UNKNOWN : Si un appareil ne peut pas fournir ces informations ou n’a pas déterminé le type de fix GPS pour ce paquet.

• lat: Latitude de la position.

• lng: Longitude de la position.

• speed: Vitesse déterminée par le traceur en km/h. Dans la plupart des cas, il s’agit de la vitesse déterminée par le GPS de l’appareil.

• alt: Altitude de la position en mètres.

• satellites: Nombre de satellites connectés à ce moment-là ; -1 signifie inconnu et, dans la plupart des cas, représente un point de position LBS.

• heading: Cap du véhicule en degrés, où 0 représente le Nord.

• precision: Précision de la position en mètres.

• hdop: Dilution horizontale de précision - représente l’exactitude des estimations de la position horizontale du traceur GPS. Les valeurs vont de 1 (excellente) à plus de 20 (faible). Les valeurs comprises entre 1 et 2 sont considérées comme bonnes pour la plupart des usages de navigation. -1 signifie inconnu.

• pdop: Dilution de précision de position - indique l’exactitude de la position d’un traceur GPS en fonction de la géométrie des satellites par rapport au traceur. Des valeurs PDOP plus faibles signifient un meilleur positionnement satellite, ce qui conduit à des données de localisation plus précises, mais -1 signifie inconnu.

• mn_name: Nom du réseau mobile. Déterminé par l’appareil.

• mn_roaming: État d’itinérance. Déterminé par l’appareil.

  • 0 signifie qu’il n’y a pas d’itinérance,

  • 1 signifie que ce point a été généré par un appareil en itinérance,

  • Si l’appareil ne peut pas fournir ces données ou n’a pas pu le faire pour ce message particulier, ce sera -1 (inconnu).

• mn_code: Code de l’opérateur de réseau mobile. Déterminé par l’appareil.

• mn_csq: Intensité du signal du réseau mobile, CSQ, valeurs de 0 à 31. Déterminée par l’appareil. Si l’appareil ne peut pas fournir ces données ou n’a pas pu le faire pour ce message particulier, ce sera 99 (inconnu).

• mn_type: Type de réseau mobile. Déterminé par l’appareil.

  • Si l’appareil ne peut pas fournir ces données ou n’a pas pu le faire pour ce message particulier, ce sera UNKNOWN

  • GSM: Si l’appareil a déterminé le type GSM.

  • CDMA: Si l’appareil a déterminé le type CDMA.

  • WCDMA: Si l’appareil a déterminé le type WCDMA.

  • LTE: Si l’appareil a déterminé le type LTE.

  • NR: Si l’appareil a déterminé le type NR.

• event_id: L’ID d’événement de la plateforme. Consultez la liste de tous les codes d’ID d’événement ci-dessous.

ID de code d’événement de la plateforme et leurs définitions

Dans les paquets de l’appareil, divers codes d’événements peuvent être définis, chacun signifiant une occurrence spécifique.

ID d’événement	Définition
2	Suivi. Aucun événement spécifique, seulement un point de suivi
4	Numéro de contact d’urgence appelé
5	Événement de mouvement non autorisé déterminé par l’appareil
11	Changement d’état de l’entrée 1
12	Changement d’état de l’entrée 2
13	Changement d’état de l’entrée 3
14	Changement d’état de l’entrée 4
15	Changement d’état de l’entrée 5
16	Changement d’état de l’entrée 6
17	Changement d’état de l’entrée 7
18	Changement d’état de l’entrée 8
34	L’appareil sort du mode veille
37	Début du mode veille
40	Alimentation principale faible
41	Perte d’alimentation ou coupure de l’alimentation externe
42	Bouton d’alimentation enfoncé
43	Alimentation rétablie ou alimentation externe connectée
44	Débranchement OBD du connecteur du véhicule
45	Branchement OBD
46	Batterie de secours de l’appareil faible
50	Fin d’inactivité (liée au matériel)
51	Début d’inactivité (lié au matériel)
71	Début de veille d’inactivité
72	Début de veille en cas de faible batterie de secours
73	Réveil par minuterie
74	Réveil par mouvement
75	Réveil par alimentation externe
76	Alerte de mise en veille par minuterie
81	Mode sécurité activé
82	Événement utilisateur
83	Événement de pression du bouton SOS
84	Mode sécurité désactivé
90	Déconnexion de l’antenne
100	Appareil détaché de l’objet
111	Changement d’état de la sortie 1
112	Changement d’état de la sortie 2
113	Changement d’état de la sortie 3
114	Changement d’état de la sortie 4
115	Changement d’état de la sortie 5
116	Changement d’état de la sortie 6
117	Changement d’état de la sortie 7
118	Changement d’état de la sortie 8
797	Pointage envoyé depuis l’application mobile
798	Soumission du formulaire de tâche
799	Changement du statut de travail
800	Point LBS GSM déterminé par un appareil
802	Point de suivi par heure
803	Point de suivi par distance
804	Point de suivi par angle
811	Début du mouvement de suivi
812	Fin du mouvement de suivi
813	Fin du mouvement non autorisé
814	Message hors suivi
900	Conduite brutale : changement de voie rapide
901	Brouillage GPS
928	Débranchement de l’objet suivi
929	Changement de voie fréquent
930	L’appareil ne peut pas détecter de visage humain
931	Ceinture de sécurité non bouclée
932	Consommation d’alcool
933	Yeux fermés
934	Attacher l’appareil à l’objet suivi
935	MDSM 7 déconnecté
936	MDSM 7 connecté
937	Signaler un nouveau conducteur
938	Le conducteur entre dans la cabine
939	Début de l’absence du conducteur
940	Le conducteur a cessé de fumer (distraction du conducteur)
941	Bouton d’arrêt de l’alimentation enfoncé
942	Le conducteur a commencé à fumer (distraction du conducteur)
943	Le conducteur a cessé d’utiliser le téléphone (distraction du conducteur)
944	Le conducteur a commencé à utiliser le téléphone (distraction du conducteur)
945	Bâillement (conduite avec fatigue)
946	Le conducteur a cessé d’être distrait (distraction du conducteur)
947	Le conducteur a commencé à être distrait (distraction du conducteur)
948	Le conducteur a cessé d’être somnolent (conduite avec fatigue)
949	Le conducteur a commencé à être somnolent (conduite avec fatigue)
950	Excès de vitesse par événement matériel
951	Régulateur de vitesse activé
952	Régulateur de vitesse désactivé
953	Début de mouvement inattendu
954	Fin de mouvement inattendu
955	Alarme de voiture
956	Piétons en zone dangereuse (ADAS)
957	Reconnaissance des panneaux de signalisation (ADAS)
958	Alerte de collision avec piétons (ADAS)
959	Voyant moteur
960	Conduite en état de fatigue
961	Alerte de distance de sécurité (ADAS)
962	Départ de voie à droite (ADAS)
963	Départ de voie à gauche (ADAS)
964	Départ de voie (ADAS)
965	Alerte de collision frontale (ADAS)
966	Le traceur est entré dans le geofencing automatique
967	Le traceur est sorti du geofencing automatique
968	Réponse de localisation forcée par SMS depuis l’interface
969	Alarme de porte
970	Contact coupé
971	Contact mis
972	Conducteur non identifié
973	Conducteur identifié
974	Verrou fermé
975	Verrou ouvert
976	Alimentation de l’appareil coupée
977	Alimentation de l’appareil activée
978	Boîtier fermé
979	Boîtier ouvert
980	Bouton d’appel enfoncé
981	Le capteur de lumière a détecté l’obscurité
982	Le capteur de lumière a détecté la luminosité
983	Fin de vibration
984	Début de vibration
985	Boulon de sangle inséré
986	Boulon de sangle coupé
987	Conduite brutale : accélération et virage
988	Conduite brutale : freinage et virage
989	Conduite brutale : virage
990	Conduite brutale : accélération
991	Conduite brutale : freinage
992	Signal GPS rétabli
993	Signal GPS perdu
994	Alarme de collision
995	Alarme d’atténuation du signal GSM
996	Conduite brusque
997	Bracelet ouvert
998	Bracelet fermé
999	Alerte du capteur G

Paramètres complexes

Les paramètres complexes incluent à la fois le nom du groupe et le nom spécifique. Ils sont classés comme suit :

• flags: Un bitmap d’indicateurs représentant la validité de la position et le LBS :

  • Bit 0 (location_valid) : Indique l’état de validité de la position. Il est 0 si la position est invalide, et 1 si la position est valide.

  • Bit 1 (lbs) : Indique l’état LBS du point. Si 0, le point est reçu par GPS ; si 1, le point est reçu par LBS.

  • Bit 2 (soft_lbs) : Indique la source du point LBS. Si 0, le point est déterminé par le LBS de l’appareil ; si 1, par le LBS de la plateforme.

• discrete_inputs: Représente les informations de chaque entrée discrète. Chaque entrée discrète est présentée dans une colonne séparée, numérotée à partir de 1. Les valeurs possibles sont 1 et 0, où 0 signifie désactivé et 1 signifie activé.

• discrete_outputs : Affiche la même chose que les entrées discrètes, mais pour les sorties discrètes. Chaque sortie discrète se trouve dans une colonne séparée, numérotée à partir de 1.

• inputs: Représente les données de différents capteurs, tels que le carburant ou divers capteurs de mesure. Chaque entrée se trouve dans une colonne séparée, et la liste des entrées dépend du modèle de l’appareil.

• states: Affiche les valeurs des paramètres d’état. La plupart peuvent être 1 ou 0, mais certains ont des valeurs textuelles spécifiques comme les codes DTC.

Avec ces définitions, nous espérons qu’il vous sera facile de lire les informations dans les fichiers de données brutes et de les utiliser pour le dépannage des appareils et dans les programmes destinés à vos clients.