Сущности карты Поддержка карт

Интеграция автоматически предоставляет различного рода сущности, предназначенные для визуализации и управления картами. К ним относятся динамические камеры для отображения живых и сохранённых карт, селекторы для управления многоэтажными планировками и поворотом карты, кнопки для запуска новых задач картографирования, а также сенсоры, предоставляющие исторические данные и текущую отслеживаемость помещений.

Доступность этих сущностей зависит от возможностей устройства по поддержке карт и выбранного метода подключения.

Поддержка многоэтажных карт

До трёх сохранённых карт с автоматически создаваемыми камерами и селекторами для управления картами нескольких этажей.

Примечание

Сохранённые карты используют [original map id][version] в качестве их формата map_id (например, 46). По этой причине идентификаторы карт постоянно меняются и не могут использоваться в идентификаторах объектов. Вместо этого объекты камеры карты используют систему индексирования. Индексы карт создаются из упорядоченного списка сохранённых карт по идентификатору карты и используются для именования карт без пользовательских названий. Поэтому, когда 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

Камерные объекты доступны только при использовании облачного подключения. Все камерные объекты работают с динамической частотой обновления, определяемой временем последнего запроса и текущим состоянием устройства. Карта отображается только при запросе изображения, и обновляются только изменённые области изображения.

Названия камер сохранённых карт генерируются динамически на основе их индекса или пользовательского имени. Для многоэтажных установок объекты сохранённых карт используют систему индексирования вместо идентификатора карты. Подробнее

Живую карту нельзя редактировать напрямую; после внесения изменений сохраняемая карта отображается до тех пор, пока робот не начнёт новую задачу по уборке.

Примечание

Сущность map_1 всегда отображает сохранённую карту текущей выбранной карты, когда функция многослойной карты отключена.

Для получения дополнительной информации о функции карты

Кнопка

Название	Описание	Примечания
start_fast_mapping	Запустить быстрое построение карты	Недоступно, когда достигнуто максимальное количество карт
start_mapping	Создать новую карту с уборкой всего этажа	Недоступно, когда достигнуто максимальное количество карт
backup_saved_map	Создать резервную копию текущей сохранённой карты	Доступно на устройствах с функцией резервного копирования карты

Выбрать

Название	Описание	Примечания
map_rotation	Устанавливает вращение выбранной карты	Доступно с функцией карты. Недоступно, когда текущая карта не является одной из выбранных карт (можно настроить различное вращение для сохранённых карт, но редактируема через эту сущность только выбранная карта)
selected_map	Текущая выбранная карта	Доступно с функцией карты. Недоступно, когда функция многослойной карты отключена или недоступна (робот завершит текущую задачу, если выбранная карта изменена)

Выбрать сущности для комнат

Сущности выбора комнаты динамически создаются из сохранённых карт и используются для редактирования индивидуальных настроек уборки для каждой комнаты.

Для получения дополнительной информации о функции индивидуальной уборки

Сенсор

Название	Описание	Примечания
cleaning_history	Подробности предыдущих уборок как атрибуты	Доступно с функцией карты
cruising_history	Подробности предыдущих работ по уборке помещений как атрибуты	Доступно с функцией карты
current_room	Текущая комната, в которой находится пылесос	Доступно с функцией карты