数据引擎服务说明

描述

数据引擎服务主要是满足客户需要设备基本数据进行二次开发的需求。该功能能够实现设备位置数据，报警数据，事件数据，离线/在线状态数据，指令下发数据的主动推送。
1.首先需要编写一个基于POST方法的Webhook服务端接口，用来接收服务器转发过去的数据，可以参考客户端代码示例
2.将编写好的WEBAPI地址通过规则配置——>新建规则，填入到客户端地址里面，对应的是接口的完整URL，比如：http://47.112.122.222:8080/revTerminalLocation
3.规则配置好后，预计5分钟内将会自动生效，这时候设备上报数据，系统的推送引擎就会将数据转发至配置的客户端地址。

规则配置

用户可以规则配置界面中，配置指定公司需要推送的数据，用户需要配置数据类型和客户端地址等信息
如果有消息头限制，需要加上消息头配置，没有的话，可忽略

数据类型说明

1.定位数据

设备的定位数据，包括设备号，定位时间，经纬度，速度，里程等信息

JSON字符串示例

  {"assetId":"8022300001","longitude":0.0,"latitude":0.0,"speed":0,"direction":0,"mileage":16,"gpsTime":"2022-09-01T08:59:56Z","recvTime":"2022-09-01T08:59:56.964Z","locType":0,"cellSignal":19,"gnssSignal":0,"cells":"460,0,9383,220792647","battery":100,"voltage":"0.0","statusJson":"{\"lockBar\":-1,\"lockRope\":0,\"lockStatus\":0}","expandInfo":"{\"angle\":\"null\",\"backBattery\":\"null\",\"fuels\":\"-1,-1,-1\",\"humidity\":\"0\",\"lux\":\"0.0\",\"networkType\":\"0\",\"pressure\":\"0.0\",\"reportType\":\"0\",\"temperature\":\"-1000.0\"}"}

Json字段说明

锁状态JSON说明

车载状态JSON说明

拓展信息JSON说明

2.报警数据

设备产生的报警数据，包括设备号，报警类型，报警时间，经纬度等信息

推送JSON示例

{"assetId":"875011000025","alarmType":46,"dateTime":"2020-04-01T00:00:13Z","longitude":0.0,"latitude":0.0,"speed":0,"mileage":0,"cells":"0,0,0,0","describe":"","fileIndex":"1585699212"}

Json字段说明

报警类型说明：

3.事件数据

设备产生的事件数据，包括设备号，事件类型，时间，经纬度等信息

推送JSON示例

{"assetId":"795206001104","eventType":1,"unLockType":1,"dateTime":"2022-08-19T02:07:28Z","longitude":0.0,"latitude":0.0,"speed":0,"mileage":5,"cells":"460,0,10352,220726855","card":"0003116836","password":"","describe":"{\"waybillGUID\":\"190db1a2-3df1-4857-b94e-ee5937334409\",\"waybillNo\":\"45435345\"}"}

Json字段说明

事件类型说明：

4.指令应答数据

设备产生的指令应答数据，包括设备号，指令类型，时间，指令返回内容信息

推送JSON示例

{"assetId":"742207000010","commandType":"BASE2","content":"[\"742207000010\",\"8\",\"001\",\"BASE\",\"2\",\"20220901081402\"]","dateTime":"2022-09-01T08:14:03.564Z"}

Json字段说明

5.从机数据

从机数据包括从机设备的定位数据，包括主锁/设备号，主锁/从机定位时间，经纬度，速度，里程等信息

JSON字符串示例

    {"assetId":"8012600005","longitude":113.92294,"latitude":22.670017,"speed":0,"direction":0,"gpsTime":"2023-12-07T08:30:31Z","recvTime":"2023-12-07T08:30:52.474Z","subGpsTime":"2023-12-07T08:29:50Z","battery":71,"voltage":"3.93","subAssetID":"E0171E0365","sensorType":4,"statusJson":"{\"lockRope\":0,\"gateway\":0}","locStatus":0,"locRope":0,"rssi":57,"temperature":-1000.0,"humidity":0,"eventType":6,"locTimes":5,"subGpsTimestamp":1701937790000}

Json字段说明

statusJson字段说明

“FStatusJson”:”{"bottomDisassembly":0,"emergencyKey":0,"lockMotor":0,"structuralDisassembly":0,"gateway":0,"lockValve":0}”

推送日志报表

用户配置好推送规则后，可以在推送日志中查询平台主动推送产生的日志，方便后续查看推送记录，对异常问题进行分析