1.URL
http://124.223.60.234:8080/system/asset/location/queryTerminalLocationDetails
2.请求参数
2.1请求头
在Headers里面增加token:对应登录验证成功后,data里面对应的tokenId

2.2.参数示例
{
"id":"8B60985EA2314D8D944C4B5C9044782C"
}
2.3.参数说明
| 字段 |
类型 |
说明 |
是否必须 |
| id |
String |
终端唯一标识 |
Y |
3.接口应答
3.1.返回示例
{
"code": 200,
"message": "Operation succeeded",
"data": {
"location": {
"tid": "8B60985EA2314D8D944C4B5C9044782C",
"locType": 2,
"lat": 31.8321857452393,
"lon": 117.094436645508,
"speed": 0.0,
"dir": 0,
"mil": 0.0,
"lbs": "460,0,21771,27757,-75",
"gtime": "2025-06-08 08:54:55",
"rtime": "2025-06-08 08:55:15",
"gsm": 19,
"gnss": 0,
"alarms": [],
"batMap": {
"vol": "3.593",
"charge": "0",
"bat": "98"
},
"statusMap": {
"awaken": 0,
"type": 0,
"network": 4
},
"expandMap": {
"hum": "70.0",
"temp": "28.2",
"light_lim": "1500",
"hum_min": "10",
"awaken": "0",
"temp_max": "40.0",
"vibration": "1028.17",
"work_mod": "4",
"accel": "x:-66,y:-10,z:1026",
"msgFlowId": "2980",
"temp_min": "0.0",
"auxiliary": "{\"gnss_time\":\"000000000000\",\"acc_duration\":0,\"position_age\":0,\"hdop\":0}",
"hum_max": "50"
},
"wifi": "",
"ble": "",
"device":"{\"iccid\":\"89457300000026000029\",\"imei\":\"0866088079146120\",\"device_type\":\"GM110-GL\",\"work_model\":4}"
},
"onlineStatus": 0,
"alarmCount": 0,
"terminalTypeCustom": {
"terminalTypeId": 101,
"typeName": "AOVX-G",
"offlineTime": 86400,
"modelId": 2,
"protocolType": 808,
"status": 1,
"functionKeys": "[3,4,15,16]",
"terminalTypeFuncList": [
{
"functionKey": 3,
"name": "{\"0\":\"Restart\",\"1\":\"远程重启\",\"2\":\"Reinicio\",\"3\":\"إعادة تشغيل\"}"
},
{
"functionKey": 4,
"name": "{\"0\":\"AT Command\",\"1\":\"指令透传\",\"2\":\"Orden AT\",\"3\":\"أترحيل الأوامر\"}"
},
{
"functionKey": 15,
"name": "{\"0\":\"Mask command\",\"1\":\"掩码指令\",\"2\":\"Mascarilla\",\"3\":\"أمر المسخرة\"}"
},
{
"functionKey": 16,
"name": "{\"0\":\"Share\",\"1\":\"分享\",\"2\":\"Compartir\",\"3\":\"مشاركة\"}"
}
],
"gateway": "124.223.60.234:6608",
"descUrl": null
}
}
}
3.2.返回结果说明
| 字段 |
类型 |
说明 |
| code |
int |
返回状态 |
| message |
String |
返回结果描述 |
| data |
object |
返回结果体 |
data详情
| 字段 |
类型 |
说明 |
| location |
object |
实时定位数据详情 |
| onlineStatus |
int |
设备联网状态(0:未联网;1:联网中) |
| alarmCount |
int |
最近24小时报警数量 |
| terminalTypeCustom |
object |
设备类型信息 |
| vehicleInfo |
object |
资产详情信息 |
location 详情
| 字段 |
类型 |
说明 |
| tid |
String |
终端类型Id |
| locType |
int |
定位类型(0:不定位;1:卫星定位;2:基站定位;3:定位保持;4:WIFI定位;5:蓝牙定位) |
| 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 |
| wifi |
String |
WIFI信息的JSON字符串,有值才返回 |
| ble |
String |
蓝牙信息的JSON字符串 ,有值才返回 |
| device |
Map |
终端信息的JSON字符串 ,有值才返回 |
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:开锁)

model=6(智能手表)

model=7(安防头盔)

model=8(AQMS)
已经作为独立业务进行,暂时先不考虑

