Integración domótica Open Charge Map, gratuita y de código abierto

Puntos de recarga públicos cerca de casa: estado, visitas, escenas.
Presentación
Esta integración trae a Gladys los puntos de recarga públicos para vehículos eléctricos registrados en Open Charge Map, alrededor de hasta tres lugares: una casa de Gladys o una posición que usted escribe.
- un dispositivo por lugar: los puntos en servicio a su alrededor, cuántos son rápidos (50 kW o más) y a qué distancia está el más cercano;
- un dispositivo por punto seguido: su estado, sus puntos de carga, potencia, conectores, acceso y tarifa, y la última visita de un conductor;
- disparadores de escena (nuevo punto cercano, estado de un punto cambiado, nueva visita) y una acción de escena (buscar el punto más cercano para un conector y una potencia);
- dos widgets del panel: los puntos más cercanos, y un punto.
Open Charge Map es el registro abierto y mundial de puntos de recarga, alimentado por su comunidad y por registros nacionales. La integración lee su API oficial con su clave personal gratuita (transporte en la nube). La ocupación en directo de un punto solo se conoce si su operador la comparte: la mayoría de los puntos indican «en servicio», no «libre». Integración comunitaria, no afiliada a Open Charge Map.

Requisitos
- Gladys Assistant 5.3.0 o posterior.
- Una clave de API de Open Charge Map gratuita: inicie sesión en openchargemap.org, abra My profile → My apps y luego Register an application; la clave aparece con la aplicación.
- Una casa de Gladys situada en el mapa (Ajustes → Casas), o una posición (latitud, longitud).
Configuración
- Integraciones → Open Charge Map → Configuración.
- Pegue la clave de API, elija una casa o escriba una posición para cada lugar, ajuste la búsqueda y guarde.
| Campo | Descripción |
|---|---|
| Clave de API | Su clave de Open Charge Map. Enviada solo a Open Charge Map. |
| Casa | Una casa de Gladys: su posición es el centro de la búsqueda. |
| O una posición | «46.3069, 4.8325», como la copia una app de mapas. Prevalece sobre la casa. |
| Radio | 1, 2, 5 (por defecto), 10, 20 o 50 km alrededor de cada lugar. |
| Potencia mínima | Cualquiera (por defecto), 7, 11, 22, 50 o 150 kW, de al menos un conector. |
| Conectores | Tipo 2, CCS, CHAdeMO, Tipo 1, Tesla / NACS, enchufe doméstico. Ninguno marcado: todos los conectores. |
| Solo puntos públicos | Activado por defecto: excluye los puntos privados y los reservados a clientes. |
| Puntos propuestos | Los 5, 10 (por defecto), 20 o 50 más cercanos de cada lugar, en la pestaña Descubrir. |
| Open Charge Map leído cada | 1, 3, 6 (por defecto), 12 o 24 horas. Una petición por lugar, una más para los puntos seguidos. |
| Idioma de los textos | Nombres de dispositivos, resúmenes y textos de escenas. Automático: el idioma de su panel. |
Probar la clave y los lugares lee Open Charge Map al momento y muestra, para cada lugar, su posición y los puntos encontrados.
Uso
Dispositivos
Dispositivos → Open Charge Map → Descubrir, y añada su lugar («Puntos de recarga · Casa») y los puntos que utiliza.
| Dispositivo | Función | Tipo de Gladys |
|---|---|---|
| Lugar | Puntos en servicio | Contador: puntos en servicio dentro del radio que coinciden con la búsqueda |
| Puntos rápidos | Contador: de ellos, los que tienen un conector de 50 kW o más | |
| Punto más cercano | Distancia (km) | |
| Resumen | Texto: «12 puntos en servicio a menos de 5 km, 3 rápidos (50 kW+). El más cercano: Lidl, 0,8 km.» | |
| Punto | Estado | Estación de carga, estado del conector: Disponible (en servicio), Ocupado, No disponible, En avería |
| Puntos de carga | Contador | |
| Detalles | Texto: estado, potencia máxima, conectores, acceso y tarifa | |
| Última visita | Texto: «Recarga correcta, 15/11/2026 (Lena)» y el comentario del conductor |
«Disponible» es lo que Gladys muestra para un punto en servicio: Open Charge Map sabe si un punto funciona, rara vez si está libre en este momento. Las visitas de un punto se leen en cuanto añade su dispositivo.
Escenas
Disparadores:
- Open Charge Map: nuevo punto cercano: un punto recién listado en Open Charge Map aparece en el radio de un lugar. Filtros: el lugar, rápido (50 kW+) o no.
- Open Charge Map: estado de un punto cambiado: un punto añadido queda fuera de servicio, vuelve a funcionar, o cambia de estado. Filtros: el punto, el cambio.
- Open Charge Map: nueva visita: un conductor indica una recarga, un problema o un comentario en un punto añadido. Filtros: el punto, el resultado (éxito, problema, otro).
Acción:
- Open Charge Map: buscar un punto: el punto más cercano de un lugar para un conector y una potencia mínima, según la última lectura: nombre, dirección, distancia, potencia, conectores, operador, estado, posición, página de Open Charge Map y una frase lista.
Ejemplos:
- Cuando el punto rápido que uso queda fuera de servicio → enviar un mensaje con
{{triggerEvent.data.summary}}. - Cuando un conductor indica un problema en mi punto habitual → avisarme antes de salir.
- Cuando se lista un nuevo punto rápido cerca de casa → enviar su nombre y su distancia.
- Cuando la batería del coche está baja (con la integración de su coche) → buscar el punto CCS de 50 kW más cercano y enviar su resumen en un mensaje.
Widgets
Panel → Editar → añada Recarga cercana: elija el lugar, un conector, una potencia mínima y cuántos puntos mostrar. Cada tarjeta da la distancia, el operador, la potencia y el estado; se abre con los conectores, la dirección, el acceso y la tarifa, la última visita, la fuente de los datos, y enlaces a Open Charge Map y a la ruta.
Añada Punto de recarga para un punto seguido: potencia máxima, puntos de carga y distancia, últimas visitas de conductores, estado, conectores, acceso y tarifa, fecha de la última verificación y fuente de los datos.
Cada widget muestra el proveedor de los datos de los puntos y su licencia (Open Charge Map Contributors, CC BY 4.0, o el registro nacional del que proceden los datos), como piden las condiciones de Open Charge Map.
Solución de problemas
- «Open Charge Map rechaza la clave de API»: vuelva a copiar la clave desde My profile → My apps; una clave es propia de su cuenta.
- «No es una posición»: escriba la latitud, una coma y luego la longitud, con punto para los decimales:
46.3069, 4.8325. - «La casa no tiene posición»: sitúe la casa en el mapa en Ajustes → Casas.
- Ningún punto, o muy pocos: amplíe el radio, desmarque conectores o baje la potencia mínima; compruebe la zona en el mapa de Open Charge Map.
- «Open Charge Map pide reducir el ritmo»: lea con menos frecuencia; la política de uso justo de Open Charge Map pide no repetir peticiones.
- Un punto es erróneo o falta: Open Charge Map lo alimentan sus usuarios: corríjalo, o añada una visita, en su página (enlace en el widget).
- Registros: añada la variable de entorno
DEBUG=gladys-integration-sdky abra una issue en GitHub con las versiones de Gladys y de la integración y los registros (nunca su clave de API).
Parámetros de configuración
Estos son los parámetros que Open Charge Map te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Open Charge Map | section | No | Open Charge Map es el registro abierto de puntos de recarga públicos, alimentado por su comunidad y por registros nacionales. Su API es gratuita con una clave personal: inicie sesión en openchargemap.org, abra My profile > My apps y luego Register an application, y pegue la clave abajo. La ocupación en directo solo se conoce si el operador la comparte: la mayoría de los puntos indican «en servicio», no «libre». Integración comunitaria, no afiliada a Open Charge Map. |
| Clave de API | secret | Sí | Enviada solo a Open Charge Map, en la cabecera X-API-Key. |
| Lugares | section | No | Elija una casa de Gladys (situada en Ajustes > Casas), o escriba una posición. Cada lugar se convierte en un dispositivo en la pestaña Descubrir, con sus puntos más cercanos. Hasta tres lugares: casa, trabajo… |
| Casa | select | No | Su posición en Gladys es el centro de la búsqueda. |
| O una posición | string | No | Latitud, longitud, como las copia una app de mapas. Prevalece sobre la casa. |
| Lugar 2 | section | No | |
| Casa | select | No | Su posición en Gladys es el centro de la búsqueda. |
| O una posición | string | No | Latitud, longitud, como las copia una app de mapas. Prevalece sobre la casa. |
| Lugar 3 | section | No | |
| Casa | select | No | Su posición en Gladys es el centro de la búsqueda. |
| O una posición | string | No | Latitud, longitud, como las copia una app de mapas. Prevalece sobre la casa. |
| Búsqueda | section | No | La misma para todos los lugares. Los widgets pueden afinarla más. |
| Radio | select | No | |
| Potencia mínima | select | No | De al menos un conector. |
| Conectores | multi_select | No | Ninguno marcado: todos los conectores. |
| Solo puntos públicos | boolean | No | Excluye los privados y los reservados a clientes. |
| Puntos propuestos | select | No | Los más cercanos de cada lugar, en la pestaña Descubrir: añada los que use. |
| Opciones | section | No | |
| Open Charge Map leído cada | select | No | Una petición por lugar, una más para los puntos seguidos. Los puntos cambian poco: la política de uso justo pide no repetir peticiones. |
| Idioma de los textos | select | No | Nombres de dispositivos y resúmenes de escenas. Automático sigue el idioma del panel. |
Cómo instalar Open Charge Map en Gladys
- En Gladys, abre Integraciones: Open Charge Map aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/william-de71/gladys-open-charge-map:0.1.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/William-De71/gladys-open-charge-map.
Open Charge Map requiere Gladys >=5.3.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Open Charge Map es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene William-De71, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación