1.URL
http://124.223.60.234:8080/system/asset/location/queryTrackDataList
or Server in US
https://cloud.aovx.com/prod/system/asset/location/queryTrackDataList
2.Request parameters
2.1.Request headers
Add token in Headers: After successful login verification, the corresponding tokenId in user login response data
2.2.Parameters example
{
"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.Parameters description
| Field | Data type | description | required |
|---|---|---|---|
| id | String | Unique identification of device in the system | Y |
| startTime | String | query start time（UTC） | Y |
| endTime | String | query end time（UTC） | Y |
| fields | List | Define query fields (if this parameter is not passed, all queries will be performed) | N |
| pageNum | int | Which page (if 0 is passed in, such as querying trajectory playback, all will be returned) | N |
| pageSize | int | Number of displayed items per page (if 0 is passed in, for example, when querying trajectory playback, all items will be returned) | N |
fields description
| Field | description |
|---|---|
| tid | Unique identification of terminals in the system |
| locType | location type |
| lat | latitude |
| lon | longitude |
| speed | Speed |
| dir | direction |
| mil | Mileage |
| lbs | Base Station Information |
| gtime | Data packaging time |
| rtime | Data receiving time |
| gsm | GSM signal value |
| gnss | satellite signal value |
| alarms | Alarm Type ID Set |
| batMap | Electricity Information Map |
| statusMap | Status Information Map |
| expandMap | Expand Information Map |
| wifi | WIFI information |
| ble | Bluetooth information |
| device | device information |
2.4.others description
Fields can be left blank and all information is provided by default. Parameter example:
{
"id":"A05FF1D03FA9411DA6540965D1769A0D",
"startTime":"2023-02-01 16:00:00",
"endTime":"2023-02-07 16:00:00",
"pageNum":1,
"pageSize":20
}Example of querying specified fields
Parameter example:
{
"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.Response content
3.1.Response example
{
"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": {
"hum": "57.5",
"temp": "31.4",
"light_lim": "1500",
"hum_min": "10",
"awaken": "7",
"temp_max": "4.0",
"vibration": "896.71",
"work_mod": "2",
"accel": "x:-16,y:32,z:-896",
"temp_min": "0.0",
"light": "457",
"auxiliary": "{\"gnss_time\":\"000000000000\",\"acc_duration\":0,\"position_age\":0,\"hdop\":33}",
"hum_max": "50"
},
"ble": "[{\"mac\":\"3a:c8:a7:60:62:ec\",\"rssi\":-71,\"fwVer\":22,\"voltage\":\"0.100\",\"temperature\":\"3.3\",\"sensor\":\"x:0,y:0,z:17\",\"moving\":1,\"temper\":21,\"flag\":1}]"
}
]
}
}3.2.Response description
| Field | Data type | description |
|---|---|---|
| code | int | Return code |
| message | String | Return message |
| data | object | Response data |
Response data description
| Field | Data type | description |
|---|---|---|
| tid | String | Device Type Id |
| locType | int | Location type (0: no positioning; 1: satellite positioning; 2: base station positioning; 3: positioning maintenance) |
| lat | Double | latitude(WGS-84) |
| lon | Double | longitude(WGS-84) |
| speed | Double | Speed, unit: km/h |
| dir | int | direction,0~360,0:north |
| mil | Double | Mileage, unit: km |
| lbs | String | Base Station Information (format: mcc,mnc,lac,ci,rssi) |
| gtime | String | Data packaging time(UTC) |
| rtime | String | Data receiving time(UTC) |
| gsm | Integer | GSM signal value |
| gnss | Integer | satellite signal value |
| alarms | List | Alarm Type ID Set |
| batMap | Map | Electricity Information Map |
| statusMap | Map | Status Information Map |
| expandMap | Map | Expand Information Map |
batMap description
Battery information, not all content is returned. If the return field does not have this field, the device does not support the content of this field
| Field | Data type | description |
|---|---|---|
| bat | int | Battery Percentage |
| vol | double | Voltage, valid if greater than 0 |
| charge | int | Charging status (2: charging; 3: fully charged; 4: abnormal charging; other: invalid, equivalent to not having this field) |
statusMap description
According to the dynamic display of the return field, if the return field does not have this field, the device does not support the content of this field.
| Field | Data type | description |
|---|---|---|
| acc | int | ACC status (0: off; 1: on) |
| door | int | Door status (0: open; 1: closed) |
| oil | int | Oil circuit status (0: normal; 1: disconnected) |
| ele | int | Power status (0: normal; 1: disconnected) |
| type | int | Data type: (0: real-time; 1: supplementary transmission; 2: alarm) |
| MCU_Speed_Limit | int | Driving speed limit value（km/h） |
| Battery_Lock | int | Battery lock status: (0: locked; 1: unlocked) |
| Anti_Theft | int | Defensive state: (0: not armed; 1: armed) |
| Overcurrent | int | Current status: (0: normal; 1: current overload) |
| Hall | int | Motor Hall status: (0: normal; 1: abnormal) |
| Controller | int | Controller status: (0: normal; 1: abnormal) |
| Ele_Regulate_High_Temp | int | Electric temperature regulation status: (0: normal; 1: temperature too high) |
| Motor_High_Temp | int | Motor temperature status: (0: normal; 1: temperature too high) |
| Disconnection | int | Networking status: (0: in progress; 1: disconnected) |
expandMap description
According to the dynamic display of the return field, if the return field does not have this field, the device does not support the content of this field
| Field | Data type | description |
|---|---|---|
| ext_vol | String | External voltage |
| awaken | String | 0:periodic sampling 1:low battery trigger 2:motion trigger 3:crash trigger 4:light trigger 5:humi&temp trigger 6:temperature trigger 7:humidity trigger 8:clock trigger 9:BT continuous trigger 64:periodic trigger 65:power on trigger 66:ACC ignition 67:ACC flameout 68:VCC connect 69:VCC remove 70:virtual ignition(Gsensor) 71:virtual ignition(GNSSAST) 72:virtual flameout(Gsensor) 73:corner trigger 74:overspeed trigger 75:OTA start 76:OTA succeed 77:OTA failed 78:GNSS first fixed 79: low voltage trigger 80: low voltage release 81:Jamming trigger 82: distance trigger 83:crash trigger 84:DI1 trigger 85:DI2 trigger 86:DI3 trigger 87:DI4 trigger 88:DI5 trigger 89:DI6 trigger 90:DI7 trigger 91:DI8 trigger 92:DI9 trigger 93:DI10 trigger 94:AI upper limit trigger 95:AI lower limit trigger 96:battery low voltage trigger 97:battery low voltage release 98:battery start charging 99:battery full charged 100:soft reset trigger 101:virtual ignition(voltage) 102:virtual flameout(voltage) 103:TOW start 104:TOW stop 105: enter GEO-Fence 106: exit GEO-Fence 107:WAKEUP 108:DI1_UP 109:SPEED_U 110：SPEED_D 111：SPEED_T 112：ACCELER |
| light | String | illuminance |
| light_lim | String | Illumination threshold value |
| temp | String | temperature |
| temp_max | String | High temperature threshold |
| temp_min | String | Low temperature threshold |
| hum | String | humidity |
| hum_max | String | High humidity threshold |
| hum_min | String | Low humidity threshold |
| accel | String | pose information（x:10,y:10,z:10） |
| work_mod | String | Working mode: 0: cycle mode; 1: Trigger mode; 2: Tracking mode+trigger mode; 3: Clock mode+trigger mode; 4: Cycle mode+trigger mode |
| bat_cap | String | Battery capacity, units（mAh） |
| remain_bat_cap | String | Remaining battery capacity（mAh） |
| charge_cnt | String | charge count |
| auxiliary | String | auxiliary JSON String |
auxiliary description
| Field | Data type | description |
|---|---|---|
| gnss_time | String | gnss time(000000000000:invalid) |
| acc_duration | int | acc duration |
| position age | int | position age |
| hdop | int | HDOP |
ble description
| Field | Data type | description |
|---|---|---|
| mac | String | BLE MAC Address |
| rssi | int | BLE RSSI |
| fwVer | String | BLE device firmware version |
| voltage | String | BLE device voltage (V) |
| temperature | String | BLE device temperature (℃) |
| sensor | String | BLE device sensor(x,y,z) |
| moving | String | moving |
| temper | String | temper |
| flag | String | BLE device flag |
作者：admin 创建时间：2023-04-25 10:58
最后编辑：admin 更新时间：2025-07-18 16:29
最后编辑：admin 更新时间：2025-07-18 16:29
