Tarjeta de mapa en Home Assistant (map card)

La tarjeta de mapa se ha consolidado como una herramienta esencial en el mundo digital actual, especialmente para aquellos que desean visualizar entidades o fuentes de geolocalización en un mapa interactivo, brindando una perspectiva clara y concisa de la ubicación y movimiento de diferentes entidades. Esta herramienta no solo facilita la visualización, sino que también mejora la interacción del usuario, permitiéndole obtener detalles específicos al interactuar con el mapa. Sin embargo, surge una pregunta crucial: ¿cómo añadirla a nuestra interfaz de usuario y cuáles son las distintas opciones y configuraciones que nos ofrece para adaptarse a nuestras necesidades específicas? La respuesta es más sencilla de lo que parece y, en los siguientes apartados, te guiaré paso a paso sobre cómo hacerlo.

Índice de contenido

Configuración YAML para la tarjeta de mapa

Si eres fanático de usar el modo YAML o simplemente prefieres utilizar YAML en el Editor de Código en la UI, aquí te presento las opciones que tienes disponibles:

Variables de configuración

type (cadena REQUERIDA): Representa el tipo de tarjeta, en este caso, «mapa».
entities (lista REQUERIDA): Lista de IDs de entidades o objetos de entidades. Es necesario definir esto o la opción de configuración «geo_location_sources».
geo_location_sources (lista REQUERIDA): Lista de fuentes de geolocalización. Define «all» para usar todas las fuentes disponibles.
auto_fit (booleano, opcional): Si está activado, el mapa seguirá las entidades en movimiento ajustando el viewport.
title (cadena, opcional): Título de la tarjeta.
aspect_ratio (cadena, opcional): Define la relación de aspecto del mapa.
default_zoom (entero, opcional): Nivel de zoom predeterminado del mapa.
dark_mode (booleano, opcional): Activa el tema oscuro para el mapa.
hours_to_show (entero, opcional): Muestra una ruta de ubicaciones previas en el mapa.

Nota: Solo las entidades con atributos de latitud y longitud serán mostradas en el mapa.

Opciones para entidades

Si defines las entidades como objetos en lugar de cadenas, puedes añadir más personalización:

entity (cadena REQUERIDA): ID de la entidad.
name (cadena, opcional): Reemplaza la etiqueta predeterminada para el marcador.
label_mode (cadena, opcional): Renderiza el estado de la entidad como etiqueta.
focus (booleano, opcional): Determina el zoom o ajuste predeterminado del mapa.

Opciones adicionales para marcadores de entidades en el mapa

Gracias a las actualizaciones, ahora es posible elegir si deseas que se muestre el nombre de la entidad o su estado en el mapa. Incluso puedes mostrar valores de estado, como precios de gasolina, para ver dónde es más económico.

Tabla de características principales de la tarjeta de mapa

Característica (Inglés)	Característica (Español)	Descripción
Type	Tipo	Mapa
entities	Entidades	IDs o objetos de entidades
geolocation_sources	Fuentes de geolocalización	Lista de fuentes o «all»
auto_fit	Auto ajuste	Seguimiento de entidades móviles
aspect_ratio	Relación de aspecto	Porcentaje o relación
default_zoom	Zoom predeterminado	Nivel de zoom inicial
dark_mode	Modo oscuro	Tema oscuro activable
hours_to_show	Horas para mostrar	Ruta de ubicaciones previas

Códigos de ejemplo para crear la tarjeta de mapa (map card)

type: map
default_zoom: 12
entities:
  - entity: sensor.petrem_sarria_95
    label_mode: state
  - entity: sensor.cepsa_pont_de_la_barca_95
    label_mode: state

*El label_mode hay que ponerlo en todos los sensores. Este ejemplo lo vimos en cómo geolocalizar los sensores de gasolinera en nuestro Home Assistant.

type: map
entities:
  - device_tracker.usuario_ejemplo
  - entity: sensor.estacion_gasolina_precio
    label_mode: state
    focus: false
hours_to_show: 48

type: map
aspect_ratio: 16:9
default_zoom: 8
auto_fit: true
entities:
  - device_tracker.usuario_ejemplo
  - zone.oficina

type: map
geo_location_sources:
  - servicio_incendios_rural
entities:
  - zone.oficina

Personalización de la Apariencia del Mapa

1. Modo Oscuro

Como ya hemos mencionado, puedes activar el dark_mode para que tu mapa tenga un tema oscuro.

type: map dark_mode: true entities: - device_tracker.usuario_ejemplo

2. Estilo de los Marcadores

El estilo de los marcadores puede adaptarse según tus preferencias o necesidades. El atributo label_mode permite determinar qué información se mostrará en el marcador:

name: Este es el valor predeterminado. Muestra el nombre de la entidad.
state: Muestra el estado actual de la entidad. Por ejemplo, para una sensor.estacion_gasolina_precio, mostraría el precio del combustible.

type: map entities: - entity: sensor.estacion_gasolina_precio label_mode: state

Nota: Es importante mencionar que el label_mode no se aplica a las entidades de zona, ya que estas no utilizan una etiqueta sino un icono.

3. Personalizar Colores

Aunque la personalización directa de colores no está integrada en la tarjeta de mapa, se pueden usar tarjetas personalizadas o complementos de la comunidad.

4. Aspecto del Mapa

La relación de aspecto, o aspect_ratio, determina cómo se visualiza el mapa en relación al espacio disponible. Puedes establecerla de dos maneras:

Usando un porcentaje para la altura: como «23%».
Usando una relación: como «16:9» o «16×9». Si se omite el segundo número, se asumirá «1». Por ejemplo, «1.78» es lo mismo que «1.78:1».

type: map aspect_ratio: "16:9" entities: - device_tracker.usuario_ejemplo

5. Zoom Predeterminado

El nivel de default_zoom determina cuánto se acercará o alejará el mapa inicialmente:

El rango típico para el zoom va de 1 (vista más alejada) a 20 (vista más cercana).

type: map
default_zoom: 8
entities:
  - device_tracker.usuario_ejemplo

La opción auto_fit ajusta automáticamente el nivel de zoom y el centro del mapa para que incluya todas las entidades visibles. Si se establece en true, el mapa seguirá a las entidades en movimiento, ajustando la vista cada vez que una entidad se actualice.

type: map
auto_fit: true
entities:
  - device_tracker.usuario_ejemplo

Resumen:

En el mundo digital actual, la tarjeta de mapa en Home Assistant se presenta como una herramienta imprescindible para visualizar y seguir entidades geolocalizadas. Su adaptabilidad permite a los usuarios visualizar, en tiempo real, la ubicación y movimiento de diferentes entidades en un mapa interactivo. A través de la configuración YAML, se pueden personalizar aspectos tales como el tipo de tarjeta, las entidades mostradas, las fuentes de geolocalización, entre otros. Además, se ofrecen opciones para personalizar la apariencia del mapa, como el modo oscuro, estilo de los marcadores y la relación de aspecto. Con códigos de ejemplo y una tabla descriptiva, este artículo provee una guía comprensiva sobre cómo implementar y personalizar la tarjeta de mapa en tu interfaz de Home Assistant, potenciando así tu experiencia y la interacción con las geolocalizaciones.