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 更新时间:2025-04-23 17:26