Kolom dalam File CSV

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

Untuk mempelajari cara mengunduh informasi ini, Anda dapat merujuk ke artikel sebelumnya. Di sini, kami bertujuan untuk mengeksplorasi lebih jauh cara membaca file ini dan menginterpretasikan berbagai kolom di dalamnya.

Membuka sebuah file

Nama file selalu berisi hal-hal berikut:

• Device ID: Nomor ID perangkat, sering kali merepresentasikan IMEI-nya.

• Label perangkat di platform: Label untuk mempermudah pencarian file.

• Waktu dari dan sampai: Mewakili awal dan akhir file dalam format day_month_year_hours_minutes_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 tidak sejelas bagi manusia. Untuk menyederhanakan pembacaan file, kami merekomendasikan menggunakan editor tabel. Cukup buka file CSV dengan Excel, Google Sheets, atau editor tabel lainnya. Dalam editor tabel, semua parameter akan berada di kolom masing-masing. Selain itu, Anda dapat membekukan baris pertama untuk melihat nama kolom sepanjang file.

Parameter data mentah

File akan menyertakan parameter terpilih dalam kolom, bersama dengan satu entri yang konsisten - msg_time.

Parameter-parameter ini dapat dikategorikan sebagai sederhana atau kompleks.

Kolom sederhana

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

• msg_time: Waktu ketika pelacak merekam sebuah titik. Selalu disertakan dalam output CSV. Ditunjukkan menurut zona waktu yang dipilih.

• server_time: Waktu penerimaan pesan oleh server. Ditunjukkan menurut zona waktu yang dipilih.

• gps_fix_type

  • NO_FIX: Pelacak GPS menandai lokasi sebagai tidak valid.

  • HAS_FIX: Pelacak GPS menandai lokasi sebagai valid.

  • LAST_KNOWN_POSITION: Dalam kasus pelacak menyediakan input saat ini dan status lain di dalam lokasi terakhir yang diketahui.

  • UNKNOWN: Jika perangkat tidak dapat memberikan informasi tersebut atau tidak menentukan tipe fix GPS untuk paket ini.

• lat: Lintang lokasi.

• lng: Bujur lokasi.

• speed: Kecepatan yang ditentukan oleh pelacak dalam km/jam. Dalam kebanyakan kasus, ini adalah kecepatan yang ditentukan oleh GPS perangkat.

• alt: Ketinggian lokasi dalam meter.

• satellites: Jumlah satelit yang tersambung pada saat itu; -1 berarti tidak diketahui dan, dalam banyak kasus, merepresentasikan titik lokasi LBS.

• heading: Arah objek dalam derajat dimana 0 mewakili Utara.

• precision: Presisi lokasi dalam meter.

• hdop: Horizontal dilution of precision - merepresentasikan akurasi estimasi posisi horizontal pelacak GPS. Nilai berkisar dari 1 (sangat baik) hingga di atas 20 (buruk). Nilai antara 1 dan 2 dianggap baik untuk sebagian besar tujuan navigasi. -1 berarti tidak diketahui.

• pdop: Position dilution of precision - menunjukkan akurasi posisi pelacak GPS berdasarkan geometri satelit terkait pelacak. Nilai PDOP yang lebih rendah berarti pemposisian 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 yang sedang roaming,

  • Jika perangkat tidak dapat memberikan data tersebut atau tidak dapat melakukannya untuk pesan tertentu ini, maka nilainya akan -1 (unknown).

• mn_code: Kode operator jaringan seluler. Ditentukan oleh perangkat.

• mn_csq: Kekuatan sinyal jaringan seluler, CSQ, nilai dari 0 hingga 31. Ditentukan oleh perangkat. Jika perangkat tidak dapat memberikan data tersebut atau tidak dapat melakukannya untuk pesan tertentu ini, nilainya akan 99 (unknown).

• mn_type: Tipe jaringan seluler. Ditentukan oleh perangkat.

  • Jika perangkat tidak dapat memberikan data tersebut atau tidak dapat melakukannya untuk pesan tertentu ini, maka nilainya akan UNKNOWN

  • GSM: Jika perangkat menentukan tipe GSM.

  • CDMA: Jika perangkat menentukan tipe CDMA.

  • WCDMA: Jika perangkat menentukan tipe WCDMA.

  • LTE: Jika perangkat menentukan tipe LTE.

  • NR: Jika perangkat menentukan tipe NR.

• event_id: ID event di platform. Temukan daftar semua kode ID event di bawah ini.

ID kode event dan definisinya di Platform

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

