获取设备轨迹分段

更新时间：2023-06-15 04:58:14

本文介绍获取设备轨迹分段的 API。

接口描述

分页获取设备轨迹分段，结束时间与起始时间差小于等于 7 天，单次最多返回 1000 个轨迹分段。如果时间段内的轨迹分段数量大于 1000 就返回前 1000 个轨迹分段以及下次查询的分页的起始 ID。

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	query	true	设备 ID
start_time	Long	query	true	开始时间 13 位时间戳
end_time	Long	query	true	结束时间 13 位时间戳
last_id	Long	query	false	下一页起始 ID，第一次请求传空

返回参数

参数名	类型	说明
result	TrackSegmentRes

result 说明

参数名	类型	说明
device_id	String	设备 ID
segment_list	List	轨迹分段集合，按时间降序
last_id	Long	如果有下一页，代表下一页起始 ID。
has_more	Boolean	是否有下一页；若此次轨迹点集合总数小于 1000，则为最后一页，值为 false，否则值为 true

segment_list 说明

参数名	类型	说明
start_time	Long	开始时间戳 13 位时间戳
end_time	Long	结束时间 13 位时间戳
duration	Long	分段时长，单位秒
speed	Double	速度，单位：千米/小时，已完成倍率转换
mileage	Double	分段里程，单位千米，已完成倍率转换
battery	Integer	分段耗费电量， 0 到 100 的整数

请求示例

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

返回示例

{
    "result": {
        "device_id": "vdevo16245017293****",
        "segment_list": [
            {
                "end_time": 1625198190154,
                "battery": 5,
                "speed": 100,
                "duration": 3000,
                "start_time": 1625198100154,
                "mileage": 10
            }
        ],
        "has_more": false
    },
    "t": 1625736304038,
    "success": true
}

错误码

参考错误码。

上一篇历史轨迹