Saltar al contenido principal

Integración domótica Géorisques, gratuita y de código abierto

Integración Géorisques para Gladys Assistant

Riesgos naturales e industriales de su municipio en Francia, según los datos abiertos Géorisques.

Lleva a Gladys los riesgos naturales y tecnológicos de su municipio en Francia, tal como los publica Géorisques (el servicio «Conocer los riesgos cerca de mí» del Ministerio francés de Transición Ecológica): retracción-hinchamiento de arcillas, radón, sismo, inundación, instalaciones industriales clasificadas, cavidades subterráneas, movimientos de terreno y decretos de catástrofe natural. Sin cuenta ni clave.

Es una información, no un sistema de alerta de seguridad. Los datos vienen de Géorisques, con sus plazos de actualización y sus posibles errores. La integración no sustituye al informe oficial de riesgos (obligatorio en Francia al vender o alquilar una vivienda) ni a las instrucciones de su ayuntamiento o de la prefectura. Integración sin afiliación con el Ministerio francés de Transición Ecológica ni con el Estado francés.

Desarrollada sin conexión real con Géorisques: sus comentarios son bienvenidos. El servicio no era accesible desde el entorno de desarrollo; la integración se probó con respuestas reconstruidas a partir de la documentación oficial de la API.

Lo que obtiene​

  • Un dispositivo «Riesgos de mi municipio» que muestra de un vistazo: la exposición de su vivienda a la retracción-hinchamiento de arcillas, el potencial de radón del municipio, su zona sísmica, si tiene un plan de prevención de inundaciones (PPRI) o pertenece a un territorio de alto riesgo de inundación (TRI), el número de instalaciones industriales clasificadas y de sitios Seveso (en el municipio y a menos de 5 km de su vivienda), de cavidades subterráneas y movimientos de terreno registrados, y los decretos de catástrofe natural («arrêtés CatNat») reconocidos desde 1982, con el último (su tipo y su fecha).
  • Un disparador de escena «Nuevo decreto de catástrofe natural»: el suceso que importa para su seguro de hogar.
  • Un widget del panel que lo resume todo en colores, con un enlace al informe Géorisques de su dirección.
  • Un botón «Leer ahora» en la configuración, para comprobar que se encuentra el municipio correcto.

Estos datos cambian poco: la integración lee Géorisques una vez al día, al arrancar y cuando guarda la configuración. Sin avalancha de peticiones.

Requisitos​

  • Gladys Assistant 5.2.0 o posterior.
  • Acceso a Internet desde Gladys: la integración lee www.georisques.gouv.fr y, para encontrar el municipio de una casa o de una dirección, el servicio de direcciones del IGN (data.geopf.fr).
  • Una vivienda en Francia: metrópoli, o ultramar para los datos que Géorisques publica allí.
  • Para la opción por defecto, la ubicación de su casa en Gladys (Ajustes, Casas). La integración la pide al instalarse (permiso «ubicación»). Solo sirve para encontrar el municipio y la exposición a las arcillas; no se guarda ni se escribe en los registros.

Configuración​

Ajustes​

AjusteQué hace
UbicaciónMi casa en Gladys (por defecto), Una dirección o Un municipio (código INSEE).
CasaLa casa cuya ubicación cuenta, si tiene varias. Vacío: la primera casa de Gladys que tiene ubicación.
DirecciónNúmero, calle y municipio, como en un sobre: 12 rue de la Mairie, 31000 Toulouse. El nombre de un municipio solo también funciona, pero sin posición precisa (ver abajo).
Código INSEE del municipio5 caracteres, no es el código postal: 31555 para Toulouse, 2A004 para Ajaccio. Figura en el aviso del impuesto sobre bienes inmuebles o en el sitio del Insee.
Idioma de los nombres de las funcionesNombres de las funciones del nuevo dispositivo, idioma de sus textos (inundación, última catástrofe) y de las variables del disparador. Francés por defecto.

