Columnas en el archivo CSV

La herramienta de almacén de datos le permite exportar un archivo de datos sin procesar que contiene todos los paquetes recibidos desde su dispositivo, sin ningún filtrado ni cálculos realizados en el lado de la plataforma. Estos parámetros representan información inicialmente decodificada del paquete de su dispositivo en un formato relacionado con el protocolo, presentada de forma legible para humanos. No necesita conocer el protocolo para leer y comprobar la información en estos paquetes.

Para aprender cómo descargar esta información, puede consultar nuestro artículo anterior. Aquí, buscamos explorar con más detalle cómo leer este archivo e interpretar varias columnas dentro del mismo.

Abrir un archivo

El nombre del archivo siempre contiene lo siguiente:

• ID del dispositivo: El número de identificación del dispositivo, que a menudo representa su IMEI.

• Etiqueta del dispositivo en la plataforma: Una etiqueta para facilitar la búsqueda del archivo.

• Hora desde y hasta: Representando el inicio y el final del archivo en el formato día_mes_año_horas_minutos_AM/PM.

• Zona horaria en formato UTC.

Puede abrir el archivo de datos sin procesar con cualquier editor de texto, como WordPad, Notepad++ o Sublime Text. Este formato es fácilmente entendible por programas y máquinas, pero puede no ser tan claro para las personas. Para simplificar la lectura del archivo, recomendamos usar un editor de tablas. Simplemente abra el archivo CSV con Excel, Google Sheets o cualquier otro editor de tablas. En el editor de tablas, todos los parámetros estarán en sus propias columnas. Además, puede congelar la primera fila para ver los nombres de las columnas a lo largo del archivo.

Parámetros de datos sin procesar

El archivo incluirá parámetros seleccionados en columnas, junto con una entrada consistente: msg_time.

Estos parámetros pueden categorizarse como simples o complejos.

Columnas simples

Los parámetros simples proporcionan nombres completos y representan principalmente información específica de seguimiento.

• msg_time: Hora cuando el rastreador registró un punto. Siempre incluido en la salida CSV. Indicada según la zona horaria seleccionada.

• server_time: Hora de recepción del mensaje por el servidor. Indicada según la zona horaria seleccionada.

• gps_fix_type

  • NO_FIX: El rastreador GPS marcó la ubicación como no válida.

  • HAS_FIX: El rastreador GPS marcó la ubicación como válida.

  • LAST_KNOWN_POSITION: En caso de que el rastreador proporcione entrada actual y otros estados dentro de la última ubicación conocida.

  • UNKNOWN: Si un dispositivo no puede proporcionar dicha información o no determinó el tipo de fijación GPS para este paquete.

• lat: Latitud de la ubicación.

• lng: Longitud de la ubicación.

• speed: Velocidad determinada por el rastreador en km/h. En la mayoría de los casos, es la velocidad determinada por el GPS del dispositivo.

• alt: Altitud de la ubicación en metros.

• satellites: Número de satélites conectados en ese momento; -1 significa desconocido y, en la mayoría de los casos, representa un punto de ubicación LBS.

• heading: Rumbo del objeto en grados donde 0 representa el Norte.

• precision: Precisión de la ubicación en metros.

• hdop: Dilución horizontal de la precisión: representa la exactitud de las estimaciones de posición horizontal del rastreador GPS. Los valores van desde 1 (excelente) hasta más de 20 (pobre). Los valores entre 1 y 2 se consideran buenos para la mayoría de los fines de navegación. -1 significa desconocido.

• pdop: Dilución de la posición (PDOP): indica la exactitud de la posición del rastreador GPS en función de la geometría de los satélites en relación con el rastreador. Valores PDOP más bajos significan una mejor ubicación por satélite, lo que conduce a datos de ubicación más precisos, pero -1 significa desconocido.

• mn_name: Nombre de la red móvil. Determinado por el dispositivo.

• mn_roaming: Estado de roaming. Es determinado por el dispositivo.

  • 0 significa sin roaming,

  • 1 significa que este punto fue generado por un dispositivo en roaming,

  • Si el dispositivo no puede proporcionar dichos datos o no pudo hacerlo para este mensaje en particular, será -1 (desconocido).

