---
name: "getMultipleMapFiles"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.21.0" }
title: "多地图"
---

## getMultipleMapFiles

> [VERSION] 基础库 >= 2.21.0

### 描述

获取扫地机的历史地图列表

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `params` | `GetMultipleMapFilesParams` | 是 | 参数对象，包含设备 ID |

### 返回值

类型: `Promise<GetMultipleMapFilesResponse>`

Promise，resolve 值为历史地图列表和总数

##### GetMultipleMapFilesResponse

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `datas` | `MapFile[]` | 历史地图列表 |
| `totalCount` | `number` | 数据总数 |

### 引用对象

##### `interface` GetMultipleMapFilesParams

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `devId` | `string` | 设备 ID |

##### `interface` MapFile

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `bucket` | `string` | 文件所在存储桶 |
| `extend` | `string` | 文件附加信息 |
| `time` | `number` | 文件时间戳 |
| `id` | `number` | 文件唯一标识符 |
| `file` | `string` | 文件路径或地址 |
| `devId` | `string` | 关联设备 ID |
| `fileType` | `string` | 文件类型 |


### 示例代码

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


---
name: "getSweeperStorageConfig"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.23.0" }
title: "多地图"
---
## getSweeperStorageConfig

> [VERSION] 基础库 >= 2.23.0

### 描述

获取扫地机的云存储配置

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `params` | `GetSweeperStorageConfigParams` | 是 | 参数对象，包含设备 ID 和存储类型 |

### 返回值

类型: `Promise<GetSweeperStorageConfigResponse>`

Promise，resolve 值为云存储配置信息（ak、sk、token 等）

##### GetSweeperStorageConfigResponse

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `ak` | `string` | 访问密钥 ID |
| `bucket` | `string` | 存储桶名称 |
| `sk` | `string` | 访问密钥 Secret |
| `token` | `string` | 临时令牌 |
| `endpoint` | `string` | 服务端点 |
| `expiration` | `string` | 令牌过期时间 |
| `lifeCycle` | `number` | 生命周期（秒） |
| `region` | `string` | 存储区域 |

### 引用对象

##### `interface` GetSweeperStorageConfigParams

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `devId` | `string` | 设备 ID |
| `type` | `string` | 存储类型，默认 'Common' |


### 示例代码

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


---
name: "deleteMultipleMapFiles"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.21.0" }
title: "多地图"
---
## deleteMultipleMapFiles

> [VERSION] 基础库 >= 2.21.0

### 描述

删除扫地机的历史地图文件

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `params` | `DeleteMultipleMapFilesParams` | 是 | 参数对象，包含设备 ID 和要删除的文件 ID 数组 |

### 返回值

类型: `Promise<boolean>`

Promise，resolve 值为 boolean，表示删除是否成功

### 引用对象

##### `interface` DeleteMultipleMapFilesParams

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `devId` | `string` | 设备 ID |
| `fileIds` | `number[]` | 要删除的历史地图文件 ID 数组 |


### 示例代码

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


---
name: "getGyroLatestCleanMap"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.29.0" }
title: "多地图"
---
## getGyroLatestCleanMap

> [VERSION] 基础库 >= 2.29.0

### 描述

获取陀螺仪扫地机的最新清扫地图

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `params` | `GetGyroLatestCleanMapParams` | 是 | 参数对象，包含设备 ID 和分页信息 |

### 返回值

类型: `Promise<GetGyroLatestCleanMapResponse>`

Promise，resolve 值为最新清扫地图数据

##### GetGyroLatestCleanMapResponse

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `dataList` | `string[]` | 地图数据列表 |
| `startRow` | `string` | 起始行标识 |
| `devId` | `string` | 设备 ID |
| `mapId` | `number` | 地图 ID |
| `startTime` | `number` | 清扫开始时间戳 |
| `endTime` | `number` | 清扫结束时间戳 |
| `subRecordId` | `number` | 子记录 ID |
| `hasNext` | `boolean` | 是否有下一页 |

### 引用对象

##### `interface` GetGyroLatestCleanMapParams

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `devId` | `string` | 设备 ID |
| `start` | `number` | 起始行（startRow） |
| `size` | `number` | 每次获取的数据量 |


### 示例代码

```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: "基础库", version: "2.27.2" }
title: "多地图"
---
## renameHistoryMap

> [VERSION] 基础库 >= 2.27.2

### 描述

修改扫地机历史地图的名称

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `params` | `RenameHistoryMapParams` | 是 | 参数对象，包含设备 ID、地图文件 ID 和新名称 |

### 返回值

类型: `Promise<boolean>`

Promise，resolve 值为 boolean，表示重命名是否成功

### 引用对象

##### `interface` RenameHistoryMapParams

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `devId` | `string` | 设备 ID |
| `id` | `number` | 地图文件 ID |
| `fileName` | `string` | 新的文件名称 |


### 示例代码

```js
const result = await ty.renameHistoryMap({
  devId: 'your-device-id',
  id: 2001,
  fileName: '客厅地图',
});
console.log('重命名结果:', result);
```