> 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/ru/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file.md).

# Сохранение данных IoT в CSV-файл

В некоторых случаях поставщикам телематических услуг, интеграторам и разработчикам необходимо видеть исходные, неизмененные данные со своих GPS-устройств. Эти необработанные данные часто называют «Сырые данные». Изучение Сырых данных позволяет им глубже понимать собранные данные и получать более ясное представление об их характеристиках.

Изучение Сырые данные также может сократить время, которое требуется, чтобы выяснить, почему устройства работают некорректно. Это означает, что вы сможете быстрее помогать пользователям решать проблемы, что может повысить их доверие к вашему продукту. Кроме того, это позволит вам больше времени уделять созданию новых решений для ваших клиентов.

Более того, недавние достижения в области технологий, искусственного интеллекта и машинного обучения открывают новые способы использования этих данных. Вы можете получить эти Сырые данные и использовать их в других системах (например, CRM, ERP и т. д.) для более глубокого анализа или в разных частях вашего бизнеса. Этот способ помогает вам получать Сырые данные за один шаг вместо сбора данных с устройств и датчиков через разные вызовы API.

Давайте углубимся в «Сырые данные». Опираясь на ценную обратную связь, предоставленную нашими партнерами, а также проводя эксперименты в Navixy Lab, мы сформулировали ниже краткое определение.

{% hint style="info" %}
Обработанные Сырые данные — это результат декодирования (парсинга) входящих пакетов данных с учетом протокола и особенностей модели исходного устройства. После декодирования пакет сохраняется как универсальные параметры платформы, такие как широта, долгота, can\_fuel\_liters и т. д.
{% endhint %}

## Экспорт сырых данных

Благодаря нашим исследованиям и разработкам мы создали новый инструмент. Этот инструмент позволяет TSP, интеграторам, разработчикам и даже опытным пользователям получать разобранные Сырые данные с любого из своих устройств. Они могут собирать данные по любым параметрам за последние 30 дней в формате CSV. Чтобы упростить использование, мы добавили раздел экспорта Сырые данные в пользовательский интерфейс в **Управление устройствами**.

Мы выбрали формат файла CSV за его простоту и широкое распространение. Его легко преобразовать в таблицы или передать программам, использующим искусственный интеллект или машинное обучение.

<figure><img src="/files/062d097a936ebc6b7bbd004551daa474fbf21387" alt=""><figcaption><p>Экспорт сырых данных</p></figcaption></figure>

### Функции экспорта сырых данных

Давайте рассмотрим возможности этого нового инструмента:

* Он позволяет загружать разобранные сырые данные для любого GPS-устройства на платформе Navixy.
* Вы можете выбрать любые параметры из всех доступных моделей устройств, чтобы включить их в файл. Кроме того, вы можете выбрать только те параметры, которые полезны для вашего конкретного задания. Чтобы выбрать параметры, вы легко можете найти в списке доступных вариантов нужное вам GPS-устройство.
* Вам не нужно заранее включать сохранение данных, прежде чем вы захотите получить данные. Все данные со всех устройств автоматически записываются. Вы можете скачать эти данные в любой момент.
* Вы можете получить доступ к разобранным сырым данным за последние 30 дней для любого GPS-устройства.
* Для крупных клиентов, работающих в разных странах и часовых поясах, мы сделали работу с информацией удобнее. Инструмент может корректировать временные метки пакетов, чтобы они соответствовали выбранному вами часовому поясу.

## Типичные сценарии использования экспорта сырых данных

Как мы уже упоминали, этот новый инструмент полезен для всех, кто использует GPS-устройства. Теперь поговорим о некоторых способах, которыми вы можете использовать этот инструмент.

### Аналитика, машинное обучение и ИИ

Вы можете использовать поступающие данные от GPS-устройств в формате, который могут читать машины. Эти данные можно передать искусственному интеллекту или системам машинного обучения для обработки. Способов использования этих данных бесконечно много. Например, ИИ может проверять и выявлять случаи, когда транспорт, его ресурсы и топливо используются неправильно, или строить тепловые карты.

