1.URL

http://124.223.60.234:8080/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
}

如果是查轨迹回放，则根据modelId进行区别传入的内容
modelId=1：locType、lat、lon、speed、dir、mil、lbs、gtime、rtime、gsm、gnss、alarms、statusMap
modelId=2,3：locType、lat、lon、speed、dir、mil、lbs、gtime、rtime、gsm、gnss、alarms、batMap、expandMap
modelId=4：locType、lat、lon、speed、dir、mil、lbs、gtime、rtime、gsm、gnss、alarms、batMap、statusMap、expandMap
参数示例：

{
    "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：基站定位）
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说明

根据返回字段动态显示，如果返回字段无此字段，则不显示此字段内容，在界面呈现的时候，可以将基站信息显示在拓展字段列，也可以单独显示，接口侧已经根据终端类型返回对应的数据体，比如：电动踏板车业务只返回了：bat_cap、remain_bat_cap、charge_cnt

字段	类型	说明
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.其他说明

在查询轨迹的时候，下方列表除了轨迹点之外可以显示一下信息：

报警点：通过alarms字段是否有值显示
根据终端类型而显示：
modelId=1（车机）:速度与里程曲线
model=2,3(货物追踪器)：温湿度曲线，震动曲线
model=4(电动踏板车)：速度、里程、剩余电量三Y轴曲线

4.请求示例

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

查询轨迹数据