• mn_code: Código del operador de la red móvil. Determinado por el dispositivo.

• mn_csq: Intensidad de la señal de la red móvil, CSQ, valores de 0 a 31. Determinado por el dispositivo. Si el dispositivo no puede proporcionar dichos datos o no pudo hacerlo para este mensaje en particular, será 99 (desconocido).

• mn_type: Tipo de red móvil. Es determinado por el dispositivo.

  • Si el dispositivo no puede proporcionar dichos datos o no pudo hacerlo para este mensaje en particular, será UNKNOWN

  • GSM: Si el dispositivo determinó el tipo GSM.

  • CDMA: Si el dispositivo determinó el tipo CDMA.

  • WCDMA: Si el dispositivo determinó el tipo WCDMA.

  • LTE: Si el dispositivo determinó el tipo LTE.

  • NR: Si el dispositivo determinó el tipo NR.

• event_id: El ID de evento de la plataforma. Encuentre la lista de todos los códigos de ID de evento a continuación.

IDs de códigos de eventos de la plataforma y sus definiciones

En los paquetes del dispositivo, se pueden definir varios códigos de evento, cada uno significando una ocurrencia específica.

ID de evento	Definición
2	Rastreo. Ningún evento específico, solo un punto de rastreo
4	Número de contacto de emergencia llamado
5	Evento de movimiento no autorizado determinado por el dispositivo
11	Cambio de estado de la entrada 1
12	Cambio de estado de la entrada 2
13	Cambio de estado de la entrada 3
14	Cambio de estado de la entrada 4
15	Cambio de estado de la entrada 5
16	Cambio de estado de la entrada 6
17	Cambio de estado de la entrada 7
18	Cambio de estado de la entrada 8
34	El dispositivo sale del modo de suspensión
37	Inicio del modo de suspensión
40	Baja tensión de alimentación principal
41	Pérdida de energía o corte de alimentación externa
42	Botón de encendido presionado
43	Alimentación recuperada o alimentación externa conectada
44	OBD desconectado del conector del automóvil
45	OBD conectado
46	Batería de reserva del dispositivo baja
50	Fin de inactividad (relacionado con hardware)
51	Inicio de inactividad (relacionado con hardware)
71	Inicio de suspensión por inactividad
72	Inicio de suspensión por batería de reserva baja
73	Despertar por temporizador
74	Despertar por movimiento
75	Despertar por alimentación externa
76	Alerta de suspensión por temporizador
81	Modo de seguridad activado
82	Evento de usuario
83	Evento de pulsación del botón SOS
84	Modo de seguridad desactivado
90	Desconexión de la antena
100	Dispositivo separado del objeto
111	Cambio de estado de la salida 1
112	Cambio de estado de la salida 2
113	Cambio de estado de la salida 3
114	Cambio de estado de la salida 4
115	Cambio de estado de la salida 5
116	Cambio de estado de la salida 6
117	Cambio de estado de la salida 7
118	Cambio de estado de la salida 8
797	Check-in enviado desde la aplicación móvil
798	Envío de formulario de tarea
799	Cambio de estado de trabajo
800	Punto LBS GSM determinado por un dispositivo
802	Punto de rastreo por tiempo
803	Punto de rastreo por distancia
804	Punto de rastreo por ángulo
811	Inicio de movimiento de rastreo
812	Fin de movimiento de rastreo
813	Fin de movimiento no autorizado
814	Mensaje no relacionado con rastreo
900	Cambio de carril brusco por conducción agresiva
901	Interferencia/jamming GPS
928	Desconexión del objeto rastreado
929	Cambio de carril frecuente
930	El dispositivo no puede detectar rostro humano
931	Cinturón de seguridad desabrochado
932	Beber
933	Ojos cerrados
934	Colocar el dispositivo en el objeto rastreado
935	MDSM 7 desconectado
936	MDSM 7 conectado
937	Reportar nuevo conductor
938	El conductor entra en la cabina
939	Inicio de ausencia del conductor
940	El conductor dejó de fumar (Distracción del conductor)
941	Botón de apagado presionado
942	El conductor empezó a fumar (Distracción del conductor)
943	El conductor dejó de usar el teléfono (Distracción del conductor)
944	El conductor empezó a usar el teléfono (Distracción del conductor)
945	Bostezo (Conducción por fatiga)
946	El conductor dejó de distraerse (Distracción del conductor)
947	El conductor empezó a distraerse (Distracción del conductor)
948	El conductor dejó de tener somnolencia (Conducción por fatiga)
949	El conductor empezó a tener somnolencia (Conducción por fatiga)
950	Exceso de velocidad por evento de hardware
951	Control de crucero activado
952	Control de crucero desactivado
953	Inicio de movimiento inesperado
954	Fin de movimiento inesperado
955	Alarma del coche
956	Peatones en zona de peligro (ADAS)
957	Reconocimiento de señales de tráfico (ADAS)
958	Advertencia de colisión con peatones (ADAS)
959	Luz de revisar motor (Check engine)
960	Conducción fatigada
961	Advertencia de distancia (Headway) (ADAS)
962	Salida del carril derecho (ADAS)
963	Salida del carril izquierdo (ADAS)
964	Salida de carril (ADAS)
965	Advertencia de colisión frontal (ADAS)
966	El rastreador entró en geocerca automática
967	El rastreador salió de geocerca automática
968	Forzar respuesta de ubicación por SMS desde la interfaz de usuario
969	Alarma de puerta
970	Encendido del contacto (Ignición apagada)
971	Contacto encendido (Ignición encendida)
972	Conductor no identificado
973	Conductor identificado
974	Cierre del seguro
975	Apertura del seguro
976	Dispositivo apagado
977	Dispositivo encendido
978	Caja cerrada
979	Caja abierta
980	Botón de llamada presionado
981	Sensor de luz determinó oscuridad
982	Sensor de luz determinó luminosidad
983	Fin de vibración
984	Inicio de vibración
985	Perno de correa insertado
986	Perno de correa cortado
987	Conducción brusca: aceleración y giro
988	Conducción brusca: frenado y giro
989	Conducción brusca: giro
990	Conducción brusca: aceleración
991	Conducción brusca: frenado
992	Se recuperó la señal GPS
993	Se perdió la señal GPS
994	Alarma de choque
995	Alarma de atenuación de señal GSM
996	Conducción brusca
997	Pulsera abierta
998	Pulsera cerrada
999	Alerta del sensor G