Guarde, abra la pestaña Descubrir y cree el dispositivo.

Con una posición (casa o dirección precisa), obtiene todo. Con un código INSEE, o una dirección reducida al nombre de un municipio, el dispositivo no tiene ni la exposición a las arcillas ni los sitios Seveso a menos de 5 km: ambos dependen del lugar exacto de la vivienda, no del municipio.

En París, Lyon y Marsella, el dispositivo es el del municipio (75056, 69123, 13055), donde Géorisques archiva los decretos y los planes; el radón se lee para su distrito cuando la posición o la dirección lo indican.

Comprobar: «Leer ahora»​

El botón Leer ahora vuelve a leer Géorisques y responde, por ejemplo: «Chevilly-Larue (94021): leído ahora. 6 decreto(s) de catástrofe natural desde 1982.» Si el municipio no es el correcto, corrija la ubicación o la dirección. Si falta algo (casa sin ubicación, dirección no encontrada, código INSEE no válido), el mensaje y la pantalla de configuración lo indican.

Dispositivo​

Un dispositivo por municipio, llamado «Riesgos de mi municipio (Toulouse)». Sus funciones son de solo lectura:

FunciónTipo (Gladys)Valor
Retracción-hinchamiento de arcillasNivel de riesgoExposición en el lugar de la vivienda: 0 nula (verde, «Sin riesgo»), 1 baja (amarillo), 2 media (naranja), 3 alta (rojo). Las arcillas que se hinchan en invierno y se contraen en verano agrietan las casas.
Potencial de radónNivel de riesgoCategoría del municipio: 1 bajo (amarillo), 2 bajo pero con factores que facilitan el paso del radón (naranja), 3 significativo (rojo). En categoría 3, hay que informar a compradores e inquilinos.
Zona sísmicaValor sísmicoZona reglamentaria de 1 (muy baja) a 5 (fuerte, Antillas francesas). El número oficial, sin transformar.
Inundación (PPRI, TRI)Texto«Plan de prevención de inundaciones» (prescrito, aprobado o aplicado por anticipado), «Territorio de alto riesgo (TRI)», ambos, o «Ni PPRI ni TRI».
Instalaciones clasificadasContadorInstalaciones clasificadas para la protección del medio ambiente (ICPE) del municipio: fábricas, canteras, granjas, aerogeneradores…
Sitios Seveso del municipioContadorEntre ellas, los sitios Seveso (umbral alto y umbral bajo): los que manipulan grandes cantidades de sustancias peligrosas.
Sitios Seveso a menos de 5 kmContadorLos sitios Seveso en un radio de 5 km alrededor de la vivienda, municipios vecinos incluidos. Solo con una posición.
Cavidades subterráneasContadorBodegas, canteras, pozos, galerías… registrados en el municipio.
Movimientos de terrenoContadorDeslizamientos, desprendimientos, hundimientos… registrados en el municipio.
Decretos de catástrofe naturalContadorNúmero de decretos «CatNat» reconocidos para el municipio desde 1982.
Última catástrofe naturalTextoEl último decreto publicado: su tipo y el primer día del suceso («Inundación, 15/01/2024»), o «Ningún decreto desde 1982». En francés, el texto del Journal officiel.

Un valor solo se envía cuando cambia, y una vez cada 12 horas en caso contrario, para que Gladys nunca muestre «Sin valor reciente».

Los contadores son los de las bases nacionales (BRGM, inspección de las instalaciones clasificadas…): un número alto de cavidades indica tanto que el municipio está bien inventariado como que está expuesto. Léalos como referencias, no como una nota.

Cambiar de municipio (mudanza, nueva dirección) crea un dispositivo nuevo: elimine el antiguo en Gladys. Pasar de un código INSEE a una casa o una dirección añade las funciones de las arcillas y de los sitios Seveso cercanos: la pestaña Descubrir propone entonces actualizar el dispositivo.

Widget​

