获取设备轨迹点

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

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

错误码

参考错误码。

上一篇获取设备轨迹分段

下一篇告警管理