Cartão de Mapa Valetudo Suporte a Mapas

O Cartão de Mapa Valetudo é um cartão de renderização de mapa especializado originalmente projetado para Valetudo, mas totalmente compatível com esta integração através de um processo de geração de dados de mapa desenvolvido de forma reversa com recursos de otimização.

Em vez de exibir uma imagem pré-renderizada, este cartão utiliza uma entidade de dados dedicada para buscar coordenadas de mapa brutas e renderiza o mapa diretamente no navegador. Isso transfere o processo de renderização do servidor do Home Assistant para o frontend, resultando em consumo zero de recursos do backend. Para instalações rodando em hardware com poucos recursos (CPU ou RAM limitadas), todas as outras entidades de câmera baseadas em imagem podem ser desativadas para desligar completamente a renderização do backend, enquanto ainda mantém a visualização completa do mapa através deste cartão.

Requisitos

O Cartão do Mapa Valetudo depende da entidade Dados de Mapa (camera.map_data), que é desativada por padrão na integração. Antes de configurar o cartão, esta entidade deve ser ativada manualmente.

Para ativar a entidade de dados do mapa:

1. Navegue até a página do dispositivo para o dispositivo no Home Assistant.
2. Role para baixo até a seção Configuração e clique no link na parte inferior para revelar entidades ocultas/desabilitadas.
3. Localize e clique na entidade Dados de Mapa Atual (camera.map_data).
4. Clique no ícone Configurações () no canto superior direito para abrir as configurações da entidade.
5. Ative a entidade e salve as alterações. A integração será recarregada automaticamente.

type: custom:valetudo-map-card
vacuum: # Your vacuum name not the entity id
rotate: 0 # Map rotation entity does not work on valetudo map card
dock_icon: mdi:lightning-bolt-circle
dock_color: rgb(105 178 141)
vacuum_color: rgb(110, 110, 110)
wall_color: rgb(159, 159, 159)
floor_color: rgb(221, 221, 221)
no_go_area_color: rgb(177, 0, 0)
no_mop_area_color: rgb(170, 47, 255)
virtual_wall_color: rgb(199, 0, 0)
virtual_wall_width: 1.5
currently_cleaned_zone_color: rgb(221, 221, 221)
path_color: rgb(255, 255, 255)
path_width: 1.5
segment_opacity: 1
segment_colors:
  - rgb(171, 199, 248)
  - rgb(249, 224, 125)
  - rgb(184, 227, 255)
  - rgb(184, 217, 141)

Limitações do Cartão

Como a renderização da imagem do mapa acontece no navegador, o Cartão de Mapa Valetudo usa seu próprio algoritmo de índice de cores. Ele não renderiza ícones ou nomes de cômodos, e ignora a configuração de rotação do mapa a partir dos dados do mapa da integração. No entanto, gera imagens de mapa muito mais rapidamente.

Documentação Oficial