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 |
设备类型信息 |
location 详情
字段 |
类型 |
说明 |
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 |
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:报警) |
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 |
充放电次数 |
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:中文) |
4.请求示例

作者:admin 创建时间:2025-06-08 17:13
最后编辑:admin 更新时间:2025-06-27 22:39