### Проверки конфигурации GPS-устройства

Вы можете проверить, как настроено ваше GPS-устройство, посмотрев данные по параметрам. Вы можете увидеть, задан ли параметр на отправку данных на платформу и поступают ли его данные в пакетах устройства. Например, если данных нет, это значит, что параметр не настроен на отправку либо датчик был отключен от GPS-устройства и передает код ошибки или вообще никакой информации.

### Диагностика данных датчиков

Вы можете проверить, как работает датчик, считывая информацию без множителей и таблиц калибровки. Например, если контакты датчика уровня топлива заржавели, на платформу могут поступать искаженные показания уровня топлива. Такие изменения гораздо труднее заметить по калиброванным данным и отчетам об изменении уровня топлива, чем по сырым данным. Поэтому загруженные данные будут очень полезны для тонкой настройки и исправления некорректной работы. Эти данные также можно использовать для повторной калибровки датчика, если он показывает некорректные данные.

### Диагностика срабатывания правил

Вы можете проверить, как устройства обрабатывают события, отслеживая идентификаторы событий. Вы можете попробовать вручную сгенерировать событие и проверить, срабатывает ли оно на платформе и отправило ли устройство данные о нем.

### Диагностика устройства в состоянии Оффлайн

Вы можете точнее понять, почему устройство перестало отображаться на платформе. Как и другие, это распространенная ситуация. Например, если устройство перестало показываться на платформе, экспорт сырых данных позволяет увидеть, какие данные об уровне сигнала, внутреннем и внешнем уровне заряда батареи отправлялись на платформу до отключения. Возможно, были события отключения, но правило для них не было создано. Без этого инструмента вы могли бы получать информацию о внешней батарее только из отчета, а по событиям без правила пришлось бы обращаться в поддержку. Теперь вы можете отслеживать исторические показания всех параметров одновременно, чтобы найти возможные причины отключения устройства или неполучения данных от устройства.

### Индивидуальные решения для клиентов

Вы можете создавать индивидуальные решения для своих клиентов. Например, клиенту часто нужны данные для аналитики по разным показаниям устройства в одном отчете. Теперь вы можете сделать это с помощью сырых данных устройства. Вы также можете использовать эти данные в Grafana или PowerBi для построения расширенной аналитики.

## Как использовать экспорт Сырые данные

Сначала перейдите в **Управление устройствами** модуль и найдите интересующее вас устройство в пользовательском интерфейсе:

<figure><img src="/files/a4e264bebb837d9826a3f5a0e6bf57a7000bd353" alt=""><figcaption><p>вкладку «Управление устройствами» в пользовательском интерфейсе</p></figcaption></figure>

Или найдите настройки конкретного устройства в Панели администратора:

<figure><img src="/files/7872e28c56f73ed923267989e4c33a579c0fdf62" alt=""><figcaption><p>Настройки Трекера в Панели администратора</p></figcaption></figure>

Затем нажмите **«Экспорт данных»** кнопку в разделе **Сырые данные** блок:

<figure><img src="/files/4596ec7467ef69e5276ab96cd246ff46b93e901d" alt=""><figcaption></figcaption></figure>

Это открывает **Экспорт сырых данных** инструмент. Здесь вам нужно выбрать диапазон дат, часовой пояс и параметры, которые вы хотите включить в файл CSV.

<figure><img src="/files/088a3cf1303511e528dc2c5057b4a0c797e2b309" alt=""><figcaption><p>Окно инструмента экспорта сырых данных</p></figcaption></figure>

Мы позаботились о том, чтобы вы случайно не закрыли окно, щелкнув вне **Экспорт сырых данных** инструмента. Закрыть его можно только, нажав на **X** в правом верхнем углу. Также, если вы не выбрали другое устройство или не обновили страницу, **Экспорт сырых данных** инструмент запоминает все ранее выбранные настройки. Это позволяет легко проверить любые настройки GPS-устройства или датчика, вернуться назад и продолжить работу.

### Выбор диапазона дат

