Colunas no arquivo CSV

A ferramenta de data warehouse permite exportar um arquivo de dados brutos contendo todos os pacotes recebidos do seu dispositivo, sem qualquer filtragem ou cálculos realizados no lado da plataforma. Esses parâmetros representam informações inicialmente decodificadas a partir do pacote do seu dispositivo em formato relacionado ao protocolo, apresentadas de forma legível por humanos. Você não precisa conhecer o protocolo para ler e verificar as informações nesses pacotes.

Para saber como baixar essas informações, você pode consultar nosso artigo anterior. Aqui, temos como objetivo explorar mais detalhadamente como ler este arquivo e interpretar várias colunas nele.

Abrindo um arquivo

O nome do arquivo sempre contém o seguinte:

• ID do dispositivo: O número de ID do dispositivo, frequentemente representando seu IMEI.

• Rótulo do dispositivo na plataforma: Um rótulo para facilitar a busca do arquivo.

• Hora de início e fim: Representando o início e o fim do arquivo no formato dia_mes_ano_horas_minutos_AM/PM.

• Fuso horário em formato UTC.

Você pode abrir o arquivo de dados brutos com qualquer editor de texto, como WordPad, Notepad++ ou Sublime Text. Esse formato é facilmente compreendido por programas e máquinas, mas pode não ser tão claro para pessoas. Para simplificar a leitura do arquivo, recomendamos usar um editor de planilhas. Basta abrir o arquivo CSV com Excel, Google Sheets ou qualquer outro editor de tabelas. No editor de tabelas, todos os parâmetros estarão em suas próprias colunas. Além disso, você pode congelar a primeira linha para ver os nomes das colunas ao longo do arquivo.

Parâmetros dos dados brutos

O arquivo incluirá parâmetros selecionados em colunas, juntamente com uma entrada consistente - msg_time.

Esses parâmetros podem ser categorizados como simples ou complexos.

Colunas simples

Parâmetros simples fornecem nomes completos e representam principalmente informações específicas de rastreamento.

• msg_time: Hora em que o rastreador registrou um ponto. Sempre incluído na saída CSV. Indicado de acordo com o fuso horário escolhido.

• server_time: Hora de recebimento da mensagem pelo servidor. Indicado de acordo com o fuso horário escolhido.

• gps_fix_type

  • NO_FIX: O rastreador GPS marcou a localização como inválida.

  • HAS_FIX: O rastreador GPS marcou a localização como válida.

  • LAST_KNOWN_POSITION: Caso o rastreador forneça entrada atual e outros estados dentro da última localização conhecida.

  • UNKNOWN: Se um dispositivo não puder fornecer tal informação ou não determinou o tipo de fixação GPS para este pacote.

• lat: Latitude da localização.

• lng: Longitude da localização.

• speed: Velocidade determinada pelo rastreador em km/h. Na maioria dos casos, é a velocidade determinada pelo GPS do dispositivo.

• alt: Altitude da localização em metros.

• satellites: Número de satélites conectados naquele momento; -1 significa desconhecido e, na maioria dos casos, representa um ponto de localização LBS.

• heading: Direção do objeto em graus, onde 0 representa o Norte.

• precision: Precisão da localização em metros.

• hdop: Diluição horizontal da precisão - representa a acurácia das estimativas da posição horizontal do rastreador GPS. Os valores variam de 1 (excelente) a acima de 20 (ruim). Valores entre 1 e 2 são considerados bons para a maioria dos propósitos de navegação. -1 significa desconhecido.

• pdop: Diluição da precisão de posição - indica a acurácia da posição do rastreador GPS com base na geometria dos satélites em relação ao rastreador. Valores de PDOP mais baixos significam melhor posicionamento pelos satélites, levando a dados de localização mais precisos, mas -1 significa desconhecido.

• mn_name: Nome da rede móvel. Determinado pelo dispositivo.

• mn_roaming: Status de roaming. É determinado pelo dispositivo.

  • 0 significa sem roaming,

  • 1 significa que este ponto foi gerado por um dispositivo em roaming,

  • Se o dispositivo não puder fornecer tais dados ou não pôde fazê-lo para esta mensagem em particular, ele será -1 (desconhecido).

