Valetudo-Kartenkarte Kartenunterstützung

Die Valetudo-Kartenkarte ist eine spezielle Kartenanzeige-Karte, die ursprünglich für Valetudo entwickelt wurde, aber über einen rückentwickelten Karten-Datengenerierungsprozess mit Optimierungsfunktionen vollständig mit dieser Integration kompatibel ist.

Anstatt ein vorgerendertes Bild anzuzeigen, nutzt diese Karte eine spezielle Datenentität, um Roh-Kartenkoordinaten abzurufen und rendert die Karte direkt im Browser. Dies verlagert den Renderprozess vom Home Assistant-Server auf das Frontend, was zu keinem Verbrauch von Backend-Ressourcen führt. Für Installationen, die auf hardwarearmen Geräten (begrenzte CPU oder RAM) laufen, können alle anderen bildbasierten Kamera-Entitäten deaktiviert werden, um das Backend-Rendering vollständig auszuschalten, während die vollständige Kartenanzeige über diese Karte erhalten bleibt.

Anforderungen

Die Valetudo Map Card verlässt sich auf die Map Data (camera.map_data)-Entität, die in der Integration standardmäßig deaktiviert ist. Bevor die Karte konfiguriert wird, muss diese Entität manuell aktiviert werden.

Um die Karten-Datenentität zu aktivieren:

1. Navigieren Sie zur Gerätestation für das Gerät in Home Assistant.
2. Scrollen Sie zum Abschnitt Konfiguration und klicken Sie auf den Link unten, um versteckte/deaktivierte Entitäten anzuzeigen.
3. Suchen Sie die Entität Aktuelle Kartendaten (camera.map_data) und klicken Sie darauf.
4. Klicken Sie auf das Symbol Einstellungen () oben rechts, um die Entitätseinstellungen zu öffnen.
5. Schalten Sie die Entität auf aktiv und speichern Sie die Änderungen. Die Integration wird automatisch neu geladen.

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)

Einschränkungen der Karte

Da das Rendern des Kartenbildes im Browser erfolgt, verwendet die Valetudo Map Card ihren eigenen Farbindex-Algorithmus. Sie rendert keine Raum-Symbole oder Namen und ignoriert die Kartendrehungs-Einstellung aus den Kartendaten der Integration. Sie generiert jedoch die Kartenbilder deutlich schneller.

Offizielle Dokumentation