1.URL

http://124.223.60.234:8080/system/asset/report/queryTerminalEvent

2.请求参数

2.1请求头

在Headers里面增加token:对应登录验证成功后，data里面对应的tokenId

2.2.参数示例

2.2.1 查询全部字段

{
    "ids":["A05FF1D03FA9411DA6540965D1769A0D","42EA1752-00BF-46C2-8132-6F103B31B24B"],
    "startTime":"2022-12-01 16:00:00",
    "endTime":"2023-02-07 16:00:00",
    "fields":[],
    "typeIds":[],
    "pageNum":1,
    "pageSize":20
}

2.2.2 查询指定字段

{
    "ids":["A05FF1D03FA9411DA6540965D1769A0D","42EA1752-00BF-46C2-8132-6F103B31B24B"],
    "startTime":"2022-12-01 16:00:00",
    "endTime":"2023-02-07 16:00:00",
    "fields":["eventType","eventDesc","lat","lon","lbsCells","gnssTime","recvTime"],
    "typeIds":[],
    "pageNum":1,
    "pageSize":20
}

2.3.参数说明

字段 类型 说明 是否必须
ids List 系统终端唯一标识集合 Y
startTime String 开始时间（UTC） Y
endTime String 结束时间（UTC） Y
fields List 查询指定字段集合，不传值则查询全部字段 N
typeIds List 查询指定事件类型ID的事件，传入事件ID集合，不传全查 Y
pageNum int 第几页 Y
pageSize int 每页显示条数 Y

3.接口应答

3.1.返回示例

{
    "code": 200,
    "message": "Operation succeeded",
    "data": {
        "total": 20596,
        "size": 4120,
        "data": [
            {
                "terminalId": "42EA1752-00BF-46C2-8132-6F103B31B24B",
                "terminalNum": "413050338952",
                "vehicleId": "09072352-DD00-42A8-8D6E-32B252858039",
                "vehicleNum": "num1-413050338952",
                "eventType": 7,
                "eventDesc": "",
                "lat": 31.832951,
                "lon": 117.095436,
                "altitude": 63,
                "speed": 0,
                "direction": 299,
                "mileage": 0,
                "lbsCells": "460,0,21771,139532462,35",
                "gnssTime": "2022-12-15T02:49:30Z",
                "recvTime": "2022-12-15T02:52:56.355048Z",
                "gnssTimestamp": 1671072570000,
                "recvTimestamp": 1671072776355
            },
            {
                "terminalId": "42EA1752-00BF-46C2-8132-6F103B31B24B",
                "terminalNum": "413050338952",
                "vehicleId": "09072352-DD00-42A8-8D6E-32B252858039",
                "vehicleNum": "num1-413050338952",
                "eventType": 7,
                "eventDesc": "",
                "lat": 31.832953,
                "lon": 117.095438,
                "altitude": 63,
                "speed": 0,
                "direction": 299,
                "mileage": 0,
                "lbsCells": "460,0,21771,139532462,35",
                "gnssTime": "2022-12-15T02:49:05Z",
                "recvTime": "2022-12-15T02:52:18.117782Z",
                "gnssTimestamp": 1671072545000,
                "recvTimestamp": 1671072738117
            },
            {
                "terminalId": "42EA1752-00BF-46C2-8132-6F103B31B24B",
                "terminalNum": "413050338952",
                "vehicleId": "09072352-DD00-42A8-8D6E-32B252858039",
                "vehicleNum": "num1-413050338952",
                "eventType": 7,
                "eventDesc": "",
                "lat": 31.832956,
                "lon": 117.095435,
                "altitude": 63,
                "speed": 0,
                "direction": 299,
                "mileage": 0,
                "lbsCells": "460,0,21771,139532462,35",
                "gnssTime": "2022-12-15T02:48:40Z",
                "recvTime": "2022-12-15T02:51:09.203763Z",
                "gnssTimestamp": 1671072520000,
                "recvTimestamp": 1671072669203
            },
            {
                "terminalId": "42EA1752-00BF-46C2-8132-6F103B31B24B",
                "terminalNum": "413050338952",
                "vehicleId": "09072352-DD00-42A8-8D6E-32B252858039",
                "vehicleNum": "num1-413050338952",
                "eventType": 7,
                "eventDesc": "",
                "lat": 31.832951,
                "lon": 117.09545,
                "altitude": 61,
                "speed": 0,
                "direction": 299,
                "mileage": 0,
                "lbsCells": "460,0,21771,139532462,35",
                "gnssTime": "2022-12-15T02:48:15Z",
                "recvTime": "2022-12-15T02:50:14.355050Z",
                "gnssTimestamp": 1671072495000,
                "recvTimestamp": 1671072614355
            },
            {
                "terminalId": "42EA1752-00BF-46C2-8132-6F103B31B24B",
                "terminalNum": "413050338952",
                "vehicleId": "09072352-DD00-42A8-8D6E-32B252858039",
                "vehicleNum": "num1-413050338952",
                "eventType": 7,
                "eventDesc": "",
                "lat": 31.832953,
                "lon": 117.095461,
                "altitude": 60,
                "speed": 0,
                "direction": 299,
                "mileage": 0,
                "lbsCells": "460,0,21771,139532462,35",
                "gnssTime": "2022-12-15T02:47:50Z",
                "recvTime": "2022-12-15T02:49:03.827949Z",
                "gnssTimestamp": 1671072470000,
                "recvTimestamp": 1671072543827
            }
        ]
    }
}

3.2.返回结果说明

字段 类型 说明
code int 返回状态
message String 返回结果描述
data object 返回结果体

data 详情

字段 类型 说明
total String 总条数
size String 多少页
data object 每页的结果集合

data 详情

字段 类型 说明
terminalId String 终端系统唯一标识
terminalNum String 终端编号
vehicleId String 资产系统唯一标识
vehicleNum String 资产编号
eventType Integer 事件类型ID
eventDesc String 事件描述
lat Double 纬度(WGS-84)
lon Double 经度(WGS-84)
altitude Integer 海拔高度,单位: m
speed Double 速度,单位: km/h
direction Integer 方向,0~360,0:正北
mileage Double 里程，单位: km
lbsCells String 基站信息 (格式: mcc,mnc,lac,ci,rssi)
gnssTime String 定位时间 (UTC)
recvTime String 数据接收时间(UTC)
gnssTimestamp long 定位时间戳（millisecond）
recvTimestamp long 数据接收时间戳 （millisecond）
作者：admin  创建时间：2023-04-16 21:02
最后编辑：admin  更新时间：2025-04-23 17:26