Integración
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.
Instalación
Necesitas Home Assistant 2026.10 o posterior y una cuenta de Mapit con al menos un vehículo. Con HACS:
- Añade
https://github.com/mapit-iot/home-assistant-mapitcomo repositorio personalizado, con la categoría Integración. - Instala Mapit y reinicia Home Assistant. HACS instala la última versión publicada.
- Ve a Ajustes > Dispositivos y servicios > Añadir integración y elige Mapit.
- 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.
- La primera vez,
my.home-assistant.iote pide la URL de tu Home Assistant (sugierehttp://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. - 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, 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.hibernationyhibernation_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.
