getOutdoorsTracksDetail(data: GetOutdoorsTracksDetailParams)

版本要求:
@tuya-miniapp/cloud-api≥1.0.5

描述

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

参数

参数类型必填说明
是请求体

返回值

类型:Promise<GetOutdoorsTracksDetailResult>
GetOutdoorsTracksDetailResult(字段含义见类型定义与 minituya 返回值表)

引用对象

typeGetOutdoorsTracksDetailResult
属性类型描述
deviceIdstring设备 ID
轨迹点列表
startTimenumber下一页查询时的开始时间戳
hasMoreboolean是否还有下一页

示例代码

请求示例

import { getOutdoorsTracksDetail } from '@tuya-miniapp/cloud-api';

getOutdoorsTracksDetail({
  deviceId: 'vdevo16245017293',
  startTime: 1625198100154,
  endTime: 1625198190154,
})
  .then((response) => {
    console.log(response);
  })
  .catch();

返回示例

{
  "deviceId": "vdevo16245017293****",
  "hasMore": false,
  "pointList": [
    {
      "lon": 114.003117,
      "battery": 100,
      "speed": 100,
      "protocol": "GPS",
      "lat": 22.594031,
      "mileage": 0,
      "timestamp": 1625198100154
    }
  ]
}