1.用途

查看设备状态数据的时候设备的基础信息
采用Post方式，请求参数为JSON格式

2.URL

http://124.223.60.234:8181/spartan/device/queryDeviceStatus

3.请求参数

3.1.参数示例

{
    "terminalId":"1957EE0C69614AB3B3AF2755103B0AB6",
    "userId":"21"
}

3.2.参数说明

字段 类型 说明 是否必须
terminalId String 设备唯一标识 Y
userId String 用户的唯一标识 Y

4.返回参数

4.1.返回参数示例

{
    "code": 200,
    "message": "Operation succeeded",
    "data": {
        "onlineStatus": 0,
        "activeStatus":0,
        "locType": 0,
        "lat": 0.0,
        "lon": 0.0,
        "speed": 0.0,
        "dir": 0,
        "mil": 0.0,
        "lbs": "404,0,721420363,822988338,142",
        "gtime": "2023-01-31 02:21:10",
        "rtime": "2023-02-02 08:33:11",
        "gsm": 174,
        "gnss": 0,
        "alarms": [],
        "batMap": {
            "vol": "3.513",
            "bat": "0"
        },
        "statusMap": {
            "acc": 0,
            "door": 0,
            "oil": 0,
            "type": 1,
            "ele": 0
        },
        "expandMap": {
            "light": "0",
            "work_mod": "4",
            "accel": "x:0,y:0,z:0"
        },
        "updateRunStatusTimestamp": 0
    }
}

4.2.返回参数说明

字段 类型 说明
code int 返回状态，详情参见“返回状态集”
message String 返回结果描述
data List 返回结果体
data说明
字段 类型 说明
onlineStatus int (0:未联网；1：联网中)
activeStatus int Active Tracking status;0:disabled;1:enable
locType int 定位类型（0：不定位；1：卫星定位；2：基站定位）
lat Double 纬度(WGS-84)
lon Double 经度(WGS-84)
speed Double 速度,单位: km/h
dir int 方向,0~360,0:正北
mil Double 里程，单位: km
lbs String 基站信息 (格式: mcc,mnc,lac,ci,rssi)
gtime String 数据组包时间 (UTC)
rtime String 数据接收时间(UTC)
gsm Integer GSM信号
gnss Integer 卫星信号
alarms List 报警类型ID集合
batMap Map 电量信息Map
statusMap Map 状态信息Map
expandMap Map 拓展信息Map
runStatus Integer 发动机状态：0：停止；1：运行；
updateRunStatusTime String 最后更新发动机状态的时间(UTC)
updateRunStatusTimestamp long 最后更新发动机状态的时间戳

batMap说明

电池信息，并非返回全部内容，可根据返回字段动态显示
显示样式如：电量(电压)(充电中)；如果字段没有或者无效则不显示此内容，比如只有电量则显示样式：电量

字段 类型 说明
bat String 电量百分比
vol String 电压，如果大于0才有效
charge String 充电状态（2：充电中；3：充满；4：充电异常；其他：无效，等于没有此字段）

statusMap说明

根据返回字段动态显示，如果返回字段无此字段，则代表设备没有此状态

字段 类型 说明
acc int ACC状态(0:关；1：开)
door int 车门状态（0：开；1：关）
oil int 油路状态（0：正常；1：断开）
ele int 电源状态（0：正常；1：断开）
type int 数据类型:(0:实时；1:补传；2:报警)
expandMap说明

根据返回字段动态显示，如果返回字段无此字段，则代表设备没有此状态

字段 类型 说明
ext_vol String 外部电压
light String 光照度
light_lim String 光照度门限值
temp String 温度
temp_max String 高温门限值
temp_min String 低温门限值
hum String 湿度
hum_max String 高湿门限值
hum_min String 低湿门限值
accel String 姿态（x:10,y:10,z:10）
work_mod String 工作模式：0：周期模式；1： 触发模式；2： 跟踪模式+触发模式；3： 时钟模式+触发模式；4： 周期模式+触发模式

5.测试示例

作者：admin  创建时间：2023-03-22 15:49
最后编辑：admin  更新时间：2024-06-13 09:41