Parámetros complejos

Los parámetros complejos incluyen tanto el nombre del grupo como el nombre específico. Se categorizan de la siguiente manera:

• flags: Un mapa de bits de banderas que representan la validez de la ubicación y LBS:

  • Bit 0 (location_valid): Indica el estado de validez de la ubicación. Es 0 si la ubicación es inválida, y 1 si la ubicación es válida.

  • Bit 1 (lbs): Indica el estado LBS del punto. Si 0, el punto es recibido por GPS; si 1, el punto es recibido por LBS.

  • Bit 2 (soft_lbs): Indica la fuente del punto LBS. Si 0, el punto está determinado por LBS del dispositivo; si 1, por el LBS de la plataforma.

• discrete_inputs: Representa la información de cada entrada discreta. Cada entrada discreta se presenta en una columna separada, enumerada desde 1. Los valores posibles son 1 y 0, donde 0 significa apagado y 1 significa encendido.

• discrete_outputs : Muestra lo mismo que las entradas discretas pero para salidas discretas. Cada salida discreta está en una columna separada, enumerada desde 1.

• inputs: Representa datos de diferentes sensores, como combustible o varios sensores de medición. Cada entrada está en una columna separada, y la lista de entradas depende del modelo del dispositivo.

• states: Muestra valores de parámetros de estado. La mayoría de ellos pueden ser 1 o 0, pero algunos tienen valores de texto específicos como códigos DTC.

Con estas definiciones, esperamos que le resulte fácil leer la información en los archivos de datos sin procesar y utilizarlos en la resolución de problemas del dispositivo y en programas para sus clientes.