Integración domótica Carbu.com, gratuita y de código abierto
Precios del carburante en Bélgica, Francia y Luxemburgo: gasolineras baratas y precios máximos.
Publicado por William-De71
- Dispositivos
- Versión 0.1.0
- Requiere Gladys >=5.1.1
- ★ 0
Presentación
Esta integración lleva a Gladys los precios del carburante de Carbu.com, el comparador de Bélgica, Francia y Luxemburgo: alrededor de una localidad de su elección (un código postal), el precio más bajo, el precio medio y la gasolinera más barata de hasta cuatro carburantes, las gasolineras que quiera seguir y los precios oficiales (precios máximos belgas con su cambio anunciado o previsto, precios oficiales de Luxemburgo).
Carbu.com no tiene API ni cuenta: la integración lee las páginas públicas del sitio, como un visitante, cada hora por defecto. Allí los precios los actualizan conductores y gasolineras; algunos tienen días, incluso años en Francia: los que superan la antigüedad elegida se descartan.
Es una integración en la nube: contacta con carbu.com con su código postal y los códigos de los carburantes seguidos. Nada más sale de su red.
Requisitos
- Gladys Assistant 5.1.1 o posterior.
- Acceso a internet. Sin cuenta, sin clave.
Configuración
| Campo | Descripción |
|---|---|
| País | Bélgica, Francia o Luxemburgo. |
| Código postal | El centro de la zona: las distancias se cuentan desde el centro de esta localidad. |
| Localidad (opcional) | Cuando el código postal abarca varias localidades (4000: Lieja, Glain, Rocourt). Vacío: la principal. |
| Carburantes | Cuatro como máximo. Tras el nombre figuran los países donde Carbu.com lo ofrece (E85: Francia). |
| Radio | De 2 a 30 km, 10 km por defecto. |
| Ignorar precios con más de | De 1 a 30 días, 7 días por defecto. |
| Gasolineras propuestas en el descubrimiento | Las más baratas de cada carburante, 5 por defecto; «Ninguna» para proponer solo la zona. |
| Frecuencia de lectura | 30 minutos, 1 hora (por defecto), 2 o 4 horas. |
| Idioma de los nombres de dispositivos | Automático: el idioma del panel, francés hasta que se muestre un widget. |
El botón Probar la conexión muestra la localidad elegida y las demás del mismo código postal y, para cada carburante, el número de gasolineras conservadas, el precio más bajo y el número de precios antiguos descartados. El botón Diagnóstico escribe el estado completo de la integración en la pestaña Registros.
Uso
Dispositivos
En la pestaña Descubrir de la integración:
- Carbu.com <localidad> (<código postal>): para cada carburante seguido, el precio más bajo, el precio medio (en €/L, con historial) y la gasolinera más barata («Shell Express Liège · 2,274 € · 1,3 km»).
- Las gasolineras, las más baratas de cada carburante: añada las que le interesen; conservan entonces el precio de cada carburante seguido que venden, aunque ya no estén entre las más baratas.
- Carbu.com precios máximos belgas (Bélgica): para cada carburante seguido, el precio máximo de hoy, el siguiente (anunciado por el Gobierno, si no previsto por Carbu.com) y la tendencia en palabras («Bajada anunciada el 22/04: 2,061 €»).
- Carbu.com precios oficiales de Luxemburgo (Luxemburgo): el precio oficial de hoy de cada carburante seguido.
Widgets del panel
- Carburante más barato: el precio más bajo y el medio, luego las gasolineras más baratas (en verde: las del precio más bajo), su distancia y la fecha de los precios antiguos. Un toque abre la gasolinera en Carbu.com o en el mapa. Ajustes: carburante (incluso uno no seguido), número de gasolineras.
- Evolución del precio: las curvas del precio más bajo y del medio de un carburante, de una semana a un año, dibujadas por Gladys a partir del dispositivo de zona (añádalo primero).
- Precios oficiales: los precios máximos belgas de hoy y lo que viene (en verde una bajada, en rojo una subida, «~» una previsión de Carbu.com), o los precios oficiales de Luxemburgo.
Escenas
Disparadores (una vez por cambio; la primera lectura sirve de referencia):
| Disparador | Cuándo | Filtros |
|---|---|---|
| Nueva gasolinera más barata | Otra gasolinera pasa a ser la más barata de la zona para un carburante | carburante |
| Cambio de precio en una gasolinera | El precio de un carburante cambia en una gasolinera añadida | gasolinera, carburante, sentido |
| Precio oficial modificado | El precio oficial de hoy difiere del de ayer (Bélgica, Luxemburgo) | carburante, sentido |
| Precio máximo anunciado | El Gobierno belga anuncia un nuevo precio máximo para el día siguiente | carburante, sentido |
| Cambio de precio máximo previsto | Carbu.com prevé una subida o una bajada antes del anuncio oficial | carburante, sentido |
Acciones: Gasolinera más barata (carburante, distancia máxima; devuelve nombre, marca, dirección, precio, distancia, fecha del precio, precio medio, número de gasolineras, enlace al mapa) y Precios oficiales (carburante; devuelve el precio de hoy, el siguiente, su fecha, la tendencia y si está anunciado).
Ejemplos:
- Cuando se anuncia una subida del precio máximo del diésel → enviarme «Llene el depósito hoy, mañana {{triggerEvent.data.new_price}} €».
- Cuando cambia la gasolinera de gasolina 95 más barata → notificar
{{triggerEvent.data.station_name}}a{{triggerEvent.data.price}}€. - Cada viernes a las 17:00 → Gasolinera más barata a 5 km y anunciarla por el altavoz.
Transporte
Insignia nube en el catálogo: se contacta con Carbu.com por internet. No hay vía local ni botón «Preferir la conexión local».
Solución de problemas
- «Carbu.com no conoce ninguna localidad con el código postal …»: compruebe el país y el código (en Luxemburgo, sin «L-»; Carbu.com no siempre conoce cada código de una ciudad: pruebe con el principal). «Probar la conexión» enumera las localidades encontradas.
- «Ningún precio reciente en … km a la redonda»: amplíe el radio o la antigüedad aceptada de los precios, o compruebe que el carburante se vende cerca (el GNC y el diésel XTL son raros).
- Un carburante no está disponible en su país: el estado de la integración lo indica; elija un equivalente (Bélgica: gasolina 95 E10; Francia y Luxemburgo: gasolina 95 E5).
- «Carbu.com rechazó la solicitud»: el sitio limita las lecturas demasiado frecuentes; lea cada 2 o 4 horas.
- «No se pudo leer la página de Carbu.com»: probablemente el sitio cambió su diseño; infórmelo en GitHub con el botón Diagnóstico.
- Los precios difieren un poco de los del surtidor: son los introducidos en Carbu.com, con la fecha que muestra el widget.
- Para un informe de error: versiones de Gladys y de la integración, país, código postal, carburantes y las líneas «Carbu.com diagnostic» de la pestaña Registros (en modo desarrollador,
DEBUG=gladys-integration-sdkañade los registros del SDK).
Parámetros de configuración
Estos son los parámetros que Carbu.com te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Carbu.com | section | No | Los precios proceden de Carbu.com, el comparador de precios del carburante de Bélgica, Francia y Luxemburgo, que actualizan conductores y gasolineras. No hace falta cuenta: la integración lee las páginas públicas de Carbu.com para su código postal, una vez por hora por defecto. Solo su código postal sale de su red. |
| País | select | Sí | |
| Código postal | string | Sí | El centro de la zona: las distancias se cuentan desde el centro de esta localidad. |
| Localidad (opcional) | string | No | Cuando el código postal abarca varias localidades (4000: Lieja, Glain, Rocourt). Vacío: la principal. «Probar la conexión» las enumera. |
| Carburantes | multi_select | Sí | Hasta cuatro carburantes. Tras el nombre figuran los países donde Carbu.com lo ofrece. |
| Gasolineras consideradas | section | No | Carbu.com muestra hasta 100 gasolineras alrededor de la localidad, algunas con precios de hace meses. Estos ajustes conservan las que importan. |
| Radio | select | No | |
| Ignorar precios con más de | select | No | |
| Gasolineras propuestas en el descubrimiento | select | No | Las gasolineras más baratas de cada carburante, para añadirlas como dispositivos y seguir sus precios. |
| Frecuencia de lectura | select | No | |
| Idioma de los nombres de dispositivos | select | No | Automático: el idioma del panel, francés hasta que se muestre un widget. |
Cómo instalar Carbu.com en Gladys
- En Gladys, abre Integraciones: Carbu.com 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-carbu-com: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-carbu-com.
Carbu.com requiere Gladys >=5.1.1. 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
Carbu.com 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