1.URL

xxxxxxxxxxxxxxx/system/asset/location/queryTrackDataList
其中xxxxxxxxxxxxxxx为节点URL（详情参考：对接说明中4.服务器节点说明）
（上海节点）http://124.223.60.234:8080/system/asset/location/queryTrackDataList
（美国节点）https://cloud.aovx.com/prod/system/asset/location/queryTrackDataList

2.请求参数

2.1请求头

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

2.2.参数示例

{
    "id":"A05FF1D03FA9411DA6540965D1769A0D",
    "startTime":"2023-02-01 16:00:00",
    "endTime":"2023-02-07 16:00:00",
    "fields":["locType","gtime","rtime","lat","lon","speed","dir","mil","lbs","gsm","gnss","alarms"],
    "pageNum":1,
    "pageSize":20
}

2.3.参数说明

字段 类型 说明 是否必须
id String 系统终端唯一标识 Y
startTime String 开始时间（UTC） Y
endTime String 结束时间（UTC） Y
fields List 定义查询字段（如果不传此参数，则全查）； N
pageNum int 第几页（传入0，比如查询轨迹回放，会返回全部） N
pageSize int 每页显示条数（传入0，比如查询轨迹回放，会返回全部） N

fields说明

字段 说明
tid 终端唯一标识
locType 定位类型
lat 纬度
lon 经度
speed 速度
dir 方向
mil 里程
lbs 基站信息
gtime 数据组包时间
rtime 数据接收时间
gsm GSM信号值
gnss 卫星信号值
alarms 报警类型ID集合
batMap 电池信息
statusMap 状态信息
expandMap 拓展信息
wifi WIFI信息
ble 蓝牙信息
device 终端信息

2.4.其他说明

如果是查轨迹清单：则
fields可以不传入字段，默认给出所有信息，参数示例：

{
    "id":"A05FF1D03FA9411DA6540965D1769A0D",
    "startTime":"2023-02-01 16:00:00",
    "endTime":"2023-02-07 16:00:00",
    "pageNum":1,
    "pageSize":20
}

查询指定字段示例
参数示例：

{
    "id":"A05FF1D03FA9411DA6540965D1769A0D",
    "startTime":"2023-02-01 16:00:00",
    "endTime":"2023-02-07 16:00:00",
    "fields":["locType","gtime","rtime","lat","lon","speed","dir","mil","lbs","gsm","gnss","alarms","batMap","expandMap"]
}

3.接口应答

3.1.返回示例

