Cloud Services API ReferenceAdvanced Device ServicesLocation-Based ServiceHistorical TrackGet Device Track Point

Get Device Track Point

Last Updated on : 2023-06-20 14:52:23download

Get device track points by time period. The period between the end time and the start time is less than or equal to seven days. A maximum of 1,000 track points can be returned at a time. If the number of track points in the time period is greater than 1,000, the first 1,000 track points and the start time for the next query will be returned. In order to improve response speed and avoid request timeout caused by excessive track points, we recommend that you shorten the time interval of each request and split the track into multiple segments for splicing.

API address

GET: /v2.0/iot-01/tracks/detail

Request parameter

Parameter name	Type	IN	Required	Description
device_id	String	query	true	The device ID.
start_time	Long	query	true	The 13-bit timestamp of the start time.
end_time	Long	query	true	The 13-bit timestamp of the end time.
coord_type	String	query	false	Indicates the type of longitude and latitude positioning coordinate system. Valid values: `WGS84`: Google Coordinate System. `GCJ02`: AutoNavi. `BD09LL`: Baidu. Empty value: defaults to AutoNavi for China data center, and Google for other data centers.

Return parameter

Parameter name	Type	Description
result	TrackDetailRes	The details of track points.

Description of result

Parameter name	Type	Description
device_id	String	The device ID.
point_list	List	The list of track points in ascending order of time.
start_time	Long	The timestamp when the next query starts.
has_more	Boolean	Specifies whether to return the next page. If the total number of track points is less than 1,000, it is the last page and the value is `false`. Otherwise, it is `true`.

Description of point_list

Parameter name	Type	Description
lon	Double	The longitude.
lat	Double	The latitude.
speed	Double	The speed. Unit: kilometers/hour. The magnification conversion has been completed.
protocol	String	The positioning type. Valid values: `GPS`, `WIFI`, and `LBS`.
report_time	Long	The 13-bit timestamp when the positioning is reported. Unit: milliseconds.

Request example

GET: /v2.0/iot-01/tracks/detail?device_id=vdevo16245017293****&start_time=1625198100154&end_time=1625198190154

Return example

{
    "result": {
        "device_id": "vdevo16245017293****",
        "has_more": false,
        "point_list": [
            {
                "lon": 114.003117,
                "battery": 100,
                "speed": 100,
                "protocol": "GPS",
                "lat": 22.594031,
                "mileage": 0,
                "timestamp": 1625198100154
            }
        ]
    },
    "t": 1625232399998,
    "success": true
}

Error code

For more information, see error code.

Prev DocGet Device Track Segment

Next DocAlert Management