Saltar al contenido principal

Integración domótica Marégraphes (SHOM), gratuita y de código abierto

Integración Marégraphes (SHOM) para Gladys Assistant

Nivel del mar medido y sobreelevación prevista en los mareógrafos del SHOM, Francia y ultramar.

Ver en GitHubTodas las integraciones

Lleva a Gladys el nivel del mar medido por los mareógrafos del SHOM (Service hydrographique et océanographique de la Marine, red REFMAR: unos 170 mareógrafos en las costas de Francia metropolitana, Córcega y los territorios de ultramar), con la sobreelevación prevista por el SHOM en el mismo punto. Sin cuenta ni clave.

Valores brutos, no es un servicio de alerta. Los niveles se difunden en tiempo real sin validación del SHOM; la sobreelevación es una previsión. Los datos pueden llegar tarde, faltar o ser erróneos, y la integración depende de su Gladys, de su acceso a Internet y de un servicio público. En caso de temporal, siga los avisos oficiales (Météo-France, la prefectura, el 112). Integración sin afiliación con el SHOM.

Para las predicciones de marea (pleamares, bajamares, coeficientes), vea la integración «Marées France»: esta muestra lo que el mar hace realmente en un mareógrafo.

Lo que obtiene​

  • Un dispositivo por mareógrafo seguido: el nivel del mar medido (en m), la tendencia de la marea (sube, baja, estoa), la sobreelevación prevista ahora y la sobreelevación máxima prevista para las próximas 24 horas (en cm), y la hora de la última medición.
  • Un mareógrafo que deja de enviar durante más de una hora se muestra como tal («Sin nueva medición desde…»): un valor antiguo nunca se reenvía como si fuera reciente, y ningún valor se inventa.
  • Cuatro disparadores de escena: la sobreelevación prevista supera un umbral (20, 30, 50, 80 o 100 cm), vuelve a bajar de él, la sobreelevación máxima prevista en 24 horas alcanza un umbral (un aviso anticipado), y el nivel medido supera una altura elegida por usted.
  • Una acción de escena, «Resumen de un mareógrafo»: una frase para enviar en un mensaje («Brest: nivel del mar 5,8 m, sube, medido a las 17:08. Sobreelevación prevista ahora: −2 cm.»).
  • Un widget de panel: sus mareógrafos con su nivel, su tendencia y su sobreelevación, o un mareógrafo con sus valores en directo, la curva de las últimas 24 horas y la sobreelevación máxima por venir.
  • Un botón «Buscar mareógrafos» que enumera los mareógrafos alrededor de su casa, por nombre o por número, con su nivel actual.

Requisitos​

  • Gladys Assistant 5.3.0 o posterior.
  • Acceso a Internet desde Gladys: la integración lee services.data.shom.fr.
  • Para «Alrededor de mi casa»: la ubicación de su casa en Gladys (Ajustes, Casas). La integración la pide en la instalación (el permiso «ubicación»). Solo se usa dentro del contenedor para encontrar el mareógrafo más cercano: nunca se envía al SHOM (que solo ve qué mareógrafos se consultan), nunca se guarda ni se registra.

Configuración​

Ajustes​

AjusteQué hace
MareógrafosNúmeros SHOM o nombres, separados por comas: 3, Le Havre, Pointe-à-Pitre. Una página de data.shom.fr también sirve.
Alrededor de mi casaSigue también el mareógrafo más cercano que envía mediciones, a 25, 50 o 100 km de su casa.
Intervalo de actualización5, 10 (por defecto) o 15 minutos. Una solicitud por mareógrafo.
Idioma de los nombres de las funcionesNombres de las funciones de los nuevos dispositivos, e idioma de sus textos, de las variables de escena y del resumen.

Guarde, abra la pestaña Descubrir de la integración y cree los dispositivos que desee. Un mareógrafo sigue siendo seguido mientras exista su dispositivo, aunque lo quite de la configuración.

Encontrar sus mareógrafos​

Haga clic en «Buscar mareógrafos» en la configuración. Deje el campo vacío para enumerar los mareógrafos alrededor de su casa (50 km, o la distancia elegida), o escriba:

  • un nombre: Brest, saint malo, Pointe à Pitre (se ignoran mayúsculas, acentos, guiones y guiones bajos);
  • parte de un nombre: havre;
  • un número SHOM: 3.

