Saltar al contenido principal

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

Integración Open Charge Map para Gladys Assistant

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.

Widgets Recarga cercana y Punto de recarga, alrededor de la ciudad de Luxemburgo (ilustración generada, no una captura de pantalla)

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​

  1. Integraciones → Open Charge Map → Configuración.
  2. Pegue la clave de API, elija una casa o escriba una posición para cada lugar, ajuste la búsqueda y guarde.
CampoDescripción
Clave de APISu clave de Open Charge Map. Enviada solo a Open Charge Map.
CasaUna 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.
Radio1, 2, 5 (por defecto), 10, 20 o 50 km alrededor de cada lugar.
Potencia mínimaCualquiera (por defecto), 7, 11, 22, 50 o 150 kW, de al menos un conector.
ConectoresTipo 2, CCS, CHAdeMO, Tipo 1, Tesla / NACS, enchufe doméstico. Ninguno marcado: todos los conectores.
Solo puntos públicosActivado por defecto: excluye los puntos privados y los reservados a clientes.
Puntos propuestosLos 5, 10 (por defecto), 20 o 50 más cercanos de cada lugar, en la pestaña Descubrir.
Open Charge Map leído cada1, 3, 6 (por defecto), 12 o 24 horas. Una petición por lugar, una más para los puntos seguidos.
Idioma de los textosNombres 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.

DispositivoFunciónTipo de Gladys
LugarPuntos en servicioContador: puntos en servicio dentro del radio que coinciden con la búsqueda
Puntos rápidosContador: de ellos, los que tienen un conector de 50 kW o más
Punto más cercanoDistancia (km)
ResumenTexto: «12 puntos en servicio a menos de 5 km, 3 rápidos (50 kW+). El más cercano: Lidl, 0,8 km.»
PuntoEstadoEstación de carga, estado del conector: Disponible (en servicio), Ocupado, No disponible, En avería
Puntos de cargaContador
DetallesTexto: estado, potencia máxima, conectores, acceso y tarifa
Última visitaTexto: «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-sdk y 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ámetroTipoObligatorioDescripción
Open Charge MapsectionNoOpen 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 APIsecretSíEnviada solo a Open Charge Map, en la cabecera X-API-Key.
LugaressectionNoElija 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…
CasaselectNoSu posición en Gladys es el centro de la búsqueda.
O una posiciónstringNoLatitud, longitud, como las copia una app de mapas. Prevalece sobre la casa.
Lugar 2sectionNo
CasaselectNoSu posición en Gladys es el centro de la búsqueda.
O una posiciónstringNoLatitud, longitud, como las copia una app de mapas. Prevalece sobre la casa.
Lugar 3sectionNo
CasaselectNoSu posición en Gladys es el centro de la búsqueda.
O una posiciónstringNoLatitud, longitud, como las copia una app de mapas. Prevalece sobre la casa.
BúsquedasectionNoLa misma para todos los lugares. Los widgets pueden afinarla más.
RadioselectNo
Potencia mínimaselectNoDe al menos un conector.
Conectoresmulti_selectNoNinguno marcado: todos los conectores.
Solo puntos públicosbooleanNoExcluye los privados y los reservados a clientes.
Puntos propuestosselectNoLos más cercanos de cada lugar, en la pestaña Descubrir: añada los que use.
OpcionessectionNo
Open Charge Map leído cadaselectNoUna 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 textosselectNoNombres de dispositivos y resúmenes de escenas. Automático sigue el idioma del panel.

Cómo instalar Open Charge Map en Gladys​

  1. En Gladys, abre Integraciones: Open Charge Map aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. 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).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. 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.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