1.URL

http://124.223.60.234:8080/system/asset/location/queryLocationDataList

2.请求参数

2.1请求头

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

2.2.参数示例

["1CCE240C-36FA-47E6-B3D6-E1437840989C","C0CD5251-7A45-4869-8C53-3FD68C1C712C","88F5D920E9BF4C6C9CC027A0CFA85CF4","42EA1752-00BF-46C2-8132-6F103B31B24B","43EA1752-94BF-46C2-8132-6F103B31B23B"]

2.3.参数说明

终端系统唯一标识List<String>集合

3.接口应答

3.1.返回示例

{
    "code": 200,
    "message": "Operation succeeded",
    "data": [
        {
            "locType": 0,
            "lat": 0.0,
            "lon": 0.0,
            "speed": 0.0,
            "dir": 0,
            "mil": 0.0,
            "lbs": "460,0,10156,220814416,21",
            "gsm": 19,
            "gnss": 0,
            "alarms": [],
            "batMap": {
                "vol": "0.0",
                "charge": "2",
                "bat": "0"
            },
            "statusMap": {
                "acc": 0,
                "door": 0,
                "oil": 1,
                "type": 0,
                "ele": 1
            },
            "expandMap": {
                "ext_vol": "55.341"
            },
            "gtime": "2023-01-07T06:18:34Z",
            "tid": "1CCE240C-36FA-47E6-B3D6-E1437840989C",
            "rtime": "2023-01-07T06:18:35.608628Z"
        },
        {
            "locType": 1,
            "lat": 31.83292,
            "lon": 117.095553,
            "speed": 0.0,
            "dir": 0,
            "mil": 0.0,
            "lbs": "460,0,21771,139532462,22",
            "gsm": 23,
            "gnss": 7,
            "alarms": [],
            "batMap": {
                "vol": "0.0",
                "bat": "0"
            },
            "statusMap": {
                "acc": 0,
                "door": 0,
                "oil": 0,
                "type": 0,
                "ele": 0
            },
            "expandMap": {
                "ext_vol": "13.086"
            },
            "gtime": "2023-01-31T07:40:56Z",
            "tid": "C0CD5251-7A45-4869-8C53-3FD68C1C712C",
            "rtime": "2023-01-31T07:40:58.588109Z"
        },
        {
            "locType": 1,
            "lat": 37.479973,
            "lon": 109.430683,
            "speed": 60.0,
            "dir": 0,
            "mil": 5000.0,
            "gsm": 0,
            "gnss": 0,
            "alarms": [],
            "batMap": {
                "vol": "0.0",
                "bat": "0"
            },
            "statusMap": {
                "acc": 0,
                "door": 1,
                "oil": 1,
                "type": 0,
                "ele": 1
            },
            "expandMap": {},
            "gtime": "2023-02-01T23:06:06Z",
            "tid": "88F5D920E9BF4C6C9CC027A0CFA85CF4",
            "rtime": "2023-02-01T15:06:06.112014Z"
        },
        {
            "locType": 1,
            "lat": 31.832951,
            "lon": 117.095436,
            "speed": 0.0,
            "dir": 299,
            "mil": 0.0,
            "lbs": "460,0,21771,139532462,35",
            "gsm": 27,
            "gnss": 19,
            "alarms": [
                "7"
            ],
            "batMap": {
                "vol": "0.0",
                "bat": "0"
            },
            "statusMap": {
                "acc": 1,
                "door": 0,
                "oil": 0,
                "type": 2,
                "ele": 0
            },
            "expandMap": {
                "ext_vol": "13.013"
            },
            "gtime": "2022-12-15T02:49:30Z",
            "tid": "42EA1752-00BF-46C2-8132-6F103B31B24B",
            "rtime": "2022-12-15T02:52:56.355048Z"
        },
        {
            "locType": 1,
            "lat": 30.6263,
            "lon": 104.047213,
            "speed": 52.0,
            "dir": 304,
            "mil": 0.0,
            "lbs": "460,0,32787,134386200,40",
            "gsm": 0,
            "gnss": 0,
            "alarms": [],
            "batMap": {
                "vol": "3.503",
                "bat": "0"
            },
            "statusMap": {
                "acc": 0,
                "door": 0,
                "oil": 0,
                "type": 0,
                "ele": 0
            },
            "expandMap": {
                "light": "0"
            },
            "gtime": "2022-12-07T07:16:56Z",
            "tid": "43EA1752-94BF-46C2-8132-6F103B31B23B",
            "rtime": "2022-12-07T07:43:26.011735Z"
        }
    ]
}

