> 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 %}
## Открытие файла
Имя файла содержит следующее:
* Идентификатор устройства: номер устройства, обычно IMEI устройства. Если ваш поставщик услуг решил скрыть IMEI устройств, вместо него используется ID объекта на платформе.
* Метка устройства на платформе: метка, помогающая искать файл.
* Время начала и окончания: обозначает начало и конец файла в формате day\_month\_year\_hours\_minutes\_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`: Идентификатор события платформы. Ниже приведен список всех кодов идентификаторов событий.
Коды событий платформы и их определения
В пакетах устройства могут быть определены различные коды событий, каждый из которых обозначает определенное событие.
Некоторые протоколы ретрансляции данных передают этот идентификатор без изменений как свой собственный код события. См. [коды событий Recurso Confiable](/docs/qna/using-navixy/recurso-confiable-event-codes.md) для примера.
| **Идентификатор события** | **Определение** |
| ------------------------- | ------------------------------------------------------------------ |
| 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 | Точка LBS в GSM, определенная устройством |
| 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 из интерфейса |
| 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 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/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 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.