> 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 с настраиваемыми параметрами, корректировкой часового пояса и выбором диапазона дат для аналитики и диагностики.

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

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

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

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

{% hint style="info" %}
Сырые данные после разбора — результат декодирования (разбора) входящих пакетов данных с учетом протокола и особенностей модели устройства-источника. После декодирования пакет сохраняется в виде универсальных параметров платформы, таких как широта, долгота, 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
