DOKUMENTASI

Dokumentasi API & Data Parameter

Integrasi data pada aplikasi server GPS Tracking System tracker.id dapat dilakukan dengan menggunakan akses API dan data parameter.

Penarikan Data Objek

Mengambil seluruh data objek pada akun pengguna

USER_GET_OBJECTS

Struktur Perintah
Command USER_GET_OBJECTS
Struktur https://tracker.id/api/api.php?api=user&ver=1.0&key=[API_KEY]&cmd=USER_GET_OBJECTS 
[
	{
	  "imei": "xxxxxxxxxxxxxxxxx",
	  "protocol": "concoxgt02",
	  "ip": "114.125.60.1",
	  "port": "10203",
	  "active": "true",
	  "object_expire": "false",
	  "object_expire_dt": "0000-00-00",
	  "name": "Motor Operasional"
	},
	{
	  "imei": "xxxxxxxxxxxxxxxxx",
	  "protocol": "api_loc",
	  "ip": "",
	  "port": "",
	  "active": "true",
	  "object_expire": "false",
	  "object_expire_dt": "0000-00-00",
	  "name": "Samsung S9+"
	}
]

Perintah Kontrol Objek

Kirim perintah ASCII atau HEX ke objek menggunakan gateway GPRS

OBJECT_CMD_GPRS

Struktur Perintah
Command OBJECT_CMD_GPRS
Struktur https://tracker.id/api/api.php?api=user&ver=1.0&key=[API_KEY]&cmd=OBJECT_CMD_GPRS,[IMEI],[nama perintah],[tipe],[isi perintah]

Penarikan Data Lokasi Objek

Mengambil data lokasi terakhir yang diketahui objek dalam format JSON

OBJECT_GET_LOCATIONS

Struktur Perintah
Command OBJECT_GET_LOCATIONS
Parameter #1 IMEI objek, untuk beberapa IMEI pisahkan dengan titik koma. Gunakan "*" untuk mendapatkan semua lokasi objek yang tersedia
Struktur https://tracker.id/api/api.php?api=user&ver=1.0&key=[API_KEY]&cmd=OBJECT_GET_LOCATIONS,[IMEI] 
{
	"xxxxxxxxxxx": {
		"dt_server": "2023-08-24 17:29:33",
		"dt_tracker": "2023-08-24 17:29:33",
		"lat": "-6.890457",
		"lng": "108.491184",
		"altitude": "0",
		"angle": "27",
		"speed": "0",
		"params": {
		"batp": "90",
		"bats": "0",
		"chat": "1",
		"acc": "1"
		},
		"loc_valid": "1"
	}
}

Penarikan Data Riwayat Objek

Mengambil data riwayat objek untuk periode waktu tertentu dalam format JSON

OBJECT_GET_MESSAGES

Struktur Perintah
Command OBJECT_GET_MESSAGES
Parameter #1 IMEI Objek
Parameter #2 Tanggal dan waktu dari, format: YYYY-MM-DD HH:MM:SS
Parameter #3 Tanggal dan waktu ke, format: YYYY-MM-DD HH:MM:SS
Struktur https://tracker.id/api/api.php?api=user&ver=1.0&key=[API_KEY]&cmd=OBJECT_GET_MESSAGES,[IMEI],2016-01-01 00:00:00,2016-02-01 00:00:00 
[
	[
	  "2023-08-22 15:08:09",
	  "-1.163772",
	  "116.542833",
	  "0",
	  "45",
	  "0",
	  {
		"batp": "90",
		"bats": "0",
		"chat": "1",
		"acc": "1"
	  }
	],
	[
	  "2023-08-24 17:29:33",
	  "-6.890457",
	  "108.491184",
	  "0",
	  "27",
	  "0",
	  {
		"batp": "90",
		"bats": "0",
		"chat": "1",
		"acc": "1"
	  }
	]
]

Integrasi Data Objek

Integrasi Data Objek berguna untuk memasukkan data lokasi ke dalam server GPS

