# Home Assistant

La integración oficial de Mapit para Home Assistant pone cada uno de tus vehículos en el mapa como rastreador de dispositivo, con sensores de su batería y de cuándo informó por última vez.

> **Beta.** La API de Mapit en la que se basa es una beta, gratis por ahora. Consulta las [condiciones de la beta](https://developers.mapit.me/es/terms.md).

## Instalación

Necesitas Home Assistant 2026.10 o posterior y una cuenta de Mapit con al menos un vehículo. Con [HACS](https://hacs.xyz/):

1. Añade `https://github.com/mapit-iot/home-assistant-mapit` como repositorio personalizado, con la categoría Integración.
2. Instala **Mapit** y reinicia Home Assistant. HACS instala la [última versión publicada](https://github.com/mapit-iot/home-assistant-mapit/releases/latest).
3. Ve a **Ajustes > Dispositivos y servicios > Añadir integración** y elige **Mapit**.
4. Inicia sesión con tu cuenta de Mapit y marca **Permitir también la ubicación del vehículo y el último estado del dispositivo**. Sin ese permiso, Home Assistant no puede mostrar tus vehículos.
5. La primera vez, `my.home-assistant.io` te pide la URL de tu Home Assistant (sugiere `http://homeassistant.local:8123`). Escribe la dirección con la que abres Home Assistant y pulsa **Link account** (vincular cuenta). La dirección se guarda solo en ese navegador.
6. Home Assistant abre un cuadro **Name and assign** (nombrar y asignar) con todos tus vehículos, donde puedes elegir un área para cada uno. También puedes pulsar **Skip and finish** (omitir y finalizar). Aparecen tus vehículos.

Sin HACS, descarga el código fuente de la [última versión publicada](https://github.com/mapit-iot/home-assistant-mapit/releases/latest), no de `main`, copia su carpeta `custom_components/mapit` en la carpeta `config/custom_components` de Home Assistant y reinícialo. En ese primer reinicio Home Assistant descarga `aiomapit` de PyPI, así que necesita acceso a internet. Después sigue desde el paso 3.

## Qué obtienes

Cada vehículo es un dispositivo con estas entidades:

| Entidad | Qué muestra |
| --- | --- |
| Rastreador de dispositivo (el nombre del vehículo) | La última posición comunicada. Un vehículo que nunca comunicó una posición muestra _desconocido_. |
| Batería Mapit | La batería del propio rastreador, no la del vehículo. |
| Última comunicación | Cuándo comunicó algo el rastreador por última vez. |
| Última ubicación | Cuándo se comunicó la posición. |
| Cuentakilómetros | El kilometraje guardado en Mapit. |
| Estado | Lo último que comunicó el rastreador, como se lista abajo. |
| Tensión del vehículo | La alimentación del vehículo vista por el rastreador. Desactivada por defecto: actívala en los ajustes de la entidad. |

Todo es lo último comunicado, no en directo. El estado muestra uno de estos valores, con las mismas etiquetas que la app de Mapit:

- `at_rest`: **En reposo**. El vehículo está aparcado.
- `buzz`: **Vibración**. El rastreador notó vibración con el vehículo aparcado.
- `moving`: **En trayecto**. El vehículo se está moviendo.
- `no_comms`: **Sin conexión**. El rastreador no está comunicando.
- `hibernation` y `hibernation_requested`: **Apagado**. Hibernando o a punto de hacerlo, para ahorrar batería.
- `tilt_detected`: **Moto caída**. El vehículo puede haberse caído.

Un vehículo que nunca comunicó, o que comunica un estado que no está en la lista, muestra _desconocido_.

## Cómo funciona

- **Sin contraseña en Home Assistant.** Inicias sesión en la página de Mapit y das permiso a Home Assistant, como harías con cualquier otra aplicación. Home Assistant guarda un token, nunca tu contraseña.
- **Tú eliges qué ve.** La ubicación es un permiso aparte en la página de autorización.
- **Desconéctala desde Mapit.** La conexión aparece en tu página de aplicaciones conectadas, donde puedes terminarla.
- **Ligera.** Lee el estado de todos tus vehículos en una sola petición, más o menos una vez por minuto.

## Integraciones que piden tu contraseña

Algunas integraciones de la comunidad inician sesión con tu email y tu contraseña de Mapit. Guardan tu contraseña y pueden dejar de funcionar en cuanto cambia la app de Mapit. Te recomendamos pasarte a la integración oficial y después cambiar tu contraseña de Mapit.