3.2.返回结果说明

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

data 详情

字段 类型 说明
tid String 终端类型Id
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

batMap说明

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

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

statusMap说明

根据终端类型而显示:
modelId=1(车机):acc:ACC状态;door:车门状态;oil:油路状态;ele:电源状态;type:数据类型:(0:实时;1:补传;2:报警)

model=2,3(货物追踪器):type:数据类型:(0:实时;1:补传;2:报警);

model=4(电动踏板车):MCU_Speed_Limit:限速;Battery_Lock:电池锁;Anti_Theft:设防状态;Overcurrent:电流状态;Hall:电机霍尔状态;Controller:控制器状态;Ele_Regulate_High_Temp:电调温度状态;Motor_High_Temp:电机温度状态;Disconnection:联网状态;

model=5(电子锁):lockStatus:锁状态(0:关锁;1:开锁)

字段 类型 说明
acc int ACC状态(0:关;1:开)
door int 车门状态(0:开;1:关)
oil int 油路状态(0:正常;1:断开)
ele int 电源状态(0:正常;1:断开)
type int 数据类型:(0:实时;1:补传;2:报警)
MCU_Speed_Limit int 行驶限速值(km/h)
Battery_Lock int 电池锁状态:(0:上锁;1:未上锁)
Anti_Theft int 设防状态:(0:未设防;1:设防)
Overcurrent int 电流状态:(0:正常;1:电流过载)
Hall int 电机霍尔状态:(0:正常;1:异常)
Controller int 控制器状态:(0:正常;1:异常)
Ele_Regulate_High_Temp int 电调温度状态:(0:正常;1:温度过高)
Motor_High_Temp int 电机温度状态:(0:正常;1:温度过高)
Disconnection int 联网状态:(0:联网中;1:已断网)
expandMap说明

根据返回字段动态显示,如果返回字段无此字段,则不显示此字段内容,在界面呈现的时候,可以将基站信息显示在拓展字段列,也可以单独显示

字段 类型 说明
ext_vol String 外部电压
awaken String 唤醒类型(0:周期采样 1:低电量触发 2:运动触发 3:碰撞触发 4:光照触发 5.温湿度触发 6.温度触发 7.湿度触发 8:闹钟触发;9:蓝牙连接触发;64:周期触发 65:开机触发 66:ACC点火 67:ACC熄火 68:VCC连接 69:VCC移除 70:虚拟点火(Gsensor) 71:虚拟点火(GNSSAST)72:虚拟熄火(Gsensor) 73:拐点触发 74:超速触发 75:OTA启动 76:OTA成功 77:OTA失败 78:首次定位 79:低压触发 80:低压解除;81:JAMMING触发 82:距离触发 83:碰撞触发 84:DI1触发 85:DI2触发 86:DI3触发 87:DI4触发 88:DI5触发 89:DI6触发;90:DI7触发 91:DI8触发 92:DI9触发 93:DI10触发 94:AI上限触发 95:AI下限触发 96:电池低压触发 97:电池低压解除 ;98:电池开始充电 99:电池充满 100:软复位触发 101:虚拟点火(Voltage) 102:虚拟熄火(Voltage) 103:TOW开始 104:TOW停止 105:进入电子围栏 106:离开电子围栏 107:深度休眠周期唤醒 108:DI1解除 109:急加速 110:急减速 111:急转弯 112:加速度点火)如果在这些定义之外的显示接口返回的数值即可,英文的描述我复制在了功能键Key说明页了
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: 周期模式+触发模式
bat_cap String 电池容量,单位(mAh)
remain_bat_cap String 剩余电池容量(mAh)
charge_cnt String 充放电次数

3.3.界面设计简要

实时监控可按一下状态进行分类:
全部:显示所有的资产或者终端定位数据(根据是按资产查还是按终端查)
在线:通过终端离线判断时长判断是否在线,及接收时间+离线判断时长>=当前时间
运行:在线且速度>0
停止:在线且速度=0
异常:在线且alarms集合大于0或者通过statusMap中的type判断,建议使用alarms集合是否大于0判断
未定位:在线且定位类型=0
离线:通过终端离线判断时长判断是否离线,及接收时间+离线判断时长<当前时间
未激活:未有此设备相关的定位数据

4.请求示例

作者:admin  创建时间:2023-04-16 20:58
最后编辑:admin  更新时间:2025-04-23 17:26