> 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-файл

Экспортируйте необработанные данные IoT-устройств в CSV из Navixy с настраиваемыми параметрами, корректировкой часового пояса и выбором диапазона дат для аналитики и диагностики.

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

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

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

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

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

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

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

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

<figure><img src="https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-b3a072b2b4d5cc36dc303f2438ea22c705469893%2Fimage%20(1)%20(1)%20(1).png?alt=media" alt=""><figcaption><p>Экспорт сырых данных</p></figcaption></figure>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<figure><img src="https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-514741c748c08fabb8bb459931003727be279e0b%2Fimage%20(6).png?alt=media" alt=""><figcaption><p>Интерфейс вкладки «Управление устройствами»</p></figcaption></figure>

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

<figure><img src="https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-068729fe144a270d826b20e5d20cebff2a12f304%2Fimage%20(7).png?alt=media" alt=""><figcaption><p>Настройки Трекера в Панели администратора</p></figcaption></figure>

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

<figure><img src="https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-b7a693bd07600caca249399c27184d2015cbed6b%2Fimage%20(8).png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-969228750fe62c1811c9f67275355a5d15c56ee4%2Fimage%20(9).png?alt=media" alt=""><figcaption><p>Окно инструмента экспорта «Сырые данные»</p></figcaption></figure>

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

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

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

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

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

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

<figure><img src="https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-c29c4e42c02f95675e81757681b4f19582b9a67b%2Fimage%20(10).png?alt=media" alt=""><figcaption><p>Экспорт сырых данных: выбор диапазона дат</p></figcaption></figure>

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

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

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

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

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

<figure><img src="https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-8b2fa6de8db82caeafe04fda92059cb9e9215161%2Fimage%20(11).png?alt=media" 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="https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-4ac4e11cfe78e2a60a30573d74214d9af4e0a07c%2Fimage%20(12).png?alt=media" alt=""><figcaption><p>Экспорт сырых данных: выбор параметров</p></figcaption></figure>

## Загрузка файла сырых данных

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

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

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

<figure><img src="https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-40dbf84a692cebb168cce5028712ee577f6c9159%2Fimage%20(13).png?alt=media" 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.
