1.query device last location

URL http://124.223.60.234:8182/apollo/getTerminalTrackReport
Description Batch query terminal location data through terminal ID collection
Request mode application/json

2.Request parameters

2.1.Parameters example

{
    "terminalId":"30DA0EE226914658BCEA4E6959BC3796",
    "startTimestamp":1685761200000,
    "endTimestamp":1685804400000
}

2.2.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

{
    "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

作者：admin  创建时间：2023-05-11 14:48
最后编辑：admin  更新时间：2023-09-25 14:56