获取设备轨迹分段

更新时间:2021-07-22 08:15:19下载pdf

本文介绍获取设备轨迹分段的 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 }

错误码

参考 错误码