• mn_code: Código do operador de rede móvel. Determinado pelo dispositivo.

• mn_csq: Intensidade do sinal da rede móvel, CSQ, valores de 0 a 31. Determinado pelo dispositivo. Se o dispositivo não puder fornecer tais dados ou não pôde fazê-lo para esta mensagem em particular, será 99 (desconhecido).

• mn_type: Tipo de rede móvel. É determinado pelo dispositivo.

  • Se o dispositivo não puder fornecer tais dados ou não pôde fazê-lo para esta mensagem em particular, ele será UNKNOWN

  • GSM: Se o dispositivo determinou o tipo GSM.

  • CDMA: Se o dispositivo determinou o tipo CDMA.

  • WCDMA: Se o dispositivo determinou o tipo WCDMA.

  • LTE: Se o dispositivo determinou o tipo LTE.

  • NR: Se o dispositivo determinou o tipo NR.

• event_id: O ID do evento da plataforma. Encontre a lista de todos os códigos de ID de evento abaixo.

IDs de código de evento da plataforma e suas definições

Nos pacotes do dispositivo, vários códigos de evento podem ser definidos, cada um significando uma ocorrência específica.

ID do Evento	Definição
2	Rastreamento. Nenhum evento específico, apenas um ponto de rastreamento
4	Número de contato de emergência chamado
5	Evento de movimento não autorizado determinado pelo dispositivo
11	Mudança de estado da entrada 1
12	Mudança de estado da entrada 2
13	Mudança de estado da entrada 3
14	Mudança de estado da entrada 4
15	Mudança de estado da entrada 5
16	Mudança de estado da entrada 6
17	Mudança de estado da entrada 7
18	Mudança de estado da entrada 8
34	Dispositivo acorda de um modo de suspensão
37	Início do modo de suspensão
40	Energia principal baixa
41	Perda de energia ou corte de energia externa
42	Botão Power On pressionado
43	Energia recuperada ou energia externa conectada
44	OBD desconectado do conector do carro
45	OBD conectado
46	Bateria auxiliar do dispositivo baixa
50	Fim de inatividade (relacionado ao hardware)
51	Início de inatividade (relacionado ao hardware)
71	Início de sono por inatividade
72	Início de sono por bateria auxiliar baixa
73	Despertar por temporizador
74	Despertar por movimento
75	Despertar por energia externa
76	Alerta de sono por temporizador
81	Modo de segurança ativado
82	Evento do usuário
83	Evento de botão SOS pressionado
84	Modo de segurança desativado
90	Desconexão da antena
100	Dispositivo destacado do objeto
111	Mudança de estado da saída 1
112	Mudança de estado da saída 2
113	Mudança de estado da saída 3
114	Mudança de estado da saída 4
115	Mudança de estado da saída 5
116	Mudança de estado da saída 6
117	Mudança de estado da saída 7
118	Mudança de estado da saída 8
797	Check-in enviado pelo aplicativo móvel
798	Envio de formulário de tarefa
799	Alteração do status de trabalho
800	Ponto LBS GSM determinado por um dispositivo
802	Ponto de rastreamento por tempo
803	Ponto de rastreamento por distância
804	Ponto de rastreamento por ângulo
811	Início do movimento de rastreamento
812	Fim do movimento de rastreamento
813	Fim do movimento não autorizado
814	Mensagem não relacionada a rastreamento
900	Mudança rápida de faixa por direção brusca
901	Interferência de GPS
928	Desconectado do objeto rastreado
929	Mudança frequente de faixa
930	Dispositivo não consegue detectar rosto humano
931	Cinto de segurança desabotoado
932	Ingestão de bebida
933	Olhos fechados
934	Anexar dispositivo ao objeto rastreado
935	MDSM 7 desconectado
936	MDSM 7 conectado
937	Relatar novo motorista
938	Motorista entra na cabine
939	Início da ausência do motorista
940	Motorista parou de fumar (distração do motorista)
941	Botão de desligar pressionado
942	Motorista começou a fumar (distração do motorista)
943	Motorista terminou de usar o telefone (distração do motorista)
944	Motorista começou a usar o telefone (distração do motorista)
945	Bocejo (fadiga ao dirigir)
946	Motorista parou distração (distração do motorista)
947	Motorista começou distração (distração do motorista)
948	Motorista parou sonolência (fadiga ao dirigir)
949	Motorista iniciou sonolência (fadiga ao dirigir)
950	Excesso de velocidade por evento de hardware
951	Controle de cruzeiro ligado
952	Controle de cruzeiro desligado
953	Início de movimento inesperado
954	Fim de movimento inesperado
955	Alarme do carro
956	Pedestres na zona de perigo (ADAS)
957	Reconhecimento de sinal de trânsito (ADAS)
958	Alerta de colisão com pedestre (ADAS)
959	Luz de verificação do motor
960	Condução fatigada
961	Alerta de distância segura (Headway) (ADAS)
962	Saída de faixa à direita (ADAS)
963	Saída de faixa à esquerda (ADAS)
964	Saída de faixa (ADAS)
965	Alerta de colisão frontal (ADAS)
966	Rastreador entrou em cerca geográfica automática
967	Rastreador saiu de cerca geográfica automática
968	Forçar resposta de localização por SMS a partir da interface
969	Alarme de porta
970	Ignição desligada
971	Ignição ligada
972	Motorista não identificado
973	Motorista identificado
974	Tranca fechada
975	Tranca aberta
976	Dispositivo desligado
977	Dispositivo ligado
978	Case fechado
979	Case aberto
980	Botão de chamada pressionado
981	Sensor de luz determinou escuridão
982	Sensor de luz determinou claridade
983	Fim de vibração
984	Início de vibração
985	Parafuso da alça inserido
986	Parafuso da alça cortado
987	Aceleração brusca e curva (condução agressiva)
988	Frenagem brusca e curva (condução agressiva)
989	Curva brusca (condução agressiva)
990	Aceleração brusca (condução agressiva)
991	Frenagem brusca (condução agressiva)
992	Sinal GPS recuperado
993	Sinal GPS perdido
994	Alarme de colisão
995	Alarme de atenuação de sinal GSM
996	Direção brusca
997	Pulseira aberta
998	Pulseira fechada
999	Alerta do sensor G

