---
name: "saveCustomizePosition"
mode: "api"
versionRequirements:
  - { name: "@ray-js/ray", version: "1.5.2" }
title: "saveCustomizePosition - 创建设备自定义位置信息"
---

## saveCustomizePosition

> [VERSION] @ray-js/ray >= 1.5.2

### 描述

创建设备自定义位置信息。当天气接口不适用于设备配网经纬度时，可通过自定义设备经纬度获取实时天气，例如户外穿戴设备。

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `params` | `ISaveCustomizePosition` | 是 | 请求参数 |

### 返回值

类型: `Promise<boolean>`

是否成功保存

### 引用对象

##### `interface` ISaveCustomizePosition

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `devId` | `string` | 设备 ID |
| `lon` | `string` | 经度 |
| `lat` | `string` | 纬度 |
| `locationName` | `string` | 位置名称（目前没用，不影响天气返回结果） |


### 示例代码

#### 基础用法

```ts
import { saveCustomizePosition } from '@ray-js/ray';

saveCustomizePosition({
  devId: 'your_device_id',
  lon: '113.2333',
  lat: '23.1666',
}).then((response) => {
  console.log('保存结果:', response);
}).catch((err) => {
  console.error(err);
});
```