Interface description
Get real- time device status
Request Example
https://v7.cmsv8.com/StandardApiAction_getDeviceStatus.action?jsession=66d754dd7f41473dbd2&vehiIdno=S66666
Request parameters
| Parameter name | Parameter type | Whether it is required | Example | Parameter meaning |
|---|---|---|---|---|
| jsession | string | Yes | 66d754dd7f41473dbd2 | Session number |
| devIdno | string | No | 01330000001, 01330000002 | Equipment number, which can be divided by multiple. If it is empty, judge the license plate number, if the license plate number is also empty, judge all |
| vehiIdno | string | No | S66666 | License plate number, can be multiple, divided. If both are blank, query all authorized devices of the account |
| geoaddress | number | No | 0 | Whether to resolve geographic location: 1 means to provide geographic location resolution service, if not, geographic location will not be resolved |
| driver | number | No | 1 | Whether to query driver information (name and work number) 1: query; Other or not to pass: not to query |
| toMap | number | No | 0 | Map coordinate conversion: 0 means WGS84 coordinates (default);1 means Google coordinates (gj02);2 means Baidu coordinates (bd09) |
| language | string | No | en | When analyzing longitude and latitude, Chinese reference: zh |
Return parameters
| Parameter name | Parameter type | Description |
| - - - - - - - - - - - - | - - - - - - - - - - - - | - - - - - - - - - - - - | - - - - - - - - - - - - | - - - - - - - - - - - - |
| id | string | Device number |
| vid | string | License plate |
| lng | number | Longitude The value is 0 if the device location is invalid. For example: 113231258, the true value is 113.231258 |
| lat | number | Latitude If the device location is invalid, the value is 0. For example: 39231258, the true value is 39.231258 |
| ft | number | type of manufacturer |
| sp | number | speed unit: km/h, divided by 10 in use. |
| ol | number | online status 1 means online, otherwise not online. |
| gt | string | Locate upload time |
| pt | number | communication protocol type |
| dt | number | hard disk type 1 means SD card, 2 means hard disk, and 3 means SSD card. |
| ac | number | audio type |
| net | number | network type 0 means 3G,1 means WIFI,2 means wired, 3 means 4G,4 means 5G. |
| gw | string | Gateway Server Number |
| s1 | number | See Device Status Description |
| s2 | number | For details of status 2, see Device status description |
| s3 | number | For details of status 3, see Device status description |
| s4 | number | For details of status 4, see Device status description |
| t1 | number | temperature sensor 1 |
| t2 | number | temperature sensor 2 |
| t3 | number | temperature sensor 3 |
| t4 | number | temperature sensor 4 |
| hx | number | is 0 degrees in the north direction, increases clockwise, and has a maximum value of 360 degrees. |
| mlng | string | The converted longitude of the map |
| mlat | string | The converted latitude of the map |
| pk | number | parking duration unit: seconds. |
| lc | number | Mileage in meters. |
| yl | number | oil quantity unit: liter, divided by 100 in use. |
| viceYl | number | secondary oil quantity unit: liter, divided by 100 in use. |
| ps | string | The resolved geographic location or (converted longitude, converted latitude) |
| tsp | number | speed unit of tachograph: km/h, divide by 10 in use. |
| dn | string | Driver name |
| jn | string | Driver certificate code |
| lt | number | login type 0- linux,1- windows,2- web,3- Android, 4- ios |
| ust | number | usage status 0 is normal, 1 is maintenance, 2 is disabled, 3 is overdue |
| sn | number | number of satellites |
| lg | number | 2 indicates long positioning (refer to 808- 2019 protocol) |
| rt | string | valid when lg = 2, server time to receive location |
| ls | number | lg = 2 valid bit0: cabin temperature, bit1:IO status bit, bit2: extended vehicle signal status, bit3: analog bit4: tire pressure, bit5: active safety ADAS,bit6: active safety DSM,bit7: active safety BSD |
| ct | number | lg = 2 valid, cabin temperature (0x 06)(refer to 808- 2019 protocol) |
| ios | number | lg = 2 valid, IO status bit (0x2A)(refer to 808- 2019 protocol) |
| es | number | valid when lg = 2, extended vehicle signal status bit (0x 25)(refer to 808- 2019 protocol) |
| aq | number | valid when lg = 2, analog quantity (0x2B)(refer to 808- 2019 protocol) |
| adas1 | number | lg = 2 is valid, active safety adas alarm status bit Lv1 bit0: forward collision alarm, bit1: lane departure alarm, bit2: vehicle distance too close alarm, bit3: pedestrian collision alarm bit4: frequent lane change alarm, bit5: road sign overlimit alarm, bit6: obstacle alarm, bit7: curve speed warning |
| adas2 | number | lg = 2 is valid, active safety adas alarm status bit Lv2 bit0: forward collision alarm, bit1: lane departure alarm, bit2: vehicle distance too close alarm, bit3: pedestrian collision alarm bit4: frequent lane change alarm, bit5: road sign overlimit alarm, bit6: obstacle alarm, bit7: curve speed warning |
| dsm1 | number | lg = 2 is valid, active safety dsm alarm status bit Lv1 bit0: fatigue driving alarm, bit1: receiving and calling alarm, bit2: smoking alarm 3: not looking ahead for a long time alarm, bit4: system not working normally alarm bit5: driver not wearing seat belt alarm, bit6: driver not in driving position alarm, bit7: driver hands off steering wheel alarm, bit8: distracted driving alarm (su),bit9: driver abnormal alarm (su) |
| dsm2 | number | lg = 2 is valid, active safety dsm alarm status bit Lv2 bit0: fatigue driving alarm, bit1: receiving and calling alarm, bit2: smoking alarm 3: not looking ahead for a long time alarm, bit4: system not working normally alarm bit5: driver not wearing seat belt alarm, bit6: driver not in driving position alarm, bit7: driver hands off steering wheel alarm, bit8: distracted driving alarm (su),bit9: driver abnormal alarm (su) |
| bsd1 | number | lg = 2 effective active safety bsd alarm status bit bit0: left blind area alarm, bit1: right blind area alarm, bit2: rear approach alarm |
| fvs | number | front vehicle speed (km/h). asas alarm status bits are valid when bit0 = 1 and bit1 = 1 |
| dst | number | front vehicle/pedestrian distance (100ms). asas alarm status bits are bit0 = 1, bit1 = 1 and bit3 = 1 valid |
| rfd | number | road sign identification data. asas alarm type |
| dvt | number | deviation type (0: left 1: right).asas alarm status bit is bit1 = 1 valid |
| rft | number | road sign identification type (0: speed limit sign 1: height limit sign 2: weight limit sign) asas alarm type is bit5 = 1 |
| fl | number | fatigue level. dsm alarm type |
| yn | number | number of yawns. valid when dsm alarm status bit is bit0 = 1 |
| cet | number | duration of eye closure (100ms). dsm alarm status bit is valid when bit0 = 1 |
| wc | number | number of consecutive blinks. dsm alarm status bit is valid when bit0 = 1 |
| tp | number | tire pressure data, formatted as hex. dsm alarm type |
| ef | number | additional information flag bit 0- bus OBD 1- video department logo 2- UAE school bus |
| p1 | number | ef = 1: video loss flag bit, ef = 2: hard disk 3 status 0 is invalid, 1 exists, 2 does not exist |
| p2 | number | ef = 1: video occlusion flag bit, ef = 2: hard disk 3 type 1sd,2hd, 3ssd |
| p3 | number | ef = 1: disk error flag bit, ef = 2: hard disk 4 status 0 is invalid, 1 exists, 2 does not exist |
| p4 | number | ef = 1: abnormal driving flag bit, ef = 2: hard disk 4 type 1sd,2hd, 3ssd |
| p5 | number | ef = 1: fatigue level, ef = 2: humidity 1 sensor |
| p6 | number | ef = 1: none, ef = 2: humidity 2 sensor |
| p7 | number | ef = 1: none, ef = 2: humidity 3 sensor |
| lid | number | Line id |
| drive | number | Driver ID |
| dct | number | line direction 0 up 1 down |
| sfg | number | site identification 0 site 1 site farm |
| snm | number | site index |
| sst | number | site status 1 site 0 next site |
| or | number | OBD collects engine speed |
| OS | number | OBD collects engine speed |
| ov | number | OBD collects battery voltage |
| ojt | number | OBD collects battery voltage |
| ost | number | OBD collection status |
| ojm | number | OBD captures throttle position |
| driSw | number | Driver swipe timestamp |
| driJn | string | Driver Qualification Certificate Number |
| driSwStr | string | Driver swipe time |
| dinfo | string | Driver information |
Return Example
{
"result": 0,
"status": [
{
"id": "013300000001",
"net": 3,
"netn": null,
"gw": "G1",
"ol": 1,
"s1": 805309827,
"s2": 20480,
"s3": 65280,
"s4": 0,
"t1": 0,
"t2": 0,
"t3": 0,
"t4": 0,
"yl": 0,
"sp": 0,
"hx": 0,
"lng": 113712944,
"lat": 23004510,
"mlng": "113.718131",
"mlat": "23.001755",
"ps": "23.004510,113.712944",
"pk": 0,
"lc": 0,
"gt": "2024-12-07 11:58:30.0",
"gte": null,
"upt": null,
"pt": 6,
"dt": 2,
"ac": 0,
"ft": 0,
"fdt": 259,
"vid": "S66666",
"vi": null,
"imei": null,
"imsi": null,
"hv": null,
"sv": null,
"lid": 0,
"drid": 0,
"dct": 0,
"sfg": 0,
"snm": 0,
"sst": 0,
"or": 0,
"os": 0,
"ov": 0,
"ojt": 0,
"ost": 0,
"ojm": 0,
"po": null,
"ef": 0,
"p1": 0,
"p2": 0,
"p3": 0,
"p4": 0,
"p5": 0,
"p6": 0,
"p7": 0,
"p8": 0,
"p9": 0,
"p10": 0,
"glng": null,
"glat": null,
"dn": null,
"jn": null,
"lt": 0,
"tsp": 0,
"abbr": "",
"ust": null,
"lg": 2,
"rt": null,
"ls": 0,
"ct": 0,
"ios": 0,
"es": 0,
"aq": 0,
"adas1": 0,
"adas2": 0,
"dsm1": 0,
"dsm2": 0,
"bsd1": 0,
"bsd2": 0,
"fvs": 0,
"dst": 0,
"rfd": 0,
"dvt": 0,
"rft": 0,
"fl": 0,
"yn": 0,
"cet": 0,
"wc": 0,
"tp": "000000000000000000000000000000000000000000000000000000000000",
"pss": "",
"sn": 0,
"driSw": null,
"driJn": null,
"driSwStr": null,
"dinfo": null,
"clockd": null,
"pu": 0,
"pd": 0,
"pc": 0,
"gd": 0,
"tyreData": null,
"wayBill": null,
"viceYl": 0,
"simulationYL": null,
"water": null,
"tm": null,
"lcVal": null,
"lcValGps": null,
"driftGps": null,
"ifSupplement": false,
"capture": null,
"auxiliaryTankSupport": false,
"parseAuxiliaryTankSupport": false
}
]
}
Map example
(1)URL
https://v7.cmsv8.com/808gps/open/map/vehicleMap.html?jsession=66d754dd7f41473dbd2&devIdno=013300000001&lang=en
(2) Parameter description
| Parameter name | Parameter type | Must | Example | Parameter meaning |
|---|---|---|---|---|
| jsession | string | No | 66d754dd7f41473dbd2 | Session number, if blank, user name and password. |
| devIdno | string | No | 0133000000001 | Equipment number, if it is empty, judge the license plate number. |
| vehiIdno | string | No | S66666 | License plate number, if the device number is empty, then judge the license plate number. |
| lang | string | No | en | Language Set en to English, otherwise to Chinese. |
