> 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-файле
Инструмент data warehouse позволяет вам экспортировать необработанный файл данных, содержащий все пакеты, полученные от вашего устройства, без какой-либо фильтрации или вычислений на стороне платформы. Эти параметры представляют информацию, первоначально декодированную из пакета вашего устройства в формате, связанном с протоколом, и представленную в удобочитаемом виде. Вам не нужно знать протокол, чтобы читать и проверять информацию в этих пакетах.
{% hint style="info" %}
Чтобы узнать, как загрузить эту информацию, вы можете обратиться к нашему [предыдущей статье](/docs/expert-center/ru/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file.md). Здесь мы хотим подробнее рассмотреть, как читать этот файл и интерпретировать различные столбцы в нем.
{% endhint %}
## Открытие файла
Имя файла всегда содержит следующее:
* ID устройства: номер ID устройства, часто представляющий его IMEI.
* Метка устройства на платформе: метка для упрощения поиска файла.
* Время от и до: обозначает начало и конец файла в формате день\_месяц\_год\_часы\_минуты\_AM/PM.
* Часовой пояс в формате UTC.
Вы можете открыть необработанный файл данных в любом текстовом редакторе, таком как WordPad, Notepad++ или Sublime Text. Этот формат легко понимается программами и машинами, но может быть не столь понятен людям. Чтобы упростить чтение файла, мы рекомендуем использовать табличный редактор. Просто откройте CSV-файл в Excel, Google Sheets или любом другом табличном редакторе. В табличном редакторе все параметры будут в своих собственных столбцах. Кроме того, вы можете закрепить первую строку, чтобы видеть названия столбцов по всему файлу.
## Параметры необработанных данных
Файл будет включать выбранные параметры в столбцах, а также одно постоянное значение — msg\_time.
Эти параметры можно разделить на простые и сложные.
### Простые столбцы
Простые параметры содержат полные названия и в основном представляют конкретную информацию трекинга.
* `msg_time`: Время, когда трекер записал точку. Всегда включается в CSV-вывод. Указывается в соответствии с выбранным часовым поясом.
* `server_time`: Время получения сообщения сервером. Указывается в соответствии с выбранным часовым поясом.
* `gps_fix_type`
* NO\_FIX: GPS-трекер отметил местоположение как недействительное.
* HAS\_FIX: GPS-трекер отметил местоположение как действительное.
* LAST\_KNOWN\_POSITION: В случае, если трекер предоставляет текущий вход и другие состояния в пределах последнего известного местоположения.
* UNKNOWN: Если устройство не может предоставить такую информацию или не определило тип GPS-фиксации для этого пакета.
* `lat`: Широта местоположения.
* `lng`: Долгота местоположения.
* `speed`: Скорость, определенная трекером, в км/ч. В большинстве случаев это скорость, определенная GPS устройства.
* `alt`: Высота местоположения в метрах.
* `satellites`: Количество подключенных спутников в тот момент; `-1` означает неизвестно и в большинстве случаев представляет точку местоположения LBS.
* `heading`: Направление объекта в градусах, где 0 обозначает север.
* `precision`: Точность определения местоположения в метрах.
* `hdop`: Горизонтальный фактор снижения точности — представляет точность оценок горизонтального положения GPS-трекера. Значения варьируются от 1 (отлично) до выше 20 (плохо). Значения от 1 до 2 считаются хорошими для большинства навигационных задач. `-1` означает неизвестно.
* `pdop`: Фактор снижения точности позиционирования — указывает на точность положения 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 события платформы. Список всех кодов event ID приведен ниже.
ID кодов событий платформы и их определения
В пакетах устройства могут быть определены различные коды событий, каждый из которых обозначает конкретное происшествие.
| **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 | Нажата кнопка Power On |
| 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 | Индикатор Check Engine |
| 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.