Struktur Lokasi
imei Pengidentifikasi objek GPS
dt Tanggal dan waktu, format: YYYY-MM-DD HH:MM:SS, zona waktu: 0 UTC
lat Lintang
lng Bujur
altitude Ketinggian dalam meter
angle Sudut dalam derajat
speed Kecepatan dalam km/jam
loc_valid 1 untuk lokasi GPS yang valid, 0 untuk lokasi GPS yang tidak valid
params Parameter tambahan untuk sensor, semuanya harus dipisahkan dengan karakter "|"
event Peristiwa yang mungkin terjadi: sos, bracon, bracoff, mandown, shock, tow, haccel, hbrake, hcorn, pwrcut, gpscut, lowdc, lowbat, jamming
Struktur Lokasi
https://tracker.id/api/api_loc.php?imei=[IMEI]&dt=2016-01-01 00:00:00&lat=54.000000&lng=25.000000&altitude=100&angle=45&speed=60&loc_valid=1&params=batp=100|acc=1|
Struktur Lokasi + Peristiwa
https://tracker.id//api/api_loc.php?imei=[IMEI]&dt=2016-01-01 00:00:00&lat=54.000000&lng=25.000000&altitude=100&angle=45&speed=60&loc_valid=1&params=batp=100|acc=1|&event=sos

Parameter Data Input Digital

CODE KETERANGAN
alaX ala = alarm, X = nilai sensor
acc Status ACC
bats Status Baterai
diX di = digital input
doX do = digital output
pump Status Pompa Bahan Bakar
track Status Pelacakan
sleep Status Mode Tidur
move Status Mode Gerak
accel Status Accelerometer
dlog Status Data Log

Parameter Data Input Analog

CODE KETERANGAN
accv Voltase ACC
batl Level Baterai
batp Persentase Baterai
batv Voltase Baterai
aiX ai = analog input, X = nilai sensor
aoX ao = analog output, X = nilai sensor
canX can = can data, X = nilai sensor
tempX temp = temperatur, X = nilai sensor
fuelX fuel = bahan bakar, X = nilai sensor
odo Jarak Tempuh dalam Kilometer
odor Jarak Tempuh Relatif dalam Kilometer
engh Jam Kerja Mesin
enghr Jam Kerja Mesin Relatif
gsmlev Level Sinyal GSM
gpslev Level Sinyal GPS
hdop Horizontal Dilution of Precision
pdop Position [3D] Dilution of Precision
vdop Vertical Dilution of Precision

Parameter Data Input String

CODE KETERANGAN
ibut ibutton Data
rfid RFID Data
balance Nilai Data Saldo
lac Kode Area Lokasi GSM
cellid Nomor Identitas BTS GSM
mcc Code Negara Provider GSM
mnc Code Provider GSM
can_sysev Peristiwa Sistem - CAN
can_vemot Pergerakan Kendaraan - CAN
can_clus Status Pedal Kopling - CAN
can_bres Status Pedal Rem - CAN
can_accs Status Pedal Gas - CAN
can_crus Status Cruise Control
can_ptos Status PTO - CAN
can_enplcs Data PLCS Mesin
can_tyreloc Data Posisi Ban - CAN
can_axlew Berat Sistem Roda - CAN
can_axloc Posisi Sistem Roda - CAN
can_haninf Data Informasi Penanganan - CAN
can_dirind Indikator Arah - CAN
can_flev Level Bahan Bakar - CAN
can_fcr Penilaian Penggunaan Bahan Bakar - CAN
can_feco Penggunaan Ekonomis Bahan Bakar - CAN
can_pto Data PTO - CAN
can_hrfc Data HRFC - CAN
can_dist Data Jarak Tempuh - CAN
can_amt Temperatur Suhu Sekitar - CAN
can_ect Temperatur Suhu Mesin - CAN
can_rpm Data RPM Mesin - CAN
can_engh Jam Kerja Mesin - CAN
can_srdist Jarak Tempuh Sebelum Perawatan - CAN
tco_dist TCO Berdasarkan Jarak Tempuh
tco_trip TCO Berdasarkan Perjalanan
tco_vespd TCO Berdasarkan Kecepatan
tco_rpm TCO Berdasarkan RPM