> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/expert-center/pt-br/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file.md).

# Salvar dados IoT em arquivo CSV

Em certas situações, TSPs, integradores e desenvolvedores precisam ver os dados originais, sem alterações, de seus dispositivos GPS. Esses dados não adulterados são frequentemente chamados de "dados brutos". Consultar os dados brutos permite que eles obtenham uma compreensão mais profunda dos dados coletados e uma perspectiva mais clara de suas características.

Examinar dados brutos também pode reduzir o tempo gasto para descobrir por que os dispositivos não estão funcionando corretamente. Isso significa que você pode ajudar os usuários a resolver problemas mais rapidamente, o que pode fazer com que eles confiem mais no seu produto. Além disso, isso permite que você passe mais tempo criando novas soluções para seus clientes.

Além disso, os recentes avanços em tecnologia, inteligência artificial e aprendizado de máquina estão criando novas maneiras de usar esses dados. Você pode obter esses dados brutos e usá-los em outros sistemas (isto é, CRM, ERP etc.) para uma análise mais aprofundada ou em outras partes do seu negócio. Dessa forma, você consegue recuperar dados brutos em uma única etapa, em vez de coletar dados de dispositivos e sensores por meio de diferentes chamadas de API.

Vamos nos aprofundar nos "dados brutos". Com base no valioso feedback fornecido por nossos parceiros, bem como em experimentos realizados no Navixy Lab, elaboramos uma definição concisa abaixo.

{% hint style="info" %}
Os dados brutos analisados são o resultado após a decodificação (análise) dos pacotes de dados recebidos, considerando o protocolo e as especificidades do modelo do dispositivo de origem. Após a decodificação, o pacote é armazenado como parâmetros universais da plataforma, como latitude, longitude, can\_fuel\_liters, etc.
{% endhint %}

## Exportação de dados brutos

A partir da nossa pesquisa e desenvolvimento, criamos uma nova ferramenta. Essa ferramenta permite que TSPs, integradores, desenvolvedores e até usuários avançados obtenham dados brutos analisados de qualquer um de seus dispositivos. Eles podem coletar dados sobre quaisquer parâmetros dos últimos 30 dias em formato CSV. Para facilitar o uso, adicionamos uma seção de exportação de dados brutos à interface do usuário em **Dispositivos e configurações**.

Escolhemos o formato de arquivo CSV pela sua simplicidade e pelo uso comum. É fácil transformá-lo em tabelas ou fornecê-lo a programas que usam inteligência artificial ou aprendizado de máquina.

<figure><img src="/files/cc61ea41fa263e420f13d9f93271fb978a05faeb" alt=""><figcaption><p>Exportação de dados brutos</p></figcaption></figure>

### Recursos de exportação de dados brutos

Vamos explorar os recursos desta nova ferramenta:

* Ela permite que você faça upload de dados brutos analisados de qualquer dispositivo GPS na plataforma Navixy.
* Você pode escolher quaisquer parâmetros de todos os modelos de dispositivos disponíveis para incluir no seu arquivo. Além disso, você pode selecionar apenas os parâmetros que são úteis para a sua tarefa específica. Para escolher parâmetros, você pode pesquisar facilmente na lista de opções disponíveis para o dispositivo GPS escolhido.
* Não é necessário ativar o salvamento de dados antes de você desejar obter os dados. Todos os dados de todos os dispositivos são registrados automaticamente. Você pode baixar esses dados quando quiser.
* Você pode acessar até 30 dias de dados brutos analisados de qualquer dispositivo GPS.
* Para grandes clientes que operam em diferentes países e fusos horários, facilitamos o trabalho com as informações. A ferramenta pode ajustar os carimbos de data e hora dos pacotes para corresponder ao fuso horário selecionado.

## Casos de uso típicos para exportação de dados brutos

Como mencionamos antes, esta nova ferramenta é útil para qualquer pessoa que use dispositivos GPS. Agora, vamos falar sobre algumas das maneiras pelas quais você pode usar esta ferramenta.

### Análise de dados, aprendizado de máquina e IA

Você pode usar os dados recebidos de dispositivos GPS em um formato legível por máquinas. Esses dados podem ser fornecidos à inteligência artificial ou ao aprendizado de máquina para processamento. Há inúmeras maneiras de usar esses dados. Por exemplo, a IA poderia verificar e indicar quando os veículos, seus recursos e o combustível estão sendo usados de forma inadequada, ou poderia criar mapas de calor.

### Verificações de configuração do dispositivo GPS

Você pode verificar como seu dispositivo GPS está configurado observando os dados dos parâmetros. Você pode ver se um parâmetro está configurado para enviar dados à plataforma e se os dados dele são recebidos nos pacotes do dispositivo. Por exemplo, se não houver dados, isso significa que o parâmetro não está configurado para enviar dados ou que o sensor foi desconectado do dispositivo GPS e está enviando um código de erro ou nenhuma informação.

### Diagnóstico dos dados do sensor

Você pode verificar como o sensor está funcionando lendo informações sem multiplicadores ou tabelas de calibração. Por exemplo, se os contatos do sensor de combustível tiverem enferrujado, a plataforma pode receber leituras distorcidas do nível de combustível. É muito mais difícil identificar essas mudanças usando dados calibrados e relatórios de Mudança no nível de combustível do que dados brutos. Portanto, os dados baixados serão muito úteis para ajustes finos e para corrigir o funcionamento incorreto. Os dados também podem ser usados para recalibrar o sensor se ele estiver exibindo dados incorretos.

### Diagnósticos para o disparo de regras

Você pode verificar como os dispositivos processam eventos acompanhando os IDs dos eventos. Você pode tentar disparar manualmente um evento e testar se a plataforma aciona o evento e se o dispositivo enviou dados sobre ele.

### Diagnóstico de dispositivo fora de linha

Você pode descobrir com mais precisão por que um dispositivo está fora de linha. Como nos outros casos, essa é uma situação comum. Por exemplo, se o dispositivo parou de aparecer na plataforma, exportar dados brutos permite ver quais dados sobre intensidade do sinal, nível da bateria interna e externa estavam sendo enviados à plataforma antes da desconexão. Pode ter havido alguns eventos de desconexão, mas nenhuma regra foi criada. Sem essa ferramenta, você só poderia coletar informações sobre a bateria externa por meio de um relatório, e, para eventos sem regra, teria de verificar com o suporte. Agora, você pode acompanhar as leituras históricas de todos os parâmetros de uma vez para encontrar possíveis motivos para o dispositivo se desconectar ou para não receber dados do dispositivo.

### Soluções personalizadas para clientes

Você pode criar soluções personalizadas para seus clientes. Por exemplo, um cliente muitas vezes precisa de dados para análises sobre diferentes leituras do dispositivo em um único relatório. Agora, você pode fazer isso usando dados brutos do dispositivo. Você também pode usar esses dados no Grafana ou no Power BI para criar análises avançadas.

## Como usar a exportação de dados brutos

Primeiro, acesse o **Dispositivos e configurações** módulo e procure pelo dispositivo de seu interesse na interface do usuário:

<figure><img src="/files/6be0d6cf12acab1e79ffe3f0979c51b82d14347b" alt=""><figcaption><p>Interface da guia Dispositivos e configurações</p></figcaption></figure>

Ou, encontre as configurações de um dispositivo específico no painel administrativo:

<figure><img src="/files/79c701816fac32718bb8ef0c7492d9aaa41a4931" alt=""><figcaption><p>Configurações do rastreador no painel administrativo</p></figcaption></figure>

Em seguida, clique no **Exportar dados** botão em **Dados brutos** bloco:

<figure><img src="/files/470fde6201b4ed312267cf58fba8ab19a45942b9" alt=""><figcaption></figcaption></figure>

Isso abre a **Exportação de dados brutos** ferramenta. Aqui, você precisa escolher o intervalo de datas, o fuso horário e os parâmetros que deseja incluir em um arquivo csv.

<figure><img src="/files/bf1c20e7fd4ea97dac73671690b11e162e579b38" alt=""><figcaption><p>Janela da ferramenta de exportação de dados brutos</p></figcaption></figure>

Garantimos que você não feche acidentalmente a janela ao clicar fora da **Exportação de dados brutos** ferramenta. Você só pode fechá-la clicando no **X** no canto superior direito. Além disso, se você não tiver escolhido outro dispositivo ou atualizado a página, a **Exportação de dados brutos** ferramenta lembra todas as configurações que você selecionou anteriormente. Isso facilita verificar as configurações de qualquer dispositivo GPS ou sensor, voltar e continuar trabalhando.

### Escolhendo o intervalo de datas

Esse processo é exatamente como quando você está criando um histórico de viagens. Você pode escolher no máximo os últimos 30 dias.