Parâmetros complexos

Parâmetros complexos incluem tanto o nome do grupo quanto o nome específico. Eles são categorizados da seguinte forma:

• flags: Um mapa de bits de flags representando validade da localização e LBS:

  • Bit 0 (location_valid): Indica o status de validade da localização. É 0 se a localização for inválida, e 1 se a localização for válida.

  • Bit 1 (lbs): Indica o status LBS do ponto. Se 0, o ponto é recebido por GPS; se 1, o ponto é recebido por LBS.

  • Bit 2 (soft_lbs): Indica a origem do ponto LBS. Se 0, o ponto é determinado pelo LBS do dispositivo; se 1, pelo LBS da plataforma.

• discrete_inputs: Representa informações de cada entrada discreta. Cada entrada discreta é apresentada em uma coluna separada, enumerada a partir de 1. Os valores possíveis são 1 e 0, onde 0 significa desligado e 1 significa ligado.

• discrete_outputs : Mostra o mesmo que as entradas discretas, mas para saídas discretas. Cada saída discreta está em uma coluna separada, enumerada a partir de 1.

• inputs: Representa dados de diferentes sensores, como combustível ou vários sensores de medição. Cada entrada está em uma coluna separada, e a lista de entradas depende do modelo do dispositivo.

• states: Exibe valores de parâmetros de estado. A maioria pode ser 1 ou 0, mas alguns possuem valores textuais específicos, como códigos DTC.

Com essas definições, esperamos que você ache fácil ler as informações em arquivos de dados brutos e utilizá-las na resolução de problemas do dispositivo e em programas para seus clientes.