地图实体 地图支持

该集成自动公开了多种专用于地图可视化和管理的实体。这些实体包括用于渲染实时和已保存地图的动态摄像机实体、用于管理多层布局和地图旋转的选择实体、用于触发新映射任务的按钮实体，以及提供历史数据和当前房间跟踪的传感器实体。

这些实体的可用性取决于设备的地图支持能力和活动连接方式。

多层地图支持

最多支持三张已保存地图，并为多层地图管理自动生成摄像机和选择实体。

注意

已保存的地图使用 [original map id][version] 作为它们的 map_id 格式（例如 46）。因此，地图 ID 会不断变化，不能用于实体 ID。相反，地图摄像机实体使用索引系统。地图索引是从地图 ID 排序的已保存地图列表中创建的，并用于命名没有自定义名称的地图。因此，当 map_2 从列表中删除时，将删除 map_3，并且 map_3 将变为 map_2（与官方应用处理方式完全相同）。如果在存在多个已保存地图时禁用多楼层地图，map_1 总是成为选中的地图，而不是删除其他地图。

摄像头

名称	描述	备注
map	实时地图	实时地图图像
map_data	Valetudo-card 的实时地图数据	默认禁用
map_1	第一个保存的地图	索引为 1 的已保存地图
map_2	第二个保存的地图	索引为 2 的已保存地图，如果启用多楼层地图并且地图列表中至少有两个已保存地图，则可用
map_3	第三个保存的地图	索引为 3 的已保存地图，如果启用多楼层地图并且地图列表中至少有三个已保存地图，则可用
map_4	第四个已保存地图	保存的地图位于索引 4，当启用多层地图且地图列表中至少有四个已保存地图时可用（仅适用于带 WiFi 地图的吸尘器）
wifi_map_1	第一个已保存地图的 WiFi 地图	适用于带 WiFi 地图的吸尘器
wifi_map_2	第二个已保存地图的 WiFi 地图	适用于带 WiFi 地图的吸尘器
wifi_map_3	第三个已保存地图的 WiFi 地图	适用于带 WiFi 地图的吸尘器
wifi_map_4	第四个已保存地图的 WiFi 地图	适用于带 WiFi 地图的吸尘器

摄像头实体仅在使用云连接时可用。所有摄像头实体均以基于最后请求时间和当前设备状态的动态刷新率运行。地图仅在发出图像请求时呈现，且仅更新图像的修改区域。

已保存地图的摄像头名称是根据其索引或自定义名称动态生成的。对于多层设置，已保存地图实体采用索引系统而非地图 ID。 更多信息

实时地图无法直接编辑；进行编辑后，已保存地图将被呈现，直到机器人开始新的清洁任务。

注意

map_1 实体总是在多楼层地图功能被禁用时呈现当前选定地图的已保存地图。

关于地图功能的更多信息

按键

名称	描述	备注
start_fast_mapping	开始快速建图	当达到最大地图数量时不可用
start_mapping	创建一个全楼层清扫的新地图	当达到最大地图数量时不可用
backup_saved_map	创建当前已保存地图的备份	在具有地图备份功能的设备上可用

选择

名称	描述	备注
map_rotation	设置所选地图的旋转	可用于地图功能。当当前地图不是选定地图之一时不可用（可以为已保存地图配置不同的旋转，但只有选定地图可以通过该实体进行编辑）
selected_map	当前选定地图	可用于地图功能。当多楼层地图被禁用或不可用时不可用（当更改选定地图时，机器人将结束当前活动任务）

为房间选择实体

房间选择实体是从已保存地图动态生成的，用于编辑每个房间的自定义清洁设置。

有关定制清洁功能的更多信息

传感器

名称	描述	备注
cleaning_history	之前清洁工作的详细属性	可用于地图功能
cruising_history	之前巡航工作的详细属性	可用于地图功能
current_room	吸尘器当前所在的房间	可用于地图功能