Skip to content

Valetudo 지도 카드 지도 지원 ​

Valetudo 지도 카드는 원래 Valetudo용으로 설계된 전문화된 지도 렌더링 카드이지만, 최적화 기능을 갖춘 역공학(map data generation) 프로세스를 통해 이 통합과 완전히 호환됩니다.

Valetudo 지도Valetudo 지도

미리 렌더링된 이미지를 표시하는 대신, 이 카드는 전용 데이터 엔터티를 사용하여 원시 지도 좌표를 가져오고 브라우저에서 직접 지도를 렌더링합니다. 이는 렌더링 프로세스를 Home Assistant 서버에서 프론트엔드로 오프로드하여 백엔드 리소스 소비를 0으로 만듭니다. 저사양 하드웨어(CPU 또는 RAM 제한)에서 실행되는 설치 환경의 경우, 모든 다른 이미지 기반 카메라 엔터티를 비활성화하여 백엔드 렌더링을 완전히 중지할 수 있으며, 이 카드를 통해 지도 전체를 그대로 볼 수 있습니다.

요구 사항 ​

Valetudo 지도 카드는 지도 데이터(camera.map_data) 엔터티에 의존하며, 이 엔터티는 통합에서 기본적으로 비활성화되어 있습니다. 카드를 구성하기 전에 이 엔터티를 수동으로 활성화해야 합니다.

지도 데이터 엔터티를 활성화하려면:

  1. Home Assistant에서 장치 페이지로 이동합니다.
  2. 아래로 스크롤하여 구성 섹션으로 이동하고 숨겨진/비활성화된 엔터티를 표시하려면 하단의 링크를 클릭합니다.
  3. 현재 지도 데이터 (camera.map_data) 엔터티를 찾아 클릭합니다.
  4. 오른쪽 상단의 설정 () 아이콘을 클릭하여 엔터티 설정을 엽니다.
  5. 엔터티를 활성화로 전환하고 변경 사항을 저장합니다. 통합이 자동으로 다시 로드됩니다.
yaml
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)

카드 제한 사항

맵 이미지 렌더링은 브라우저에서 이루어지므로 Valetudo Map Card는 자체 색상 인덱스 알고리즘을 사용합니다. 방 아이콘이나 이름을 렌더링하지 않으며, 통합의 지도 데이터에서 방위각 설정은 무시합니다. 그러나 맵 이미지를 훨씬 더 빠르게 생성합니다.

공식 문서 ​