1.URL

xxxxxxxxxxxxxxx/system/asset/report/queryTerminalAlarm
其中xxxxxxxxxxxxxxx为节点URL（详情参考：对接说明中4.服务器节点说明）
（上海节点）http://124.223.60.234:8080/system/asset/report/queryTerminalAlarm
（美国节点）https://cloud.aovx.com/prod/system/asset/report/queryTerminalAlarm

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":[],
    "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":["alarmType","alarmDesc","lat","lon","lbsCells","gnssTime","recvTime"],
    "pageNum":1,
    "pageSize":20
}

2.3.参数说明

字段 类型 说明 是否必须
ids List 系统终端唯一标识集合 Y
startTime String 开始时间（UTC） Y
endTime String 结束时间（UTC） Y
fields List 查询指定字段集合，不传值则查询全部字段 N
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",
                "alarmType": 7,
                "alarmDesc": "",
                "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",
                "alarmType": 7,
                "alarmDesc": "",
                "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",
                "alarmType": 7,
                "alarmDesc": "",
                "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",
                "alarmType": 7,
                "alarmDesc": "",
                "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",
                "alarmType": 7,
                "alarmDesc": "",
                "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 资产编号
alarmType Integer 报警类型ID
alarmDesc 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-24 16:26
最后编辑：admin  更新时间：2025-04-26 15:43