Añada el widget Géorisques a un panel. Muestra el nombre del municipio y luego una línea por riesgo, en colores:

  • arcillas, radón y sismo: verde cuando es bajo, amarillo cuando es medio, rojo cuando es alto (la paleta de los widgets no tiene naranja);
  • inundación: verde sin PPRI ni TRI, amarillo en caso contrario;
  • instalaciones clasificadas y sitios Seveso cercanos: amarillo cuando hay sitios Seveso;
  • cavidades, movimientos de terreno, decretos y el último decreto: gris, a título informativo.

Termina con la fuente y la fecha de la lectura, y un botón Informe Géorisques que abre el informe «Conocer los riesgos cerca de mí» de su dirección (o de su municipio) en georisques.gouv.fr, con el detalle y los mapas.

Disparador de escena​

Nuevo decreto de catástrofe natural: el Estado ha reconocido el estado de catástrofe natural para su municipio, y Géorisques lo ha publicado. Como Géorisques se lee una vez al día, la escena se inicia en las 24 horas siguientes a su publicación en Géorisques.

Filtro (opcional): el tipo de catástrofe — inundación, sequía (arcillas), movimiento de terreno, terremoto, tormenta, alud, otro. La sequía agrupa los «movimientos de terreno diferenciales consecutivos a la sequía y a la rehidratación de los suelos»: las grietas debidas a las arcillas.

Variables para las acciones: kind (el tipo en inglés: flood, drought…), kind_name (el tipo en el idioma de los ajustes), label (el texto del Journal officiel, en francés), event_start y event_end (fechas del suceso), published (fecha de publicación), commune, insee, count (el número de decretos desde 1982).

El disparador no se activa en la primera lectura de un municipio (aprende los decretos existentes), ni para un decreto publicado hace más de 180 días que apareciera tarde, y como máximo cinco veces por lectura.

Ejemplos de escenas​

  • Avisar a tiempo a su aseguradora: disparador «Nuevo decreto de catástrofe natural» → enviar el mensaje «Catástrofe natural reconocida en {{triggerEvent.data.commune}}: {{triggerEvent.data.label}} (del {{triggerEvent.data.event_start}} al {{triggerEvent.data.event_end}}). Si tiene daños, declárelos a su aseguradora en los 30 días siguientes a la publicación del decreto.»
  • Una casa sobre arcillas tras una sequía: disparador «Nuevo decreto de catástrofe natural», tipo sequía → mensaje «Decreto de sequía publicado: dé la vuelta a la casa y fotografíe las grietas.»
  • Radón: ventilar cada día: disparador «Todos los días a las 10:00», condición «Potencial de radón» igual a 3 → mensaje «Recuerde ventilar 10 minutos.» El radón se acumula en las habitaciones cerradas, sobre todo en el sótano.

Fuentes de los datos, licencia y cuotas​

  • Géorisques (www.georisques.gouv.fr/api/v1), el portal de riesgos del Ministerio francés de Transición Ecológica, gestionado con el BRGM. La API v1 es abierta, sin cuenta ni token (la v2 lo requiere). Datos públicos reutilizables citando la fuente, según las condiciones de uso de georisques.gouv.fr: el widget cita Géorisques y la fecha de lectura.
  • Servicio de direcciones del IGN (Géoplateforme, data.geopf.fr/geocodage), sucesor de la API Adresse (Base Adresse Nationale): da el municipio de una posición o de una dirección. Una petición al día.
  • No hay ninguna cuota publicada para la API v1 de Géorisques. La integración es ligera: una lectura al día, unas 14 peticiones separadas 0,3 segundos, y un nuevo intento por hora solo para la parte que haya fallado. Se identifica en sus peticiones. No pulse «Leer ahora» una y otra vez.

