---
name: "getOutdoorsTracksSegments"
mode: "kit"
versionRequirements:
  - { name: "@tuya-miniapp/cloud-api", version: "1.0.5" }
---

## getOutdoorsTracksSegments

> [VERSION] @tuya-miniapp/cloud-api >= 1.0.5

> 💡 该接口为云能力，需开通授权后使用，关于云能力可[查看文档](/cn/miniapp/common/desc/tech-stack/api)。
> 注意：目前云能力在「开发者工具」环境无法使用，需要打包后或真机调试使用。

### 描述

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

### 参数

`Params`

| 参数 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `data` | `GetOutdoorsTracksSegmentsParams` | 是 | - | 请求体 |

### 引用对象

##### `type` GetOutdoorsTracksSegmentsParams

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `deviceId` | `string` | 设备 ID |
| `startTime` | `number` | 开始时间 13 位时间戳 |
| `endTime` | `number` | 结束时间 13 位时间戳 |
| `lastId` | `number` | 下一页起始 ID，第一次请求传空 |
| `needRated` | `boolean` | 倍率转换 |
| `lessMileage` | `number` | 只返回里程大于 lessMileage 的轨迹 |

##### `type` SegmentItem

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `startTime` | `number` | 分段开始时间（13 位时间戳） |
| `endTime` | `number` | 分段结束时间（13 位时间戳） |
| `duration` | `number` | 持续时长 |
| `speed` | `number` | 速度 |
| `mileage` | `number` | 里程 |
| `battery` | `number` | 电量 |


### 示例代码

#### 请求示例

```typescript
import { getOutdoorsTracksSegments } from '@tuya-miniapp/cloud-api';

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

#### 返回示例

```json
{
  "deviceId": "vdevo16245017293****",
  "segmentList": [
    {
      "endTime": 1625198190154,
      "battery": 5,
      "speed": 100,
      "duration": 3000,
      "startTime": 1625198100154,
      "mileage": 10
    }
  ],
  "hasMore": false
}
```