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 depuis 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ées de manière lisible par l'humain. Vous n'avez pas besoin de connaître le protocole pour lire et vérifier les informations contenues dans ces paquets.

Pour apprendre comment télécharger ces informations, vous pouvez vous référer à notre article précédent. Ici, nous visons à explorer plus en détail comment lire ce fichier et interpréter les différentes colonnes qui le composent.

Ouverture d'un fichier

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

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

• Étiquette de l'appareil sur la plateforme : Une étiquette 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 être moins clair pour les personnes. Pour simplifier la lecture du fichier, nous recommandons d'utiliser un éditeur de tableaux. Ouvrez simplement le fichier CSV avec Excel, Google Sheets ou tout autre éditeur de tableaux. Dans l'éditeur de tableaux, tous les paramètres seront dans leurs propres colonnes. De plus, vous pouvez figer la première ligne pour voir les noms des colonnes tout au long du fichier.

Paramètres des 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 catégorisé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é que la localisation n'est pas valide.

  • HAS_FIX : Le traceur GPS a marqué que la localisation est valide.

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

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

• lat : Latitude de la localisation.

• lng : Longitude de la localisation.

• 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 localisation en mètres.

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

• heading : Cap de l'objet en degrés où 0 représente le Nord.

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

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

• pdop : Dilution de position (PDOP) - indique la précision 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 par satellites, conduisant à 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. Est déterminé par l'appareil.

  • 0 signifie 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 de telles données ou ne l'a pas fait pour ce message particulier, ce sera -1 (inconnu).

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

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

• mn_type : Type de réseau mobile. Est déterminé par l'appareil.

  • Si l'appareil ne peut pas fournir de telles données ou ne l'a pas fait 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 : ID d'événement de la plateforme. Trouvez la liste de tous les codes d'ID d'événement ci-dessous.

Codes d'événements 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, juste 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 se réveille d'un mode veille
37	Début du mode veille
40	Alimentation principale faible
41	Alimentation perdue ou coupure d'alimentation externe
42	Bouton d'alimentation pressé
43	Alimentation rétablie ou alimentation externe connectée
44	OBD débranché du connecteur de la voiture
45	OBD branché
46	Batterie de secours de l'appareil faible
50	Fin de l'inactivité (liée au matériel)
51	Début de l'inactivité (liée au matériel)
71	Début du sommeil d'inactivité
72	Début du sommeil pour batterie de secours faible
73	Réveil par minuterie
74	Réveil par mouvement
75	Réveil par alimentation externe
76	Alerte de sommeil par minuterie
81	Mode de sécurité activé
82	Événement utilisateur
83	Événement bouton SOS pressé
84	Mode de sécurité désactivé
90	Déconnexion d'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	Check-in envoyé depuis l'application mobile
798	Soumission de formulaire de tâche
799	Changement d'état de travail
800	Point LBS GSM déterminé par un appareil
802	Point de suivi par temps
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 non lié au suivi
900	Changement de voie brusque (conduite agressive)
901	Brouillage GPS
928	Déconnexion de l'objet suivi
929	Changement fréquent de voie
930	L'appareil ne peut pas détecter de visage humain
931	Ceinture de sécurité débouclée
932	Boire
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 arrêté de fumer (distraction du conducteur)
941	Bouton d'arrêt mis hors tension pressé
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 (fatigue au volant)
946	Le conducteur a arrêté la distraction (distraction du conducteur)
947	Le conducteur a commencé la distraction (distraction du conducteur)
948	Le conducteur a arrêté la somnolence (fatigue au volant)
949	Le conducteur a commencé la somnolence (fatigue au volant)
950	Excès de vitesse détecté par un événement matériel
951	Régulateur de vitesse activé
952	Régulateur de vitesse désactivé
953	Début d'un mouvement inattendu
954	Fin d'un mouvement inattendu
955	Alarme de voiture
956	Piétons dans la zone de danger (ADAS)
957	Reconnaissance des panneaux de signalisation (ADAS)
958	Alerte de collision avec piéton (ADAS)
959	Voyant de contrôle moteur
960	Conduite en état de fatigue
961	Alerte d'écart de distance (Headway) (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 avant (ADAS)
966	Le traceur est entré dans une géofence automatique
967	Le traceur est sorti d'une géofence automatique
968	Forcer la réponse de localisation par SMS depuis l'interface utilisateur
969	Alarme de porte
970	Allumage Off
971	Allumage On
972	Conducteur non identifié
973	Conducteur identifié
974	Verrou fermé
975	Verrou ouvert
976	Appareil éteint
977	Appareil allumé
978	Boîtier fermé
979	Boîtier ouvert
980	Bouton d'appel pressé
981	Capteur de lumière a déterminé l'obscurité
982	Capteur de lumière a déterminé la luminosité
983	Fin de vibration
984	Début de vibration
985	Boulon de sangle inséré
986	Boulon de sangle coupé
987	Accélération et virage brusques (conduite agressive)
988	Freinage et virage brusques (conduite agressive)
989	Virage brusque (conduite agressive)
990	Accélération brusque (conduite agressive)
991	Freinage brusque (conduite agressive)
992	Signal GPS récupéré
993	Signal GPS perdu
994	Alarme de collision
995	Alerte d'atténuation du signal GSM
996	Conduite brutale
997	Bracelet ouvert
998	Bracelet fermé
999	Alerte capteur G

Paramètres complexes

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

• flags : Une carte de bits (bitmap) de drapeaux représentant la validité de la localisation et LBS :

  • Bit 0 (location_valid) : Indique le statut de validité de la localisation. Il est 0 si la localisation est invalide, et 1 si la localisation 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 l'information 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 éteint, et 1 signifie allumé.

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

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

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

Avec ces définitions, nous espérons que vous trouverez facile de lire les informations dans les fichiers de données brutes et de les utiliser pour le dépannage des appareils et dans des programmes pour vos clients.