model=9(叉车控制器)

| 字段 |
类型 |
说明 |
| acc |
int |
ACC状态(0:关;1:开) |
| door |
int |
车门状态(0:开;1:关) |
| oil |
int |
油路状态(0:正常;1:断开) |
| ele |
int |
电源状态(0:正常;1:断开) |
| type |
int |
数据类型:(0:实时;1:补传;2:报警) |
| network |
int |
1-NB-IOT;2-LTE;3-WCDMA;4-GSM;5:eMTC;6-CATM;7:WIFI |
| galaxy |
int |
定位星系 (0: 不显示; 1: GPS; 2: Beidou; 3: GPS + Beidou; 4: GLONASS; 5: GPS + GLONASS; 6: Beidou + GLONASS; 7: GPS + Beidou + GLONASS; 8: Galileo; 9: GPS + Galileo; 10: Beidou + Galileo; 11: GPS + Beidou + Galileo; 12: GLONASS + Galileo; 13: GPS + GLONASS + Galileo; 14: Beidou + GLONASS + Galileo; 15: GPS + Beidou + GLONASS + Galileo) |
| 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 |
外部电压 |
| 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 |
充放电次数 |
| sim_status |
String |
sim卡检测(0:未知 1:没有sim卡2:有sim卡) |
| memory_card_status |
String |
内存卡检测(0:未知 1:没有内存卡 2:有内存卡) |
| body |
String |
人体特征数据,并非全部有,根据返回的值动态判断(heart_rate:心率;high_blood_pressure:收缩压;low_blood_pressure:舒张压;body_temp:体温);blood_oxygen:血氧 |
wifi说明
| 字段 |
类型 |
说明 |
| mac |
String |
MAC地址 |
| rssi |
String |
接收信号的强度 |
ble说明
| 字段 |
类型 |
说明 |
| mac |
String |
MAC地址 |
| rssi |
String |
接收信号的强度 |
| name |
String |
名称 |
| fwVer |
String |
固件版本 |
| voltage |
String |
电压值 |
| temperature |
String |
温度 |
| humidity |
String |
湿度 |
| sensor |
String |
姿态传感器(x:10,y:10,z:10) |
device说明
| 字段 |
类型 |
说明 |
| work_model |
String |
工作模式,同expandMap里面的工作模式 |
| imei |
String |
IMEI |
| iccid |
String |
iccid |
| device_type |
String |
设备型号 |
terminalTypeCustom说明
| 字段 |
类型 |
说明 |
| terminalTypeId |
int |
终端类型ID |
| typeName |
String |
终端类型名称 |
| offlineTime |
int |
离线判断时长 |
| modelId |
int |
模型ID |
| protocolType |
int |
协议类型ID |
| status |
int |
终端类型状态(0:禁用;1:启用) |
| functionKeys |
String |
终端类型对应的功能集合 |
| terminalTypeFuncList |
List |
类型对应的快捷字典键集合 |
| gateway |
String |
此类型终端注册的网关地址 |
terminalTypeFuncList说明
| 字段 |
类型 |
说明 |
| functionKey |
int |
快捷键Key |
| name |
String |
快捷键名称(0:英文;1:中文) |
vehicleInfo说明
| 字段 |
类型 |
说明 |
| id |
String |
资产唯一标识 |
| vehicleNum |
String |
资产编号 |
| orgId |
String |
公司唯一标识 |
| orgName |
String |
公司名称 |
| terminals |
List |
资产绑定终端的集合 |
| iconType |
int |
图标类型 |
| imgUrl |
String |
资产照片(多张用List JSON格式存储) |
| vehicleTypeId |
int |
资产类型Id |
| vehicleTypeName |
String |
资产类型名称 |
| typeInfo |
String |
资产类型拓展信息,参见资产类型管理 |
| driverId |
String |
资产所属人ID |
| driverName |
String |
资产所属人名称 |
| phoneNum |
String |
资产所属人电话 |
| status |
int |
资产状态(0:禁用;1:启用;后续拓展其他状态) |
| descInfo |
String |
资产描述 |
| createTime |
String |
创建时间 |
| creatorId |
String |
创建用户唯一标识 |
| creator |
String |
创建用户 |
4.请求示例

Author:admin Create time:2025-06-08 17:13
Last editor:admin Update time:2025-10-31 14:50