{
    "code": 200,
    "message": "Operation succeeded",
    "data": {
        "total": 4107,
        "size": 206,
        "data": [
            {
                "locType": 1,
                "lat": 31.832898,
                "lon": 117.095556,
                "speed": 0.0,
                "dir": 343,
                "mil": 0.1,
                "lbs": "460,0,21771,27757,51",
                "gtime": "2023-02-07 07:59:47",
                "gsm": 26,
                "gnss": 14,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.83289,
                "lon": 117.095558,
                "speed": 0.0,
                "dir": 343,
                "mil": 0.1,
                "lbs": "460,0,21771,27757,49",
                "gtime": "2023-02-07 07:59:23",
                "gsm": 25,
                "gnss": 14,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.832893,
                "lon": 117.09556,
                "speed": 0.0,
                "dir": 343,
                "mil": 0.1,
                "lbs": "460,0,21771,27757,50",
                "gtime": "2023-02-07 07:58:57",
                "gsm": 27,
                "gnss": 13,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.832893,
                "lon": 117.095548,
                "speed": 0.0,
                "dir": 343,
                "mil": 0.1,
                "lbs": "460,0,21771,27757,52",
                "gtime": "2023-02-07 07:58:32",
                "gsm": 28,
                "gnss": 14,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.832898,
                "lon": 117.09554,
                "speed": 0.0,
                "dir": 343,
                "mil": 0.1,
                "lbs": "460,0,21771,27757,51",
                "gtime": "2023-02-07 07:58:07",
                "gsm": 27,
                "gnss": 14,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.832895,
                "lon": 117.095525,
                "speed": 0.0,
                "dir": 177,
                "mil": 0.0,
                "lbs": "460,0,21771,27757,51",
                "gtime": "2023-02-07 07:57:42",
                "gsm": 27,
                "gnss": 14,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.832901,
                "lon": 117.09553,
                "speed": 0.0,
                "dir": 272,
                "mil": 0.0,
                "lbs": "460,0,21771,27757,52",
                "gtime": "2023-02-07 07:57:17",
                "gsm": 27,
                "gnss": 14,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.832903,
                "lon": 117.095525,
                "speed": 0.0,
                "dir": 272,
                "mil": 0.0,
                "lbs": "460,0,21771,27757,48",
                "gtime": "2023-02-07 07:56:52",
                "gsm": 26,
                "gnss": 14,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.832903,
                "lon": 117.095525,
                "speed": 0.0,
                "dir": 272,
                "mil": 0.0,
                "lbs": "460,0,21771,27757,49",
                "gtime": "2023-02-07 07:56:27",
                "gsm": 26,
                "gnss": 14,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.832903,
                "lon": 117.095523,
                "speed": 0.0,
                "dir": 272,
                "mil": 0.0,
                "lbs": "460,0,21771,27757,49",
                "gtime": "2023-02-07 07:56:01",
                "gsm": 26,
                "gnss": 14,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.832903,
                "lon": 117.09553,
                "speed": 0.0,
                "dir": 272,
                "mil": 0.0,
                "lbs": "460,0,21771,27757,51",
                "gtime": "2023-02-07 07:55:37",
                "gsm": 27,
                "gnss": 11,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.832903,
                "lon": 117.095526,
                "speed": 0.0,
                "dir": 272,
                "mil": 0.0,
                "lbs": "460,0,21771,27757,51",
                "gtime": "2023-02-07 07:55:11",
                "gsm": 26,
                "gnss": 12,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.832903,
                "lon": 117.095515,
                "speed": 0.0,
                "dir": 272,
                "mil": 0.0,
                "lbs": "460,0,21771,27757,51",
                "gtime": "2023-02-07 07:54:45",
                "gsm": 26,
                "gnss": 13,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.832903,
                "lon": 117.095511,
                "speed": 0.0,
                "dir": 272,
                "mil": 0.0,
                "lbs": "460,0,21771,27757,52",
                "gtime": "2023-02-07 07:54:21",
                "gsm": 27,
                "gnss": 14,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.832901,
                "lon": 117.095513,
                "speed": 0.0,
                "dir": 272,
                "mil": 0.0,
                "lbs": "460,0,21771,27757,50",
                "gtime": "2023-02-07 07:53:55",
                "gsm": 27,
                "gnss": 13,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.832906,
                "lon": 117.095515,
                "speed": 0.0,
                "dir": 272,
                "mil": 0.0,
                "lbs": "460,0,21771,27757,51",
                "gtime": "2023-02-07 07:53:30",
                "gsm": 27,
                "gnss": 12,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.832906,
                "lon": 117.095536,
                "speed": 0.0,
                "dir": 132,
                "mil": 0.0,
                "lbs": "460,0,21771,27757,50",
                "gtime": "2023-02-07 07:53:06",
                "gsm": 27,
                "gnss": 11,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.832906,
                "lon": 117.095538,
                "speed": 0.0,
                "dir": 132,
                "mil": 0.0,
                "lbs": "460,0,21771,27757,49",
                "gtime": "2023-02-07 07:52:39",
                "gsm": 26,
                "gnss": 11,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.832906,
                "lon": 117.095535,
                "speed": 0.0,
                "dir": 132,
                "mil": 0.0,
                "lbs": "460,0,21771,27757,50",
                "gtime": "2023-02-07 07:52:14",
                "gsm": 26,
                "gnss": 12,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            },
            {
                "locType": 1,
                "lat": 31.832908,
                "lon": 117.09554,
                "speed": 0.0,
                "dir": 132,
                "mil": 0.0,
                "lbs": "460,0,21771,27757,52",
                "gtime": "2023-02-07 07:51:50",
                "gsm": 26,
                "gnss": 13,
                "alarms": [],
                "batMap": null,
                "statusMap": null,
                "expandMap": null
            }
        ]
    }
}

3.2.返回结果说明

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

data 详情

字段 类型 说明
tid String 终端类型Id
locType int 定位类型（0：不定位；1：卫星定位；2：基站定位;3:定位保持;4:WIFI）
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说明

根据返回字段动态显示，如果返回字段无此字段，则设备不支持此属性

字段 类型 说明
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:闹钟触发；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：加速度点火）
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 充放电次数
auxiliary String 设备附加信息JSON字符串
auxiliary 说明
字段 类型 说明
gnss_time String gnss time(000000000000:invalid)
acc_duration int acc duration
position age int position age
hdop int HDOP
BLE 说明
字段 类型 说明
mac String BLE MAC 地址
rssi int BLE RSSI
fwVer String 蓝牙设备固件版本号
voltage String 蓝牙设备电压值 (V)
temperature String 蓝牙设备上报的温度值 (℃)
sensor String 蓝牙设备上报的三轴传感器的值(x,y,z)
moving String moving
temper String temper
flag String 蓝牙设备类型标识
作者：admin  创建时间：2023-04-24 16:23
最后编辑：admin  更新时间：2025-04-26 15:43