获取设备轨迹点

更新时间:2023-06-20 14:52:23下载pdf

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

接口描述

根据时间段获取设备轨迹点。结束时间与起始时间差小于等于 7 天,单次最多返回 1000 个轨迹点。如果时间段内的轨迹点数量大于 1000 则返回前 1000 个轨迹点以及下次查询的开始时间。为提升响应速度,同时避免轨迹点过多造成请求超时,建议缩短每次请求的时间区间,将轨迹拆分成多段进行拼接。

接口地址

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

请求参数

参数名 类型 参数位置 是否必填 说明
device_id String query true 设备 ID
start_time Long query true 开始时间 13 位时间戳
end_time Long query true 结束时间 13 位时间戳
coord_type String query false 经纬度定位坐标系类型:
  • WGS84:谷歌坐标系
  • GCJ02:高德
  • BD09LL:百度
  • 不传:国内默认高德,国外默认谷歌

返回参数

参数名 类型 说明
result TrackDetailRes 轨迹点详情

result 说明

参数名 类型 说明
device_id String 设备 ID
point_list List 轨迹点集合,按时间升序排列
start_time Long 下一页查询时的开始时间戳
has_more Boolean 是否有下一页;若此次轨迹点集合总数小于1000,则为最后一页,值为false,否则值为 true。

point_list 说明

参数名 类型 说明
lon Double 经度
lat Double 纬度
speed Double 速度,单位:千米/小时, 已完成倍率转换
protocol String 定位类型,支持 GPS、 WIFI 和 LBS
report_time Long 定位上报时间 13 位毫秒时间戳

请求示例

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

返回示例

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

错误码

参考 错误码