> 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 дней, появится сообщение. Кнопка выбора будет недоступна.

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

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

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

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

Для получения дополнительной информации о том, как читать и понимать файл сырых данных [ознакомьтесь с нашей следующей статьей](https://navixy.com/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.
