1.query device location history report
| URL | https://apollo.aovx.com:1443/apollo/getTerminalTrackReport |
|---|---|
| Description | Batch query terminal location history report data through terminal ID |
| Request mode | application/json |
2.Request parameters
2.1.Request header
You need to add “token” information in the request header.
If you do not add token information, you will not be able to pass identity authentication authentication.
2.2.Parameters example
{
"terminalId":"30DA0EE226914658BCEA4E6959BC3796",
"startTimestamp":1685761200000,
"endTimestamp":1685804400000
}2.3.Parameters description
| Properties | Type | Description | Required |
|---|---|---|---|
| terminalId | String | terminal id,ID of the terminal registered to the system | ture |
| startTimestamp | long | Millisecond timestamp of query start time (UTC) | ture |
| endTimestamp | long | Millisecond timestamp of query end time (UTC) | ture |
3.Response content
3.1.Response example(Before encryption)
{
"code": 200,
"message": "Operation succeeded",
"data": [
{
"terminalId": "30DA0EE226914658BCEA4E6959BC3796",
"terminalNum": "413050966240",
"locationType": 1,
"lat": 45.470873,
"lon": -73.579228,
"speed": 0.0,
"direction": 307,
"mileage": 459.0,
"lbsCells": "302,220,11653,56867706,53",
"gnssTime": "2023-05-10T16:09:37Z",
"recvTime": "2023-05-10T16:09:40.140220Z",
"voltage": 55200,
"battery": 81,
"totalCapacity": 30000,
"remainCapacity": 0,
"dischargeCount": 0,
"faultStatus": {
"Disconnection": 0,
"Motor_High_Temp": 0,
"Overcurrent": 0,
"Hall": 0,
"Controller": 0,
"Ele_Regulate_High_Temp": 0
},
"modeStatus": {
"MCU_Speed_Limit": 16,
"Anti_Theft": 0,
"Battery_Lock": 0
},
"wifiList": [
{
"rssi": -70,
"mac": "7c:38:66:07:86:55"
},
{
"rssi": -71,
"mac": "00:25:42:c1:7a:28"
},
{
"rssi": -71,
"mac": "10:06:45:ce:fd:86"
},
{
"rssi": -72,
"mac": "7c:10:c9:e0:8f:38"
},
{
"rssi": -72,
"mac": "98:f4:ab:23:1b:2d"
}
]
},
{
"terminalId": "30DA0EE226914658BCEA4E6959BC3796",
"terminalNum": "413050966240",
"locationType": 1,
"lat": 45.380285,
"lon": -73.516376,
"speed": 4.0,
"direction": 194,
"mileage": 481.0,
"lbsCells": "302,220,11656,31243521,9",
"gnssTime": "2023-05-10T22:19:32Z",
"recvTime": "2023-05-10T22:19:34.564905Z",
"voltage": 54700,
"battery": 69,
"totalCapacity": 26396,
"remainCapacity": 18156,
"dischargeCount": 10,
"faultStatus": {
"Disconnection": 0,
"Motor_High_Temp": 0,
"Overcurrent": 0,
"Hall": 0,
"Controller": 0,
"Ele_Regulate_High_Temp": 0
},
"modeStatus": {
"MCU_Speed_Limit": 16,
"Anti_Theft": 0,
"Battery_Lock": 0
},
"wifiList": [
{
"rssi": -67,
"mac": "18:90:d8:cb:1b:96"
},
{
"rssi": -67,
"mac": "0a:77:7b:56:24:78"
},
{
"rssi": -69,
"mac": "8a:9b:e8:b2:39:88"
},
{
"rssi": -69,
"mac": "12:77:7b:56:24:78"
},
{
"rssi": -70,
"mac": "f2:4d:d4:fc:a7:e7"
}
]
},
{
"terminalId": "30DA0EE226914658BCEA4E6959BC3796",
"terminalNum": "413050966240",
"locationType": 1,
"lat": 45.380285,
"lon": -73.516376,
"speed": 4.0,
"direction": 194,
"mileage": 481.0,
"lbsCells": "302,220,11656,31243521,10",
"gnssTime": "2023-05-10T22:19:57Z",
"recvTime": "2023-05-10T22:19:59.725933Z",
"voltage": 54700,
"battery": 69,
"totalCapacity": 26396,
"remainCapacity": 18156,
"dischargeCount": 10,
"faultStatus": {
"Disconnection": 0,
"Motor_High_Temp": 0,
"Overcurrent": 0,
"Hall": 0,
"Controller": 0,
"Ele_Regulate_High_Temp": 0
},
"modeStatus": {
"MCU_Speed_Limit": 16,
"Anti_Theft": 0,
"Battery_Lock": 0
},
"wifiList": [
{
"rssi": -66,
"mac": "18:90:d8:cb:1b:96"
},
{
"rssi": -69,
"mac": "8a:9b:e8:b2:39:88"
},
{
"rssi": -69,
"mac": "72:5a:b0:7b:76:3a"
},
{
"rssi": -69,
"mac": "b4:b6:86:42:d5:44"
},
{
"rssi": -69,
"mac": "0a:77:7b:56:24:78"
}
]
},
{
"terminalId": "30DA0EE226914658BCEA4E6959BC3796",
"terminalNum": "413050966240",
"locationType": 1,
"lat": 45.380286,
"lon": -73.516378,
"speed": 4.0,
"direction": 194,
"mileage": 481.0,
"lbsCells": "302,220,11656,31243521,10",
"gnssTime": "2023-05-10T22:20:22Z",
"recvTime": "2023-05-10T22:20:25.079913Z",
"voltage": 54700,
"battery": 69,
"totalCapacity": 26396,
"remainCapacity": 18156,
"dischargeCount": 10,
"faultStatus": {
"Disconnection": 0,
"Motor_High_Temp": 0,
"Overcurrent": 0,
"Hall": 0,
"Controller": 0,
"Ele_Regulate_High_Temp": 0
},
"modeStatus": {
"MCU_Speed_Limit": 16,
"Anti_Theft": 0,
"Battery_Lock": 0
},
"wifiList": [
{
"rssi": -67,
"mac": "18:90:d8:cb:1b:96"
},
{
"rssi": -69,
"mac": "8a:9b:e8:b2:39:88"
},
{
"rssi": -69,
"mac": "72:5a:b0:7b:76:3a"
},
{
"rssi": -69,
"mac": "b4:b6:86:42:d5:44"
},
{
"rssi": -70,
"mac": "b8:ec:a3:cb:10:d0"
}
]
},
{
"terminalId": "30DA0EE226914658BCEA4E6959BC3796",
"terminalNum": "413050966240",
"locationType": 1,
"lat": 45.380286,
"lon": -73.516378,
"speed": 4.0,
"direction": 194,
"mileage": 481.0,
"lbsCells": "302,220,11656,31243521,10",
"gnssTime": "2023-05-10T22:20:23Z",
"recvTime": "2023-05-10T22:20:29.807780Z",
"voltage": 54700,
"battery": 69,
"totalCapacity": 26396,
"remainCapacity": 18156,
"dischargeCount": 10,
"faultStatus": {
"Disconnection": 0,
"Motor_High_Temp": 0,
"Overcurrent": 0,
"Hall": 0,
"Controller": 0,
"Ele_Regulate_High_Temp": 0
},
"modeStatus": {
"MCU_Speed_Limit": 16,
"Anti_Theft": 0,
"Battery_Lock": 0
},
"wifiList": [
{
"rssi": -67,
"mac": "18:90:d8:cb:1b:96"
},
{
"rssi": -69,
"mac": "8a:9b:e8:b2:39:88"
},
{
"rssi": -69,
"mac": "72:5a:b0:7b:76:3a"
},
{
"rssi": -69,
"mac": "b4:b6:86:42:d5:44"
},
{
"rssi": -70,
"mac": "b8:ec:a3:cb:10:d0"
}
]
},
{
"terminalId": "30DA0EE226914658BCEA4E6959BC3796",
"terminalNum": "413050966240",
"locationType": 1,
"lat": 45.380288,
"lon": -73.51638,
"speed": 4.0,
"direction": 194,
"mileage": 481.0,
"lbsCells": "302,220,11656,31243521,9",
"gnssTime": "2023-05-10T22:20:48Z",
"recvTime": "2023-05-10T22:20:50.569919Z",
"voltage": 54700,
"battery": 69,
"totalCapacity": 26396,
"remainCapacity": 18156,
"dischargeCount": 10,
"faultStatus": {
"Disconnection": 0,
"Motor_High_Temp": 0,
"Overcurrent": 0,
"Hall": 0,
"Controller": 0,
"Ele_Regulate_High_Temp": 0
},
"modeStatus": {
"MCU_Speed_Limit": 16,
"Anti_Theft": 0,
"Battery_Lock": 0
},
"wifiList": [
{
"rssi": -67,
"mac": "18:90:d8:cb:1b:96"
},
{
"rssi": -69,
"mac": "8a:9b:e8:b2:39:88"
},
{
"rssi": -69,
"mac": "72:5a:b0:7b:76:3a"
},
{
"rssi": -69,
"mac": "b4:b6:86:42:d5:44"
},
{
"rssi": -70,
"mac": "b8:ec:a3:cb:10:d0"
}
]
},
{
"terminalId": "30DA0EE226914658BCEA4E6959BC3796",
"terminalNum": "413050966240",
"locationType": 1,
"lat": 45.380288,
"lon": -73.516381,
"speed": 4.0,
"direction": 194,
"mileage": 481.0,
"lbsCells": "302,220,11656,31243521,9",
"gnssTime": "2023-05-10T22:21:13Z",
"recvTime": "2023-05-10T22:21:15.691665Z",
"voltage": 54700,
"battery": 69,
"totalCapacity": 26396,
"remainCapacity": 18156,
"dischargeCount": 10,
"faultStatus": {
"Disconnection": 0,
"Motor_High_Temp": 0,
"Overcurrent": 0,
"Hall": 0,
"Controller": 0,
"Ele_Regulate_High_Temp": 0
},
"modeStatus": {
"MCU_Speed_Limit": 16,
"Anti_Theft": 0,
"Battery_Lock": 0
},
"wifiList": [
{
"rssi": -67,
"mac": "18:90:d8:cb:1b:96"
},
{
"rssi": -69,
"mac": "8a:9b:e8:b2:39:88"
},
{
"rssi": -69,
"mac": "72:5a:b0:7b:76:3a"
},
{
"rssi": -69,
"mac": "b4:b6:86:42:d5:44"
},
{
"rssi": -70,
"mac": "b8:ec:a3:cb:10:d0"
}
]
}
]
}3.2.Response description
| Field | Data type | description |
|---|---|---|
| code | int | Return code |
| message | String | Return message |
| data | object | Response data |
3.2.1.Response data description
| Properties | Type | Description |
|---|---|---|
| terminalId | String | terminal Id |
| terminalNum | String | terminal Number |
| locationType | Integer | Positioning type,0:Not Positioning;1:GNSS;2:LBS;3:Positioning retention;4:WIFI |
| lat | Double | latitude(WGS-84) |
| lon | Double | longitude(WGS-84) |
| speed | Double | speed,unit: km/h |
| direction | Integer | direction,0~360,0:north |
| mileage | Double | mileage，unit: km |
| lbsCells | String | Communication base station code (format: mcc,mnc,lac,ci,rssi) |
| gnssTime | String | Satellite time (UTC) |
| recvTime | String | Data receiving time of gateway(UTC) |
| gsmValue | Integer | GMS signal value (range：0~31,31 is max,0 is no signal) |
| gnssValue | Integer | GNSS signal value （range: 0~30,It will be related to the local satellite distribution, and generally 5 satellites can complete accurate positioning） |
| battery | Integer | battery,unit: % |
| voltage | Double | voltage,unit: v |
| totalCapacity | Integer | Battery capacity,unit:mAh |
| remainCapacity | Integer | Remain battery capacity,unit:mAh |
| dischargeCount | Integer | Battery discharge count |
| powered | Integer | 0:Built in battery powered;1:External power supply;-1:Unknown, device data has not been updated after adding status |
| faultStatus | Map<String,Object> | such as: “faultStatus”: {“Disconnection”: 0, “Motor_High_Temp”: 0,”Overcurrent”: 0,”Hall”: 1,”Controller”: 0,”Ele_Regulate_High_Temp”: 0} |
| modeStatus | Map<String,Object> | such as:”modeStatus”: {“MCU_Speed_Limit”: 1,”Anti_Theft”: 0,”Battery_Lock”: 0} |
| wifiList | List<Map<String,Object>> | such as:”wifiList”: [{“rssi”: 205,”mac”: “f016281345da”},{“rssi”: 203,”mac”: “94772b6bb9e0”},{“rssi”: 198,”mac”: “d4da210808e2”},{“rssi”: 196,”mac”: “22404d1d88a1”},{“rssi”: 195,”mac”: “22404d1d88af”}] |
faultStatus
| Properties | Type | Description |
|---|---|---|
| Overcurrent | int | Current fault:1:yes;0:No |
| Hall | int | Motor hall fault: 1:yes;0:No |
| Controller | int | Controller fault : 1:yes;0:No |
| Ele_Regulate_High_Temp | int | High temperature fault of electric regulator : 1:yes;0:No |
| Motor_High_Temp | int | Motor high temperature fault: 1:yes;0:No |
| Disconnection | int | Communication disconnection: 1:yes;0:No |
modeStatus
| Properties | Type | Description |
|---|---|---|
| MCU_Speed_Limit | int | Speed limit:unit:km/h |
| Anti_Theft | int | Anti-theft status: 1: armed; 0：cancel |
| Battery_Lock | int | Battery lock status : 1:unlock;0:lock |
| kill_status | int | Permanently locking the scooter; 1:on;0:off |
| switch_status | int | Scooter switch status; 1:on;0:off |
wifiList
| Properties | Type | Description |
|---|---|---|
| rssi | int | rssi |
| mac | String | wifi mac |
4.Postman Request
Before encryption:
After encryption:
作者：admin 创建时间：2023-10-17 12:53
最后编辑：admin 更新时间：2023-10-31 18:39
最后编辑：admin 更新时间：2023-10-31 18:39
