> 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/columns-in-csv-file.md).
# Столбцы в CSV-файле
Справка по структуре CSV-файла с сырыми данными, экспортированного из Navixy: типы параметров, ID событий и о том, как интерпретировать поля GPS, датчиков и состояний.
Инструмент хранилища данных позволяет экспортировать файл сырых данных, содержащий все пакеты, полученные от вашего устройства, без какой-либо фильтрации или вычислений на стороне платформы. Эти параметры представляют собой информацию, первоначально декодированную из пакета вашего устройства в формате, связанном с протоколом, и представленную в человекочитаемом виде. Вам не нужно знать протокол, чтобы читать и проверять информацию в этих пакетах.
{% hint style="info" %}
Чтобы узнать, как скачать эту информацию, см. [Сохранение IoT-данных в CSV-файл](/docs/expert-center/ru/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file.md). Здесь мы подробнее рассмотрим, как читать этот файл и интерпретировать различные столбцы в нем.
{% endhint %}
## Открытие файла
Имя файла содержит следующее:
* ID устройства: номер идентификатора устройства, обычно IMEI устройства. Если ваш поставщик услуг решил скрыть IMEI устройств, вместо него используется платформенный ID объекта.
* Метка устройства на платформе: метка, помогающая искать файл.
* Время от и до: обозначает начало и конец файла в формате день\_месяц\_год\_часы\_минуты\_AM/PM.
* Часовой пояс в формате UTC.
Вы можете открыть файл сырых данных в любом текстовом редакторе, например WordPad, Notepad++ или Sublime Text. Этот формат легко понятен программам и машинам, но может быть не так ясен для людей. Чтобы упростить чтение файла, мы рекомендуем использовать табличный редактор. Просто откройте CSV-файл в Excel, Google Sheets или любом другом табличном редакторе. В табличном редакторе все параметры будут в своих столбцах. Кроме того, вы можете закрепить первую строку, чтобы видеть названия столбцов по всему файлу.
## Параметры сырых данных
Файл включает выбранные параметры в столбцах, а также одно неизменное поле — msg\_time.
Эти параметры можно разделить на простые и сложные.
### Простые столбцы
Простые параметры имеют полные названия и в основном представляют конкретную информацию мониторинга.
* `msg_time`: Время, когда GPS-устройство зафиксировало точку. Всегда включается в CSV-вывод. Указывается согласно выбранному часовому поясу.
* `server_time`: Время получения сообщения сервером. Указывается согласно выбранному часовому поясу.
* `gps_fix_type`
* NO\_FIX: GPS-устройство отметило местоположение как недействительное.
* HAS\_FIX: GPS-устройство отметило местоположение как действительное.
* LAST\_KNOWN\_POSITION: В случае, если GPS-устройство предоставляет текущие входные данные и другие состояния в рамках последнего известного местоположения.
* UNKNOWN: Если устройство не может предоставить такую информацию или не определило тип GPS-фикса для этого пакета.
* `lat`: Широта местоположения.
* `lng`: Долгота местоположения.
* `speed`: Скорость, определенная GPS-устройством, в км/ч. В большинстве случаев это скорость, определенная GPS-устройством.
* `alt`: Высота местоположения над уровнем моря в метрах.
* `satellites`: Количество подключенных спутников в тот момент. `-1` означает неизвестное значение и, в большинстве случаев, представляет точку местоположения LBS.
* `heading`: Направление объекта в градусах, где 0 соответствует северу.
* `precision`: Точность местоположения в метрах.
* `hdop`: Горизонтальное снижение точности, отражает точность оценок горизонтального положения GPS-устройства. Значения варьируются от 1 (отлично) до более 20 (плохо). Значения от 1 до 2 считаются хорошими для большинства навигационных задач. `-1` означает неизвестное значение.
* `pdop`: Снижение точности определения положения, показывает точность определения положения GPS-устройства на основе геометрии спутников относительно GPS-устройства. Более низкие значения PDOP означают лучшее спутниковое позиционирование, что приводит к более точным данным о местоположении, но `-1` означает неизвестное значение.
* `mn_name`: Название мобильной сети. Определяется устройством.
* `mn_roaming`: Статус роуминга. Определяется устройством.
* `0` означает отсутствие роуминга,
* `1` означает, что эта точка была сгенерирована устройством в роуминге,
* Если устройство не может предоставить такие данные или не смогло сделать это для этого конкретного сообщения, это `-1` (неизвестно).
* `mn_code`: Код оператора мобильной сети. Определяется устройством.
* `mn_csq`: Уровень сигнала мобильной сети, CSQ, значения от 0 до 31. Определяется устройством. Если устройство не может предоставить такие данные или не смогло сделать это для этого конкретного сообщения, это `99` (неизвестно).
* `mn_type`: Тип мобильной сети. Определяется устройством.
* Если устройство не может предоставить такие данные или не смогло сделать это для этого конкретного сообщения, это `UNKNOWN`
* `GSM`: Если устройство определило тип GSM.
* `CDMA`: Если устройство определило тип CDMA.
* `WCDMA`: Если устройство определило тип WCDMA.
* `LTE`: Если устройство определило тип LTE.
* `NR`: Если устройство определило тип NR.
* `event_id`: ID события платформы. Ниже приведен список всех кодов ID событий.
Коды событий платформы и их определения
В пакетах устройства могут быть определены различные коды событий, каждый из которых обозначает конкретное событие.
Некоторые протоколы ретрансляции передают этот ID без изменений как свой собственный код события. Смотрите [коды событий Recurso Confiable](/docs/qna/using-navixy/recurso-confiable-event-codes.md) для примера.
| **ID события** | **Определение** |
| -------------- | --------------------------------------------------------------- |
| 2 | Трек. Без конкретного события, только точка трека |
| 4 | Вызов по номеру экстренного контакта |
| 5 | Событие несанкционированного движения, определенное устройством |
| 11 | Изменение состояния входа 1 |
| 12 | Изменение состояния входа 2 |
| 13 | Изменение состояния входа 3 |
| 14 | Изменение состояния входа 4 |
| 15 | Изменение состояния входа 5 |
| 16 | Изменение состояния входа 6 |
| 17 | Изменение состояния входа 7 |
| 18 | Изменение состояния входа 8 |
| 34 | Устройство выходит из режима сна |
| 37 | Начало режима сна |
| 40 | Низкий уровень основного питания |
| 41 | Потеря питания или Отключение внешнего питания |
| 42 | Нажата кнопка включения питания |
| 43 | Питание восстановлено или подключено внешнее питание |
| 44 | OBD отключен от автомобильного разъема |
| 45 | OBD подключен |
| 46 | Низкий заряд аккумулятора резервного устройства |
| 50 | Конец простоя (аппаратная функция) |
| 51 | Начало простоя (аппаратная функция) |
| 71 | Начало сна в простое |
| 72 | Начало сна при низком заряде резервного аккумулятора |
| 73 | Пробуждение по таймеру |
| 74 | Пробуждение по движению |
| 75 | Пробуждение от внешнего питания |
| 76 | Оповещение о сне по таймеру |
| 81 | Режим охраны включен |
| 82 | Пользовательское событие |
| 83 | Событие нажатия кнопки SOS |
| 84 | Режим охраны выключен |
| 90 | Отсоединение антенны |
| 100 | Устройство отсоединено от объекта |
| 111 | Изменение состояния выхода 1 |
| 112 | Изменение состояния выхода 2 |
| 113 | Изменение состояния выхода 3 |
| 114 | Изменение состояния выхода 4 |
| 115 | Изменение состояния выхода 5 |
| 116 | Изменение состояния выхода 6 |
| 117 | Изменение состояния выхода 7 |
| 118 | Изменение состояния выхода 8 |
| 797 | Отметка, отправленная из мобильного приложения |
| 798 | Отправка формы задания |
| 799 | Изменение рабочего статуса |
| 800 | Точка GSM LBS, определенная устройством |
| 802 | Точка трека по времени |
| 803 | Точка трека по расстоянию |
| 804 | Точка трека по углу |
| 811 | Начало движения по треку |
| 812 | Конец движения по треку |
| 813 | Завершение несанкционированного движения |
| 814 | Сообщение без трека |
| 900 | Опасное вождение: резкая смена полосы |
| 901 | Попытка GPS глушения (потеря связи) |
| 928 | Отсоединение от отслеживаемого объекта |
| 929 | Частая смена полосы |
| 930 | Устройство не может обнаружить лицо человека |
| 931 | Ремень безопасности не пристегнут |
| 932 | Пьет |
| 933 | Глаза закрыты |
| 934 | Присоединение устройства к отслеживаемому объекту |
| 935 | MDSM 7 отключен |
| 936 | MDSM 7 подключен |
| 937 | Сообщение о новом водителе |
| 938 | Водитель входит в кабину |
| 939 | Начало отсутствия водителя |
| 940 | Водитель перестал курить (отвлечение водителя) |
| 941 | Нажата кнопка выключения питания |
| 942 | Водитель начал курить (отвлечение водителя) |
| 943 | Водитель закончил пользоваться телефоном (отвлечение водителя) |
| 944 | Водитель начал пользоваться телефоном (отвлечение водителя) |
| 945 | Зевота (Контроль усталости водителя) |
| 946 | Водитель перестал отвлекаться (отвлечение водителя) |
| 947 | Водитель начал отвлекаться (отвлечение водителя) |
| 948 | Водитель перестал дремать (Контроль усталости водителя) |
| 949 | Водитель начал дремать (Контроль усталости водителя) |
| 950 | Превышение скорости по аппаратному событию |
| 951 | Круиз-контроль включен |
| 952 | Круиз-контроль выключен |
| 953 | Начало неожиданного движения |
| 954 | Конец неожиданного движения |
| 955 | Автомобильная сигнализация |
| 956 | Пешеходы в опасной зоне (ADAS) |
| 957 | Распознавание дорожных знаков (ADAS) |
| 958 | Предупреждение о столкновении с пешеходом (ADAS) |
| 959 | Индикатор проверки двигателя |
| 960 | Контроль усталости водителя |
| 961 | Предупреждение о дистанции (ADAS) |
| 962 | Съезд с полосы вправо (ADAS) |
| 963 | Съезд с полосы влево (ADAS) |
| 964 | Съезд с полосы (ADAS) |
| 965 | Предупреждение о фронтальном столкновении (ADAS) |
| 966 | Трекер вошел в автоматическую зону |
| 967 | Трекер вышел из автоматической зоны |
| 968 | Принудительный ответ о местоположении по SMS из UI |
| 969 | Дверная тревога |
| 970 | Зажигание выключено |
| 971 | Зажигание включено |
| 972 | Водитель не идентифицирован |
| 973 | Водитель идентифицирован |
| 974 | Замок закрыт |
| 975 | Замок открыт |
| 976 | Питание устройства выключено |
| 977 | Питание устройства включено |
| 978 | Корпус закрыт |
| 979 | Корпус открыт |
| 980 | Нажата кнопка вызова |
| 981 | Датчик освещенности определил темноту |
| 982 | Датчик освещенности определил яркость |
| 983 | Конец вибрации |
| 984 | Начало вибрации |
| 985 | Болт крепления вставлен |
| 986 | Болт крепления перерезан |
| 987 | Опасное вождение: ускорение и поворот |
| 988 | Опасное вождение: торможение и поворот |
| 989 | Опасное вождение: поворот |
| 990 | Опасное вождение: ускорение |
| 991 | Опасное вождение: торможение |
| 992 | Сигнал GPS восстановлен |
| 993 | Сигнал GPS потерян |
| 994 | Тревога при столкновении |
| 995 | Тревога затухания сигнала GSM |
| 996 | Опасное вождение |
| 997 | Браслет открыт |
| 998 | Браслет закрыт |
| 999 | Оповещение G-датчика |
### Сложные параметры
Сложные параметры включают как название группы, так и конкретное название. Они классифицируются следующим образом:
* `flags`: Битовая карта флагов, отражающая валидность местоположения и LBS:
* Бит 0 (location\_valid): Указывает статус валидности местоположения. Это `0` если местоположение недействительно, и `1` если местоположение действительно.
* Бит 1 (lbs): Указывает статус LBS точки. Если `0`, точка получена по GPS; если `1`, точка получена по LBS.
* Бит 2 (soft\_lbs): Указывает источник LBS точки. Если `0`, точка определяется устройством по LBS; если `1`, по LBS платформы.
* `discrete_inputs`: Отражает информацию от каждого дискретного входа. Каждый дискретный вход представлен в отдельном столбце, нумеруемом с 1. Возможные значения — 1 и 0, где 0 означает выключено, а 1 — включено.
* `discrete_outputs` : Показывает то же самое, что и дискретные входы, но для дискретных выходов. Каждый дискретный выход находится в отдельном столбце, нумеруемом с 1.
* `inputs`: Отражает данные от разных датчиков, таких как топливо или различные Измерительные датчики. Каждый вход расположен в отдельном столбце, а список входов зависит от модели устройства.
* `states`: Отображает значения параметров состояния. Большинство из них могут быть 1 или 0, но некоторые имеют специальные текстовые значения, например коды DTC.
С учетом этих определений мы надеемся, что вам будет легко читать информацию в файлах сырых данных и использовать ее при устранении неполадок устройства и в программах для ваших клиентов.
---
# 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/columns-in-csv-file.md?ask=&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.