> 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/id/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file/columns-in-csv-file.md).

# Kolom dalam file CSV

Referensi untuk struktur file data mentah CSV yang diekspor dari Navixy: jenis parameter, ID kejadian, dan cara menafsirkan bidang GPS, sensor, dan state.

Alat data warehouse memungkinkan Anda mengekspor file data mentah yang memuat semua paket yang diterima dari perangkat Anda, tanpa penyaringan atau perhitungan apa pun di sisi platform. Parameter ini merepresentasikan informasi yang awalnya didekode dari paket perangkat Anda dalam format terkait protokol, disajikan dalam bentuk yang dapat dibaca manusia. Anda tidak perlu mengetahui protokol untuk membaca dan memeriksa informasi dalam paket ini.

{% hint style="info" %}
Untuk mempelajari cara mengunduh informasi ini, lihat [Simpan data IoT ke file CSV](https://navixy.com/docs/expert-center/id/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file.md). Di sini, kami bertujuan untuk mengeksplorasi lebih lanjut cara membaca file ini dan menafsirkan berbagai kolom di dalamnya.
{% endhint %}

## Membuka file

Nama file memuat hal berikut:

* ID perangkat: Nomor ID perangkat, biasanya IMEI perangkat. Jika penyedia layanan Anda memilih untuk menyembunyikan IMEI perangkat, ID platform objek digunakan sebagai gantinya.
* Label perangkat pada platform: Label untuk membantu pencarian file.
* Waktu dari dan hingga: Merepresentasikan awal dan akhir file dalam format hari\_bulan\_tahun\_jam\_menit\_AM/PM.
* Zona waktu dalam format UTC.

Anda dapat membuka file data mentah dengan editor teks apa pun, seperti WordPad, Notepad++, atau Sublime Text. Format ini mudah dipahami oleh program dan mesin, tetapi mungkin kurang jelas bagi manusia. Untuk memudahkan pembacaan file, kami merekomendasikan penggunaan editor tabel. Cukup buka file CSV dengan Excel, Google Sheets, atau editor tabel lainnya. Di editor tabel, semua parameter akan berada dalam kolomnya masing-masing. Selain itu, Anda dapat membekukan baris pertama untuk melihat nama kolom di sepanjang file.

## Parameter data mentah

File ini mencakup parameter terpilih dalam kolom, bersama satu entri yang konsisten, msg\_time.

![](https://3546701789-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-2f5edca71dd9b788133c28403e6c7f4d95373331%2Fimage-20240209-073506.png?alt=media\&token=67ddd84f-aa04-4f86-b9c5-f630eb575a8f)

Parameter ini dapat dikategorikan sebagai sederhana atau kompleks.

### Kolom sederhana

Parameter sederhana menyediakan nama lengkap dan terutama merepresentasikan informasi pelacakan tertentu.

* `msg_time`: Waktu saat perangkat GPS merekam titik. Selalu disertakan dalam keluaran CSV. Ditunjukkan sesuai dengan zona waktu yang dipilih.
* `server_time`: Waktu penerimaan pesan oleh server. Ditunjukkan sesuai dengan zona waktu yang dipilih.
* `gps_fix_type`
  * NO\_FIX: Perangkat GPS menandai lokasi sebagai tidak valid.
  * HAS\_FIX: Perangkat GPS menandai lokasi sebagai valid.
  * LAST\_KNOWN\_POSITION: Jika perangkat GPS menyediakan input saat ini dan status lain dalam lokasi terakhir yang diketahui.
  * UNKNOWN: Jika perangkat tidak dapat menyediakan informasi tersebut atau tidak menentukan jenis fix GPS untuk paket ini.
* `lat`: Lintang lokasi.
* `lng`: Bujur lokasi.
* `speed`: Kecepatan yang ditentukan oleh perangkat GPS dalam km/jam. Dalam kebanyakan kasus, ini adalah kecepatan yang ditentukan oleh GPS perangkat.
* `alt`: Ketinggian lokasi dalam meter.
* `satellites`: Jumlah satelit yang terhubung pada saat itu. `-1` berarti tidak diketahui dan, dalam kebanyakan kasus, merepresentasikan titik lokasi LBS.
* `heading`: Arah objek dalam derajat, dengan 0 mewakili utara.
* `precision`: Ketelitian lokasi dalam meter.
* `hdop`: Pengenceran presisi horizontal, merepresentasikan akurasi estimasi posisi horizontal perangkat GPS. Nilai berkisar dari 1 (sangat baik) hingga di atas 20 (buruk). Nilai antara 1 dan 2 dianggap baik untuk sebagian besar keperluan navigasi. `-1` berarti tidak diketahui.
* `pdop`: Pengenceran presisi posisi, menunjukkan akurasi posisi perangkat GPS berdasarkan geometri satelit relatif terhadap perangkat GPS. Nilai PDOP yang lebih rendah berarti penentuan posisi satelit yang lebih baik, sehingga menghasilkan data lokasi yang lebih akurat, tetapi `-1` berarti tidak diketahui.
* `mn_name`: Nama jaringan seluler. Ditentukan oleh perangkat.
* `mn_roaming`: Status roaming. Ditentukan oleh perangkat.
  * `0` berarti tidak roaming,
  * `1` berarti titik ini dihasilkan oleh perangkat dalam roaming,
  * Jika perangkat tidak dapat menyediakan data tersebut atau tidak dapat melakukannya untuk pesan ini, nilainya adalah `-1` (tidak diketahui).
* `mn_code`: Kode operator jaringan seluler. Ditentukan oleh perangkat.
* `mn_csq`: Kekuatan sinyal jaringan seluler, CSQ, dengan nilai dari 0 hingga 31. Ditentukan oleh perangkat. Jika perangkat tidak dapat menyediakan data tersebut atau tidak dapat melakukannya untuk pesan ini, nilainya adalah `99` (tidak diketahui).
* `mn_type`: Jenis jaringan seluler. Ditentukan oleh perangkat.
  * Jika perangkat tidak dapat menyediakan data tersebut atau tidak dapat melakukannya untuk pesan ini, nilainya adalah `UNKNOWN`
  * `GSM`: Jika perangkat menentukan jenis GSM.
  * `CDMA`: Jika perangkat menentukan jenis CDMA.
  * `WCDMA`: Jika perangkat menentukan jenis WCDMA.
  * `LTE`: Jika perangkat menentukan jenis LTE.
  * `NR`: Jika perangkat menentukan jenis NR.
* `event_id`: ID peristiwa platform. Temukan daftar semua kode ID peristiwa di bawah.

<details>

<summary>ID kode peristiwa platform dan definisinya</summary>

Dalam paket perangkat, berbagai kode peristiwa dapat didefinisikan, masing-masing menandakan kejadian tertentu.

Beberapa protokol penerusan data meneruskan ID ini tanpa perubahan sebagai kode peristiwa mereka sendiri. Lihat [kode peristiwa Recurso Confiable](https://navixy.com/docs/qna/using-navixy/recurso-confiable-event-codes.md) sebagai contoh.

| **ID peristiwa** | **Definisi**                                               |
| ---------------- | ---------------------------------------------------------- |
| 2                | Lintasan. Tidak ada peristiwa khusus, hanya titik lintasan |
| 4                | Panggilan ke nomor kontak darurat                          |
| 5                | Peristiwa gerakan tidak sah yang ditentukan oleh perangkat |
| 11               | Perubahan status masukan 1                                 |
| 12               | Perubahan status masukan 2                                 |
| 13               | Perubahan status masukan 3                                 |
| 14               | Perubahan status masukan 4                                 |
| 15               | Perubahan status masukan 5                                 |
| 16               | Perubahan status masukan 6                                 |
| 17               | Perubahan status masukan 7                                 |
| 18               | Perubahan status masukan 8                                 |
| 34               | Perangkat bangun dari mode tidur.                          |
| 37               | Awal mode tidur                                            |
| 40               | Daya utama rendah                                          |
| 41               | Daya hilang atau daya eksternal dipotong                   |
| 42               | Tombol daya hidup ditekan                                  |
| 43               | Daya pulih atau daya eksternal tersambung                  |
| 44               | OBD dicabut dari konektor mobil                            |
| 45               | OBD dicolokkan                                             |
| 46               | Baterai cadangan perangkat rendah                          |
| 50               | Akhir idle (terkait perangkat keras)                       |
| 51               | Awal idle (terkait perangkat keras)                        |
| 71               | Awal tidur idle                                            |
| 72               | Awal tidur saat baterai cadangan lemah                     |
| 73               | Bangun karena timer                                        |
| 74               | Bangun karena gerakan                                      |
| 75               | Bangun karena daya eksternal                               |
| 76               | Peringatan tidur karena timer                              |
| 81               | Mode keamanan aktif                                        |
| 82               | Peristiwa pengguna                                         |
| 83               | Peristiwa tombol SOS ditekan                               |
| 84               | Mode keamanan nonaktif                                     |
| 90               | Antena terputus                                            |
| 100              | Perangkat terlepas dari objek                              |
| 111              | Perubahan status keluaran 1                                |
| 112              | Perubahan status keluaran 2                                |
| 113              | Perubahan status keluaran 3                                |
| 114              | Perubahan status keluaran 4                                |
| 115              | Perubahan status keluaran 5                                |
| 116              | Perubahan status keluaran 6                                |
| 117              | Perubahan status keluaran 7                                |
| 118              | Perubahan status keluaran 8                                |
| 797              | Check-in dikirim dari aplikasi seluler                     |
| 798              | Pengajuan formulir tugas                                   |
| 799              | Perubahan status kerja                                     |
| 800              | Titik LBS GSM ditentukan oleh perangkat                    |
| 802              | Titik lintasan berdasarkan waktu                           |
| 803              | Titik lintasan berdasarkan jarak                           |
| 804              | Titik lintasan berdasarkan sudut                           |
| 811              | Awal pergerakan lintasan                                   |
| 812              | Akhir pergerakan lintasan                                  |
| 813              | Akhir gerakan tidak sah                                    |
| 814              | Pesan non-lintasan                                         |
| 900              | Perubahan jalur cepat saat pengemudian kasar               |
| 901              | Gangguan GPS                                               |
| 928              | Dilepas dari objek yang dilacak                            |
| 929              | Perubahan jalur yang sering                                |
| 930              | Perangkat tidak dapat mendeteksi wajah manusia             |
| 931              | Sabuk pengaman terlepas                                    |
| 932              | Minum                                                      |
| 933              | Mata tertutup                                              |
| 934              | Pasang perangkat pada objek yang dilacak                   |
| 935              | MDSM 7 terputus                                            |
| 936              | MDSM 7 tersambung                                          |
| 937              | Supir baru dilaporkan                                      |
| 938              | Supir memasuki kabin                                       |
| 939              | Awal ketidakhadiran supir                                  |
| 940              | Supir berhenti merokok (distraksi supir)                   |
| 941              | Tombol daya mati ditekan                                   |
| 942              | Supir mulai merokok (distraksi supir)                      |
| 943              | Supir selesai menggunakan ponsel (distraksi supir)         |
| 944              | Supir mulai menggunakan ponsel (distraksi supir)           |
| 945              | Menguap (mengemudi saat lelah)                             |
| 946              | Supir berhenti terdistraksi (distraksi supir)              |
| 947              | Supir mulai terdistraksi (distraksi supir)                 |
| 948              | Supir berhenti mengantuk (mengemudi saat lelah)            |
| 949              | Supir mulai mengantuk (mengemudi saat lelah)               |
| 950              | Kecepatan berlebih oleh peristiwa perangkat keras          |
| 951              | Kendali jelajah diaktifkan                                 |
| 952              | Kendali jelajah dinonaktifkan                              |
| 953              | Awal gerakan tak terduga                                   |
| 954              | Akhir gerakan tak terduga                                  |
| 955              | Alarm mobil                                                |
| 956              | Pejalan kaki di zona bahaya (ADAS)                         |
| 957              | Pengenalan rambu lalu lintas (ADAS)                        |
| 958              | Peringatan tabrakan pejalan kaki (ADAS)                    |
| 959              | Lampu periksa mesin                                        |
| 960              | Mengemudi saat lelah                                       |
| 961              | Peringatan jarak aman (ADAS)                               |
| 962              | Penyimpangan jalur kanan (ADAS)                            |
| 963              | Penyimpangan jalur kiri (ADAS)                             |
| 964              | Penyimpangan jalur (ADAS)                                  |
| 965              | Peringatan tabrakan depan (ADAS)                           |
| 966              | Pelacak memasuki perimeter otomatis                        |
| 967              | Pelacak keluar dari perimeter otomatis                     |
| 968              | Paksa respons lokasi melalui SMS dari UI                   |
| 969              | Alarm pintu                                                |
| 970              | Pengapian mati                                             |
| 971              | Pengapian menyala                                          |
| 972              | Supir tidak teridentifikasi                                |
| 973              | Supir teridentifikasi                                      |
| 974              | Kunci tertutup                                             |
| 975              | Kunci terbuka                                              |
| 976              | Daya perangkat mati                                        |
| 977              | Daya perangkat menyala                                     |
| 978              | Casing tertutup                                            |
| 979              | Casing terbuka                                             |
| 980              | Tombol panggilan ditekan                                   |
| 981              | Sensor cahaya mendeteksi gelap                             |
| 982              | Sensor cahaya mendeteksi terang                            |
| 983              | Akhir getaran                                              |
| 984              | Awal getaran                                               |
| 985              | Baut strap dimasukkan                                      |
| 986              | Baut strap dipotong                                        |
| 987              | Akselerasi dan belokan saat pengemudian kasar              |
| 988              | Pengereman dan belokan saat pengemudian kasar              |
| 989              | Belokan saat pengemudian kasar                             |
| 990              | Akselerasi saat pengemudian kasar                          |
| 991              | Pengereman saat pengemudian kasar                          |
| 992              | Sinyal GPS pulih                                           |
| 993              | Sinyal GPS hilang                                          |
| 994              | Alarm tabrakan                                             |
| 995              | Alarm sinyal GSM lemah                                     |
| 996              | Pengemudian kasar                                          |
| 997              | Gelang terbuka                                             |
| 998              | Gelang tertutup                                            |
| 999              | Peringatan sensor G                                        |

</details>

### Parameter kompleks

Parameter kompleks mencakup nama kelompok dan nama spesifik. Parameter ini dikategorikan sebagai berikut:

* `flags`: Bitmap flag yang merepresentasikan validitas lokasi dan LBS:
  * Bit 0 (location\_valid): Menunjukkan status validitas lokasi. Nilainya adalah `0` jika lokasi tidak valid, dan `1` jika lokasi valid.
  * Bit 1 (lbs): Menunjukkan status LBS pada titik. Jika `0`, titik diterima oleh GPS; jika `1`, titik diterima oleh LBS.
  * Bit 2 (soft\_lbs): Menunjukkan sumber titik LBS. Jika `0`, titik ditentukan oleh LBS perangkat; jika `1`, oleh LBS platform.
* `discrete_inputs`: Merepresentasikan informasi dari setiap masukan diskret. Setiap masukan diskret ditampilkan dalam kolom terpisah, dinomori mulai dari 1. Nilai yang mungkin adalah 1 dan 0, dengan 0 menandakan nonaktif, dan 1 menandakan aktif.
* `discrete_outputs` : Menampilkan hal yang sama seperti masukan diskret, tetapi untuk keluaran diskret. Setiap keluaran diskret berada di kolom terpisah, dinomori mulai dari 1.
* `inputs`: Merepresentasikan data dari berbagai sensor, seperti bahan bakar atau berbagai sensor pengukuran. Setiap masukan berada di kolom terpisah, dan daftar masukan bergantung pada model perangkat.
* `states`: Menampilkan nilai dari parameter status. Sebagian besar dapat bernilai 1 atau 0, tetapi beberapa memiliki nilai teks khusus seperti kode DTC.

Dengan definisi ini, kami harap Anda akan mudah membaca informasi dalam file data mentah dan menggunakannya untuk pemecahan masalah perangkat serta dalam program untuk pelanggan Anda.


---

# 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/id/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file/columns-in-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.
