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

## reportOutdoorsLocation

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

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

### 描述

设备位置上报。本封装将 lon、lat 及可选扩展字段序列化为云端所需的 payload JSON 字符串后提交。

### 参数

`Params`

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

### 引用对象

##### `type` ReportOutdoorsLocationParams

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `deviceId` | `string` | 设备 ID |
| `pid` | `string` | 产品 ID |
| `lat` | `number` | 纬度，例如：12.1 |
| `lon` | `number` | 经度，例如：123.1 |
| `accuracy` | `number` | 精度，单位：米，例如：100 |
| `battery` | `number` | 电量，例如：10 |
| `direction` | `number` | 方向数值，范围 [0~360]，例如：10 |
| `height` | `number` | 高度，单位：米，例如：10 |
| `coordinate` | `"GCJ02" \| "BD09LL"` | 坐标系：GCJ02、BD09LL 等，例如 GCJ02 |
| `speed` | `number` | 速度，单位 km/h，例如：100 |
| `mileage` | `number` | 里程，单位 KM，例如：100 |
| `start` | `boolean` | 启动，true/false，例如：false |
| `connectStatus` | `1 \| 2` | 连接/断开：1 或 2，例如：1 |


### 示例代码

#### 请求示例

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

reportOutdoorsLocation({
  deviceId: 'vdevo16245017293',
  pid: 'p16245017293',
  lat: 12.1,
  lon: 123.1,
  accuracy: 100,
  battery: 10,
  direction: 10,
  height: 10,
  coordinate: 'GCJ02',
  speed: 100,
  mileage: 100,
  start: false,
  connectStatus: 1,
})
  .then((response) => {
    console.log(response);
  })
  .catch();
```

#### 返回示例

```json
true
```