Solución de problemas​

  • «Indique la ubicación de su casa en Gladys»: defina la ubicación de su casa en Gladys (Ajustes, Casas) o elija «Una dirección» o «Un municipio».
  • «Dirección no encontrada»: compruebe la dirección (número, calle, municipio) o use el código INSEE.
  • «… no es un código INSEE»: el código INSEE tiene 5 caracteres y no es el código postal (Toulouse: código postal 31000, código INSEE 31555).
  • «Géorisques no responde»: el servicio no funciona o Gladys no tiene acceso a Internet. La integración lo vuelve a intentar cada hora; los últimos valores siguen mostrándose.
  • «Géorisques no ha respondido para: radón…»: solo ha fallado una parte; se vuelve a pedir sola dentro de una hora.
  • Sin potencial de radón: Géorisques no lo publica para este municipio; en París, Lyon y Marsella se publica por distrito: elija una casa o una dirección en lugar del código INSEE del municipio.
  • Sin la función «Retracción-hinchamiento de arcillas»: el dispositivo se creó con un código INSEE. Pase a una casa o una dirección y actualice el dispositivo en la pestaña Descubrir.
  • Registros: tranquilos por defecto (arranque, cambio de municipio, nuevo decreto, «Leer ahora», fallos una sola vez). LOG_LEVEL=debug muestra cada lectura. Nunca se escriben en ellos ni la posición ni la dirección.

Límites​

  • No es un sistema de alerta de seguridad ni un informe oficial de riesgos: para una venta o un alquiler, el informe de riesgos se hace en georisques.gouv.fr.
  • Salvo las arcillas y los sitios Seveso cercanos, la información es la del municipio, no la de su parcela: un PPRI en el municipio no significa que su calle esté en zona inundable. El informe Géorisques de su dirección (botón del widget) da el detalle.
  • La exposición a las arcillas procede de un mapa nacional a escala 1:50 000: indica una tendencia del suelo, no el estado de su terreno.
  • Los datos siguen las actualizaciones de Géorisques: un nuevo decreto llega allí entre unos días y unas semanas después de su publicación en el Journal officiel.
  • Las zonas sísmicas y las categorías de radón son reglamentarias; cambian poco.
  • Desarrollada sin conexión real con Géorisques: los formatos se tomaron de la documentación oficial de la API; algunos detalles (formato de las fechas, tamaño de las páginas) los confirmarán los primeros usuarios.
  • Sin afiliación con el Ministerio francés de Transición Ecológica, el BRGM ni el IGN.

Parámetros de configuración​

Estos son los parámetros que Géorisques te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Su viviendasectionNoElija dónde se leen los riesgos: su casa en Gladys (por defecto), una dirección o un municipio por su código INSEE. Guarde y cree el dispositivo en la pestaña Descubrir. Géorisques se lee una vez al día.
Fuentes y límitessectionNoDatos © Géorisques (Ministerio francés de Transición Ecológica), leídos sin cuenta. A título informativo: no es un sistema de alerta de seguridad ni sustituye al informe oficial de riesgos. Sin afiliación con el Ministerio.
UbicaciónselectNoCasa: la ubicación de su casa en Gladys. Dirección: la dirección de abajo. Municipio: el código INSEE de abajo (sin arcillas ni sitios Seveso cercanos, que requieren una ubicación).
CasaselectNoVacío: la primera casa de Gladys que tiene ubicación.
DirecciónstringNoNúmero, calle y municipio, como en una carta. Se usa cuando Ubicación es «Una dirección».
Código INSEE del municipiostringNo5 caracteres, no el código postal: 31555 para Toulouse, 2A004 para Ajaccio. Se usa cuando Ubicación es «Un municipio».
Idioma de los nombres de las funcionesselectNoNombres de las funciones de un nuevo dispositivo (Potencial de radón…) e idioma de sus textos (inundación, última catástrofe, variables del disparador).

Cómo instalar Géorisques en Gladys​

  1. En Gladys, abre Integraciones: Géorisques 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/guim31/gladys-georisques:1.0.2), 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/guim31/gladys-georisques.

Géorisques requiere Gladys >=5.2.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​

Géorisques 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 guim31, 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 🙂