Event ID	Definisi
2	Track. Tidak ada event spesifik, hanya titik pelacakan
4	Nomor kontak darurat dipanggil
5	Peristiwa gerakan tidak sah yang ditentukan oleh perangkat
11	Perubahan status Input 1
12	Perubahan status Input 2
13	Perubahan status Input 3
14	Perubahan status Input 4
15	Perubahan status Input 5
16	Perubahan status Input 6
17	Perubahan status Input 7
18	Perubahan status Input 8
34	Perangkat bangun dari mode tidur
37	Mulai mode tidur
40	Daya utama rendah
41	Daya hilang atau pemutusan daya eksternal
42	Tombol Power On ditekan
43	Daya pulih atau daya eksternal tersambung
44	OBD dicabut dari konektor mobil
45	OBD disambungkan
46	Baterai cadangan perangkat lemah
50	Akhir idle (terkait perangkat keras)
51	Mulai idle (terkait perangkat keras)
71	Mulai tidur idle
72	Mulai tidur karena baterai cadangan rendah
73	Bangun oleh pengatur waktu
74	Bangun karena gerakan
75	Bangun oleh daya eksternal
76	Peringatan tidur oleh pengatur waktu
81	Mode keamanan aktif
82	Event pengguna
83	Event tombol SOS ditekan
84	Mode keamanan nonaktif
90	Kopling antena terlepas
100	Perangkat terlepas dari objek
111	Perubahan status Output 1
112	Perubahan status Output 2
113	Perubahan status Output 3
114	Perubahan status Output 4
115	Perubahan status Output 5
116	Perubahan status Output 6
117	Perubahan status Output 7
118	Perubahan status Output 8
797	Check-in dikirim dari aplikasi seluler
798	Pengiriman formulir tugas
799	Perubahan status kerja
800	Titik LBS GSM ditentukan oleh perangkat
802	Titik pelacakan berdasarkan waktu
803	Titik pelacakan berdasarkan jarak
804	Titik pelacakan berdasarkan sudut
811	Mulai pergerakan pelacakan
812	Akhir pergerakan pelacakan
813	Akhir gerakan tidak sah
814	Pesan non-tracking
900	Perubahan jalur cepat akibat mengemudi kasar
901	Pengacakan GPS
928	Dicabut 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 ke objek yang dilacak
935	MDSM 7 terputus
936	MDSM 7 tersambung
937	Laporkan pengemudi baru
938	Pengemudi memasuki kabin
939	Mulai ketidakhadiran pengemudi
940	Pengemudi berhenti merokok (Gangguan pengemudi)
941	Tombol matikan daya ditekan
942	Pengemudi mulai merokok (Gangguan pengemudi)
943	Pengemudi selesai menggunakan telepon (Gangguan pengemudi)
944	Pengemudi mulai menggunakan telepon (Gangguan pengemudi)
945	Mengantuk (Mengemudi lelah)
946	Pengemudi berhenti terganggu (Gangguan pengemudi)
947	Pengemudi mulai terganggu (Gangguan pengemudi)
948	Pengemudi berhenti mengantuk (Mengemudi lelah)
949	Pengemudi mulai mengantuk (Mengemudi lelah)
950	Melampaui kecepatan oleh event perangkat keras
951	Cruise control diaktifkan
952	Cruise control dimatikan
953	Mulai pergerakan tak terduga
954	Akhir pergerakan tak terduga
955	Alarm mobil
956	Pejalan kaki di zona berbahaya (ADAS)
957	Pengenalan rambu lalu lintas (ADAS)
958	Peringatan tabrakan pejalan kaki (ADAS)
959	Lampu cek mesin
960	Mengantuk saat mengemudi
961	Peringatan jarak (Headway) (ADAS)
962	Keluar jalur kanan (ADAS)
963	Keluar jalur kiri (ADAS)
964	Keluar jalur (ADAS)
965	Peringatan tabrakan depan (ADAS)
966	Pelacak memasuki geofence otomatis
967	Pelacak keluar dari geofence otomatis
968	Memaksa respons lokasi lewat SMS dari UI
969	Alarm pintu
970	Ignition Off
971	Ignition On
972	Pengemudi tidak teridentifikasi
973	Pengemudi teridentifikasi
974	Kunci tertutup
975	Kunci dibuka
976	Daya perangkat Mati
977	Daya perangkat Menyala
978	Case tertutup
979	Case dibuka
980	Tombol panggil ditekan
981	Sensor cahaya menentukan gelap
982	Sensor cahaya menentukan terang
983	Akhir getaran
984	Mulai getaran
985	Baut tali dimasukkan
986	Baut tali dipotong
987	Percepatan dan belokan keras saat mengemudi
988	Pengereman dan belokan keras saat mengemudi
989	Belokan keras saat mengemudi
990	Percepatan keras saat mengemudi
991	Pengereman keras saat mengemudi
992	Sinyal GPS pulih
993	Sinyal GPS hilang
994	Alarm kecelakaan
995	Alarm pelemahan sinyal GSM
996	Berkendara keras
997	Gelang terbuka
998	Gelang tertutup
999	Peringatan sensor G

Parameter kompleks

Parameter kompleks mencakup nama grup dan nama spesifik. Mereka dikategorikan sebagai berikut:

• flags: Sebuah bitmap flag yang merepresentasikan validitas lokasi dan LBS:

  • Bit 0 (location_valid): Menunjukkan status validitas lokasi. Nilainya 0 jika lokasi tidak valid, dan 1 jika lokasi valid.

  • Bit 1 (lbs): Menunjukkan status LBS dari titik tersebut. 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: Mewakili informasi dari setiap input diskret. Setiap input diskret disajikan dalam kolom terpisah, dinomori mulai dari 1. Nilai yang mungkin adalah 1 dan 0, dimana 0 menandakan dimatikan, dan 1 menandakan dinyalakan.

• discrete_outputs : Menunjukkan hal yang sama seperti discrete inputs tetapi untuk output diskret. Setiap output diskret berada di kolom terpisah, dinomori mulai dari 1.

• inputs: Mewakili data dari berbagai sensor, seperti bahan bakar atau berbagai sensor pengukur. Setiap input berada di kolom terpisah, dan daftar input bergantung pada model perangkat.

• states: Menampilkan nilai dari parameter status. Sebagian besar dari mereka dapat bernilai 1 atau 0, tetapi beberapa memiliki nilai teks spesifik seperti kode DTC.

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