Cada línea indica el número, el nombre, la distancia a su casa y el nivel actual, o «sin medición reciente». Copie los números en «Mareógrafos» y guarde.

Dispositivos​

FunciónTipo en GladysValor
Nivel del mar medidoProfundidad (m)La última medición del mareógrafo, al centímetro, tal como la difunde el SHOM.
Tendencia de la mareaTextoSube, Baja o Estoa, según los últimos 15 a 20 minutos de mediciones.
Sobreelevación prevista (SHOM)Profundidad (cm)La sobreelevación que el SHOM prevé ahora: positiva por encima de la marea predicha, negativa por debajo.
Sobreelevación máx. en 24 hProfundidad (cm)La mayor sobreelevación prevista entre ahora y dentro de 24 horas.
Última mediciónTextoHora de la última medición, o «Sin nueva medición desde…».

Las dos funciones de sobreelevación solo existen si el SHOM prevé la sobreelevación del mareógrafo (si la previsión aparece después de crear el dispositivo, actualícelo en la pestaña Descubrir). Un mareógrafo sin datos muestra «Desconocida» como tendencia. El nivel del mar no es una profundidad: es la altura del agua sobre la referencia del mareógrafo (en general el cero hidrográfico, el de las tablas de mareas); se compara con las alturas de la tabla del mismo puerto, no con otro mareógrafo. Los parámetros del dispositivo contienen el número SHOM y la red (REFMAR, RONIM).

El nivel y las sobreelevaciones son funciones numéricas: las escenas de Gladys ya pueden compararlas con cualquier valor que usted elija.

Widget de panel​

Añada el widget Mareógrafos a un panel.

  • Sin ajuste: una línea por mareógrafo seguido (10 como máximo) con su nivel, su tendencia y su sobreelevación prevista, coloreada según la sobreelevación: verde por debajo de 20 cm, naranja desde 20 cm, rojo desde 50 cm, gris sin medición reciente. Un título nombra los mareógrafos con 20 cm o más previstos en las próximas 24 horas.
  • Con un mareógrafo elegido: su nivel y su sobreelevación en directo, la curva del nivel medido en las últimas 24 horas (un ajuste la oculta), la tendencia, la sobreelevación máxima prevista y su hora, la última medición y un enlace a su página de data.shom.fr.

Disparadores de escena​

DisparadorFiltrosVariables
Sobreelevación prevista por encima de un umbralMareógrafo, umbral (20 a 100 cm)Nombre del mareógrafo, umbral, sobreelevación actual (cm), nivel (m)
Sobreelevación de nuevo bajo un umbralMareógrafo, umbralNombre del mareógrafo, umbral, sobreelevación actual (cm), nivel (m)
Sobreelevación por encima de un umbral en 24 hMareógrafo, umbralNombre del mareógrafo, umbral, sobreelevación máxima (cm), su hora
Nivel del mar por encima de un umbralMareógrafo, altura (0,5 a 12 m)Nombre del mareógrafo, umbral, nivel (m)

Un valor debe bajar 5 cm por debajo de un umbral antes de que un nuevo cruce cuente: una sobreelevación o un nivel que oscila alrededor de un umbral dispara una sola vez. Los disparadores solo se activan para un dispositivo creado (los de sobreelevación siguen la previsión del SHOM, aunque el nivel ya no llegue), y no tras un reinicio de más de 3 horas.

Acción de escena​

Resumen de un mareógrafo (campo: el mareógrafo) da una frase en el idioma de la configuración, para un mensaje o un anuncio por voz, y los valores para las acciones siguientes: el resumen, el nivel (m), la sobreelevación prevista ahora y la máxima en 24 horas (cm).

Ejemplos de escenas​

  • Aviso de temporal: «Sobreelevación por encima de un umbral en 24 h», su mareógrafo, 50 cm → enviar un mensaje: «{{station_name}}: sobreelevación de {{surge_peak}} cm prevista el {{peak_time}}».
  • Muelle inundado: «Nivel del mar por encima de un umbral», Saint-Malo, 12 m → avisar a la familia y cerrar la puerta del garaje.
  • Informe matinal: cada día a las 7:00, «Resumen de un mareógrafo» de su puerto → enviar el resumen.
  • Fin del episodio: «Sobreelevación de nuevo bajo un umbral», 30 cm → «La sobreelevación ha pasado».

