---
name: "saveCustomizePosition"
mode: "api"
versionRequirements:
  - { name: "@ray-js/ray", version: "1.5.2" }
title: "saveCustomizePosition - Create Device Custom Location"
---

## saveCustomizePosition

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

### Description

Create custom device location information. If the weather API does not support the device’s provisioning coordinates, you can use custom device latitude/longitude to obtain real-time weather, e.g., for outdoor wearables.

### Parameters

`Params`

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `params` | `ISaveCustomizePosition` | Yes | Request parameters |

### Return Value

Type: `Promise<boolean>`

Whether the save was successful

### Referenced Types

##### `interface` ISaveCustomizePosition

| Property | Type | Description |
| --- | --- | --- |
| `devId` | `string` | Device ID |
| `lon` | `string` | Longitude |
| `lat` | `string` | Latitude |
| `locationName` | `string` | Location name (currently unused; does not affect weather results) |


### Examples

#### Basic usage

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

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