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

## getOutdoorsTracksLocation

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

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

### 描述

根据设备 ID 批量查询设备实时位置。

### 参数

`Params`

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

### 引用对象

##### `type` GetOutdoorsTracksLocationParams

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `deviceIds` | `string` | 设备 ID 集合，以逗号分开，最多 50 个 |
| `coordType` | `string` | 经纬度定位坐标系类型：WGS84、GCJ02、BD09LL；不传时国内默认高德，国外默认谷歌 |

##### `type` GetOutdoorsTracksLocationResult

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `deviceLocationList` | `DeviceLocationItem[]` | 各设备实时位置列表 |


### 示例代码

#### 请求示例

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

getOutdoorsTracksLocation({
  deviceIds: 'vdevo16245017293',
})
  .then((response) => {
    console.log(response);
  })
  .catch();
```

#### 返回示例

```json
{
  "deviceLocationList": [
    {
      "deviceId": "vdevo16245017293****",
      "lon": 114.003117,
      "speed": 100,
      "protocol": "GPS",
      "lat": 22.594031,
      "timestamp": 1625198100154
    }
  ]
}
```