Fuentes de datos, licencia y cuotas​

  • Datos: SHOM, red REFMAR (Réseaux de référence des observations marégraphiques), y los organismos que operan los mareógrafos (puertos, entidades locales, Météo-France…). Mención: «SHOM / REFMAR», DOI 10.17183/REFMAR. Los datos de data.shom.fr se publican bajo la Licence Ouverte (Etalab) 2.0; el widget cita la fuente.
  • Los niveles son datos brutos en tiempo real («fuente 1» del SHOM, cada minuto), difundidos sin validación: pueden contener valores erróneos, corregidos más tarde en las series validadas, que la integración no usa.
  • La sobreelevación es la previsión del SHOM («fuente 9», cada 10 minutos, unos días por adelantado). La sobreelevación medida (nivel menos predicción de marea) necesita la predicción, que este servicio sin clave no ofrece: la integración no la calcula.
  • Sin cuenta, sin clave, sin cuota documentada. La integración es ligera: una solicitud por mareógrafo y por actualización (10 minutos por defecto), para las mediciones desde la anterior y la previsión de las próximas 25 horas; la lista de mareógrafos (unos 30 kB) una vez por semana.

Solución de problemas​

  • «Mareógrafo desconocido»: compruebe la ortografía o use «Buscar mareógrafos» y copie el número.
  • «El servicio del SHOM no responde»: el servicio o su acceso a Internet no funciona; los valores vuelven solos.
  • «Alrededor de mi casa» no añade nada: dé una ubicación a su casa (Ajustes, Casas) o elija una distancia mayor. Solo se elige un mareógrafo que haya enviado una medición en la última hora.
  • Sin función de sobreelevación: el SHOM no prevé la sobreelevación de este mareógrafo.
  • «Sin nueva medición desde…»: el mareógrafo está averiado o con retraso (la lista del SHOM marca muchos «con retraso» o «fuera de servicio»); los valores vuelven solos.
  • Registros: en Gladys, los registros de la integración; LOG_LEVEL=debug muestra cada ciclo.

Límites​

  • Probada contra el servicio real y con respuestas grabadas, pero aún no en una instalación real de Gladys: sus comentarios son bienvenidos.
  • Ni predicción de marea ni sobreelevación medida: la integración publica el nivel medido y la sobreelevación prevista por el SHOM.
  • 10 mareógrafos como máximo desde la configuración (más aquellos cuyo dispositivo haya creado).
  • Los nombres de las funciones se fijan al crear el dispositivo: cambiar el idioma después solo cambia los textos enviados a partir de entonces.

Parámetros de configuración​

Estos son los parámetros que Marégraphes (SHOM) te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Sus mareógrafossectionNoSiga los mareógrafos del SHOM (red REFMAR) en las costas de Francia y de ultramar: por número o nombre, o el más cercano a su casa. «Buscar mareógrafos» más abajo los enumera con su nivel actual. Guarde y cree los dispositivos en la pestaña Descubrir.
Fuentes y límitessectionNoDatos: SHOM, red REFMAR, y los organismos que operan los mareógrafos, leídos sin cuenta. Niveles brutos en tiempo real, no validados por el SHOM; la sobreelevación es la previsión del SHOM. No es un servicio de alerta: prevalecen los avisos oficiales (Météo-France). Sin afiliación con el SHOM.
MareógrafosstringNoNúmeros SHOM o nombres de mareógrafos, separados por comas.
Alrededor de mi casaselectNoSeguir también el mareógrafo más cercano que envía mediciones, como máximo a esta distancia de la ubicación de su casa en Gladys.
Intervalo de actualizaciónselectNoLos mareógrafos miden cada minuto, la sobreelevación prevista cambia cada 10 minutos. Una solicitud por mareógrafo.
Idioma de los nombres de las funcionesselectNoNombres de las funciones de los nuevos dispositivos (Nivel del mar medido, Sobreelevación prevista…) e idioma de sus textos, de las variables de escena y del resumen.

Cómo instalar Marégraphes (SHOM) en Gladys​

  1. En Gladys, abre Integraciones: Marégraphes (SHOM) 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-maregraphes:1.0.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/guim31/gladys-maregraphes.

Marégraphes (SHOM) 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​

Marégraphes (SHOM) 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 🙂
Última actualización en