Selecione um intervalo de datas clicando no calendário ou digitando as datas manualmente. Você também pode definir um horário específico. Aqui estão algumas opções úteis para escolher rapidamente um período:

* Ontem
* Na semana passada
* Últimos 30 dias

Quando você clica nelas, a plataforma seleciona automaticamente o intervalo correto.

<figure><img src="/files/5c9000d66a5ef35da9f7351a2ef8b6cd7a05a8c2" alt=""><figcaption><p>Exportação de dados brutos Seletor de intervalo de datas</p></figcaption></figure>

Para facilitar, adicionamos um contador de quantos dias você selecionou. Se você tentar escolher uma data com mais de 30 dias, receberá uma mensagem. O botão de seleção não ficará disponível.

### Escolhendo um fuso horário

Você pode escolher qualquer fuso horário de que precisar. Por exemplo, se você precisar fornecer dados para IA ou ML, que exigem um único fuso horário para todas as mensagens, mesmo que esteja prestando serviços em diferentes países e fusos horários.

Veja como você pode escolher o fuso horário desejado:

* Escolha um em uma lista de todos os fusos horários possíveis.
* Digite o nome do fuso horário.
* Digite o fuso horário, por exemplo -8, +2, etc.

<figure><img src="/files/9333cfd61ba0a760a5ea9cbb5394f613809d2eef" alt=""><figcaption><p>Exportação de dados brutos Seletor de fuso horário</p></figcaption></figure>

### Selecionando parâmetros

A lista de parâmetros entre os quais você pode escolher pode variar conforme o modelo. Ela inclui todos os parâmetros possíveis que foram integrados à plataforma para cada modelo. Você pode selecionar até 1000 parâmetros no total.

Veja o que você pode fazer:

* Selecione todos os parâmetros clicando na caixa de seleção à esquerda da pesquisa.
* Escolha apenas os parâmetros de que você precisa clicando na caixa de seleção à esquerda de cada parâmetro na lista.
* Encontre os parâmetros de que você precisa digitando o nome deles ou parte do nome.

Se houver mais de uma entrada do mesmo tipo, elas são numeradas (2, 3, 4...). Nesse caso, apenas a entrada com o maior índice é retornada. Por exemplo, se AVL IOs de 1 a 100000 estiverem disponíveis para um dispositivo, apenas avl\_io\_100000 é retornado, embora também existam AVL IOs com índices menores.

Depois que você selecionar esse parâmetro de índice no lado direito, a plataforma solicitará que você especifique quais índices devem ser adicionados ao arquivo. Digite uma lista de números separados por vírgulas ou defina um intervalo de números com um hífen. Por exemplo, 1-2, 4, 7.

Para todos os parâmetros e para cada parâmetro de índice, você vê uma contagem mostrando quantos já escolheu.

Cada parâmetro que você escolher adicionará uma coluna extra ao arquivo.

<figure><img src="/files/30cff1d87d68a68334d41caf871ccb3ef1183590" alt=""><figcaption><p>Exportação de dados brutos Seleção de parâmetros</p></figcaption></figure>

## Baixando o arquivo de dados brutos

Depois de escolher todos os parâmetros, clique no **Baixar CSV** botão para iniciar o download. Você pode abrir o arquivo com qualquer editor de texto ou visualizador de tabelas. Esse arquivo CSV usa uma vírgula para separar os dados.

O nome do arquivo inclui o ID do dispositivo, o rótulo do dispositivo e o intervalo de data e hora dentro do fuso horário.

Cada linha, a partir da segunda, é uma mensagem do dispositivo enviada para a plataforma. A primeira linha sempre mostra o horário da mensagem no fuso horário selecionado, e o restante são os parâmetros que você selecionou.

<figure><img src="/files/f40c8b0d38a72611641bb4f598b6cf47cb07b654" alt=""><figcaption><p>Exemplo de colunas de dados brutos</p></figcaption></figure>

Para mais informações sobre como ler e entender o arquivo de dados brutos [leia o próximo artigo](/docs/expert-center/pt-br/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file/columns-in-csv-file.md).

Esperamos que essa nova ferramenta seja útil para o seu negócio e para os seus clientes. Ela deve permitir que você crie muitas novas soluções usando arquivos de dados brutos. Lembre-se: até os menores detalhes podem levar a grandes descobertas. Boa exploração!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/expert-center/pt-br/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