Этот процесс такой же, как при создании истории поездок. Можно выбрать максимум за последние 30 дней.

Выберите диапазон дат, щелкнув по календарю или введя даты вручную. Также можно задать конкретное время. Ниже приведены несколько удобных вариантов для быстрого выбора периода:

* Вчера
* Прошлая неделя
* Последние 30 дней

При нажатии на них платформа автоматически выбирает нужный диапазон.

<figure><img src="/files/60d4416f44954bfd4168763ffaee14760d00a862" alt=""><figcaption><p>Экспорт сырых данных: выбор диапазона дат</p></figcaption></figure>

Чтобы вам было проще, мы добавили счетчик, показывающий, сколько дней вы выбрали. Если вы попробуете выбрать дату более чем 30 дней назад, появится сообщение. Кнопка выбора будет недоступна.

### Выбор часового пояса

Вы можете выбрать любой нужный вам часовой пояс. Например, если вам нужно передавать данные для ИИ или ML, которым нужен один и тот же часовой пояс для всех сообщений, даже если вы предоставляете услуги в разных странах и часовых поясах.

Вот как можно выбрать нужный часовой пояс:

* Выберите один из списка всех доступных часовых поясов.
* Введите название часового пояса.
* Введите часовой пояс, например -8, +2 и т. д.

<figure><img src="/files/5af4ef761b44d888b8a8a1a3c8b974bf50d915d3" alt=""><figcaption><p>Экспорт сырых данных: выбор часового пояса</p></figcaption></figure>

### Выбор параметров

Список доступных параметров может различаться в зависимости от модели. Он включает все возможные параметры, которые были интегрированы в платформу для каждой модели. Всего можно выбрать до 1000 параметров.

Вот что можно сделать:

* Выберите все параметры, установив флажок слева от поиска.
* Выберите только нужные параметры, установив флажок слева от каждого параметра в списке.
* Найдите нужные параметры, введя их название или часть названия.

Если существует несколько входов одного типа, они нумеруются (2, 3, 4...). В этом случае возвращается только вход с наибольшим индексом. Например, если для устройства доступны AVL IO от 1 до 100000, возвращается только avl\_io\_100000, хотя AVL IO с меньшими индексами тоже существуют.

После того как вы выберете такой параметр-индекс справа, платформа попросит указать, какие индексы следует добавить в файл. Введите список чисел, разделенных запятыми, или задайте диапазон чисел через дефис. Например, 1-2, 4, 7.

Для всех параметров и каждого параметра-индекса отображается счетчик, показывающий, сколько из них вы уже выбрали.

Каждый выбранный вами параметр добавит в файл дополнительный столбец.

<figure><img src="/files/19c8a87f28247fdbb93bddcd17a0efaacb9aec84" alt=""><figcaption><p>Экспорт сырых данных: выбор параметров</p></figcaption></figure>

## Скачивание файла сырых данных

После того как вы выберете все параметры, нажмите кнопку **Скачать CSV** чтобы начать загрузку. Вы можете открыть файл в любом текстовом редакторе или программе для просмотра таблиц. В этом CSV-файле данные разделяются запятой.

Имя файла включает идентификатор устройства, метку устройства и диапазон дат и времени в пределах выбранного часового пояса.

Каждая строка, начиная со второй, — это сообщение от устройства, отправленное на платформу. В первой строке всегда показывается время сообщения в выбранном часовом поясе, а в остальных — выбранные вами параметры.

<figure><img src="/files/70e4a090c3e4c001ca748f68d954b39c61f24c3f" alt=""><figcaption><p>Пример столбцов сырых данных</p></figcaption></figure>

Для получения дополнительной информации о чтении и понимании файла сырых данных [следуйте нашей следующей статье](/docs/expert-center/ru/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file/columns-in-csv-file.md).

Надеемся, что этот новый инструмент окажется полезным для вашего бизнеса и ваших клиентов. Он должен позволить вам создавать множество новых решений, используя файлы сырых данных. Помните: даже самые мелкие детали могут привести к большим открытиям. Приятного изучения!


---

# 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/ru/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.
