---
name: "getMultipleMapFiles"
mode: "api"
versionRequirements:
  - { name: "Base Library", version: "2.21.0" }
title: "Multiple Maps"
---

## getMultipleMapFiles

> [VERSION] Base Library >= 2.21.0

### Description

Get the robot vacuum's historical map list

### Parameters

`Params`

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `params` | `GetMultipleMapFilesParams` | Yes | Parameter object containing the device ID |

### Return Value

Type: `Promise<GetMultipleMapFilesResponse>`

Promise that resolves to the historical map list and total count

##### GetMultipleMapFilesResponse

| Property | Type | Description |
| --- | --- | --- |
| `datas` | `MapFile[]` | Historical map list |
| `totalCount` | `number` | Total count |

### Referenced Types

##### `interface` GetMultipleMapFilesParams

| Property | Type | Description |
| --- | --- | --- |
| `devId` | `string` | Device ID |

##### `interface` MapFile

| Property | Type | Description |
| --- | --- | --- |
| `bucket` | `string` | Storage bucket |
| `extend` | `string` | Additional file info |
| `time` | `number` | File timestamp |
| `id` | `number` | Unique file identifier |
| `file` | `string` | File path or URL |
| `devId` | `string` | Associated device ID |
| `fileType` | `string` | File type |


### Examples

```js
const result = await ty.getMultipleMapFiles({
  devId: 'your-device-id',
});
console.log(result.datas, result.totalCount);
```


---
name: "getSweeperStorageConfig"
mode: "api"
versionRequirements:
  - { name: "Base Library", version: "2.23.0" }
title: "Multiple Maps"
---
## getSweeperStorageConfig

> [VERSION] Base Library >= 2.23.0

### Description

Get the robot vacuum's cloud storage configuration

### Parameters

`Params`

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `params` | `GetSweeperStorageConfigParams` | Yes | Parameter object containing the device ID and storage type |

### Return Value

Type: `Promise<GetSweeperStorageConfigResponse>`

Promise that resolves to cloud storage configuration info (ak, sk, token, etc.)

##### GetSweeperStorageConfigResponse

| Property | Type | Description |
| --- | --- | --- |
| `ak` | `string` | Access Key ID |
| `bucket` | `string` | Bucket name |
| `sk` | `string` | Access Key Secret |
| `token` | `string` | Temporary token |
| `endpoint` | `string` | Service endpoint |
| `expiration` | `string` | Token expiration time |
| `lifeCycle` | `number` | TTL (seconds) |
| `region` | `string` | Storage region |

### Referenced Types

##### `interface` GetSweeperStorageConfigParams

| Property | Type | Description |
| --- | --- | --- |
| `devId` | `string` | Device ID |
| `type` | `string` | Storage type, default 'Common' |


### Examples

```js
const config = await ty.getSweeperStorageConfig({
  devId: 'your-device-id',
});
console.log(config.ak, config.bucket);
```


---
name: "deleteMultipleMapFiles"
mode: "api"
versionRequirements:
  - { name: "Base Library", version: "2.21.0" }
title: "Multiple Maps"
---
## deleteMultipleMapFiles

> [VERSION] Base Library >= 2.21.0

### Description

Delete the robot vacuum's historical map files

### Parameters

`Params`

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `params` | `DeleteMultipleMapFilesParams` | Yes | Parameter object containing the device ID and an array of file IDs to delete |

### Return Value

Type: `Promise<boolean>`

Promise that resolves to a boolean indicating whether the deletion succeeded

### Referenced Types

##### `interface` DeleteMultipleMapFilesParams

| Property | Type | Description |
| --- | --- | --- |
| `devId` | `string` | Device ID |
| `fileIds` | `number[]` | Array of historical map file IDs to delete |


### Examples

```js
const result = await ty.deleteMultipleMapFiles({
  devId: 'your-device-id',
  fileIds: [2001, 2002],
});
console.log('Deletion result:', result);
```


---
name: "getGyroLatestCleanMap"
mode: "api"
versionRequirements:
  - { name: "Base Library", version: "2.29.0" }
title: "Multiple Maps"
---
## getGyroLatestCleanMap

> [VERSION] Base Library >= 2.29.0

### Description

Get the latest cleaning map of the gyroscope-based robot vacuum

### Parameters

`Params`

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `params` | `GetGyroLatestCleanMapParams` | Yes | Parameter object containing the device ID and pagination info |

### Return Value

Type: `Promise<GetGyroLatestCleanMapResponse>`

Promise that resolves to the latest cleaning map data

##### GetGyroLatestCleanMapResponse

| Property | Type | Description |
| --- | --- | --- |
| `dataList` | `string[]` | Map data list |
| `startRow` | `string` | Start row marker |
| `devId` | `string` | Device ID |
| `mapId` | `number` | Map ID |
| `startTime` | `number` | Cleaning start timestamp |
| `endTime` | `number` | Cleaning end timestamp |
| `subRecordId` | `number` | Sub-record ID |
| `hasNext` | `boolean` | Whether there is a next page |

### Referenced Types

##### `interface` GetGyroLatestCleanMapParams

| Property | Type | Description |
| --- | --- | --- |
| `devId` | `string` | Device ID |
| `start` | `number` | Start row (startRow) |
| `size` | `number` | Number of items per request |


### Examples

```js
const result = await ty.getGyroLatestCleanMap({
  devId: 'your-device-id',
  start: 0,
  size: 20,
});
console.log(result.dataList, result.hasNext);
```


---
name: "renameHistoryMap"
mode: "api"
versionRequirements:
  - { name: "Base Library", version: "2.27.2" }
title: "Multiple Maps"
---
## renameHistoryMap

> [VERSION] Base Library >= 2.27.2

### Description

Rename a robot vacuum historical map

### Parameters

`Params`

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `params` | `RenameHistoryMapParams` | Yes | Parameter object containing the device ID, map file ID, and new name |

### Return Value

Type: `Promise<boolean>`

Promise that resolves to a boolean indicating whether the rename succeeded

### Referenced Types

##### `interface` RenameHistoryMapParams

| Property | Type | Description |
| --- | --- | --- |
| `devId` | `string` | Device ID |
| `id` | `number` | Map file ID |
| `fileName` | `string` | New file name |


### Examples

```js
const result = await ty.renameHistoryMap({
  devId: 'your-device-id',
  id: 2001,
  fileName: 'Living room map',
});
console.log('Rename result:', result);
```