1.URL

http://124.223.60.234:8080/system/asset/location/queryLocationDataList
or Server in US
https://cloud.aovx.com/prod/system/asset/location/queryLocationDataList

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

["1CCE240C-36FA-47E6-B3D6-E1437840989C","C0CD5251-7A45-4869-8C53-3FD68C1C712C","88F5D920E9BF4C6C9CC027A0CFA85CF4","42EA1752-00BF-46C2-8132-6F103B31B24B","43EA1752-94BF-46C2-8132-6F103B31B23B"]

2.3.Parameters description

List<String>set of unique device identifiers in the system

3.Response content

3.1.Response example

{
    "code": 200,
    "message": "Operation succeeded",
    "data": [
        {
            "locType": 0,
            "lat": 0.0,
            "lon": 0.0,
            "speed": 0.0,
            "dir": 0,
            "mil": 0.0,
            "lbs": "460,0,10156,220814416,21",
            "gsm": 19,
            "gnss": 0,
            "alarms": [],
            "batMap": {
                "vol": "0.0",
                "charge": "2",
                "bat": "0"
            },
            "statusMap": {
                "acc": 0,
                "door": 0,
                "oil": 1,
                "type": 0,
                "ele": 1
            },
            "expandMap": {
                "ext_vol": "55.341"
            },
            "gtime": "2023-01-07T06:18:34Z",
            "tid": "1CCE240C-36FA-47E6-B3D6-E1437840989C",
            "rtime": "2023-01-07T06:18:35.608628Z"
        },
        {
            "locType": 1,
            "lat": 31.83292,
            "lon": 117.095553,
            "speed": 0.0,
            "dir": 0,
            "mil": 0.0,
            "lbs": "460,0,21771,139532462,22",
            "gsm": 23,
            "gnss": 7,
            "alarms": [],
            "batMap": {
                "vol": "0.0",
                "bat": "0"
            },
            "statusMap": {
                "acc": 0,
                "door": 0,
                "oil": 0,
                "type": 0,
                "ele": 0
            },
            "expandMap": {
                "ext_vol": "13.086"
            },
            "gtime": "2023-01-31T07:40:56Z",
            "tid": "C0CD5251-7A45-4869-8C53-3FD68C1C712C",
            "rtime": "2023-01-31T07:40:58.588109Z"
        },
        {
            "locType": 1,
            "lat": 37.479973,
            "lon": 109.430683,
            "speed": 60.0,
            "dir": 0,
            "mil": 5000.0,
            "gsm": 0,
            "gnss": 0,
            "alarms": [],
            "batMap": {
                "vol": "0.0",
                "bat": "0"
            },
            "statusMap": {
                "acc": 0,
                "door": 1,
                "oil": 1,
                "type": 0,
                "ele": 1
            },
            "expandMap": {},
            "gtime": "2023-02-01T23:06:06Z",
            "tid": "88F5D920E9BF4C6C9CC027A0CFA85CF4",
            "rtime": "2023-02-01T15:06:06.112014Z"
        },
        {
            "locType": 1,
            "lat": 31.832951,
            "lon": 117.095436,
            "speed": 0.0,
            "dir": 299,
            "mil": 0.0,
            "lbs": "460,0,21771,139532462,35",
            "gsm": 27,
            "gnss": 19,
            "alarms": [
                "7"
            ],
            "batMap": {
                "vol": "0.0",
                "bat": "0"
            },
            "statusMap": {
                "acc": 1,
                "door": 0,
                "oil": 0,
                "type": 2,
                "ele": 0
            },
            "expandMap": {
                "ext_vol": "13.013"
            },
            "gtime": "2022-12-15T02:49:30Z",
            "tid": "42EA1752-00BF-46C2-8132-6F103B31B24B",
            "rtime": "2022-12-15T02:52:56.355048Z"
        },
        {
            "locType": 1,
            "lat": 30.6263,
            "lon": 104.047213,
            "speed": 52.0,
            "dir": 304,
            "mil": 0.0,
            "lbs": "460,0,32787,134386200,40",
            "gsm": 0,
            "gnss": 0,
            "alarms": [],
            "batMap": {
                "vol": "3.503",
                "bat": "0"
            },
            "statusMap": {
                "acc": 0,
                "door": 0,
                "oil": 0,
                "type": 0,
                "ele": 0
            },
            "expandMap": {
                "light": "0"
            },
            "gtime": "2022-12-07T07:16:56Z",
            "tid": "43EA1752-94BF-46C2-8132-6F103B31B23B",
            "rtime": "2022-12-07T07:43:26.011735Z"
        }
    ]
}

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)
network int 1-NB-IOT;2-LTE;3-WCDMA;4-GSM;5:eMTC;6-CATM;7：WIFI
galaxy int Positioning system (0: Unknown; 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 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
作者：admin  创建时间：2023-04-25 10:57
最后编辑：admin  更新时间：2025-07-21 21:33