Meteograma MeteoGalicia (Signal K Webapp)

Webapp para Signal K que muestra un meteograma por horas (viento, dirección, lluvia, temperatura, oleaje, etc.) y permite ver la predicción para cualquier punto del mapa (posición del cursor).

Esta webapp se apoya en el MeteoGalicia Weather Provider (plugin aparte), que consulta la API MeteoSIX v5 de MeteoGalicia y expone el forecast a Signal K.

Qué necesitas antes (API MeteoGalicia)

Para usar el sistema completo necesitas una API_KEY de MeteoGalicia (MeteoSIX / API v5).

• Web del modelo MeteoSIX:
  https://www.meteogalicia.gal/web/modelos-numericos/meteosix

• Documentación oficial (PDF):
  API_MeteoSIX_v5_gl.pdf (el proveedor se construyó siguiendo este documento)

La API_KEY se configura dentro del plugin Weather Provider, no en esta webapp.

Componentes del sistema

1) Weather Provider (obligatorio)

• Paquete: signalk-meteogalicia-weather-provider
• Función: descarga y transforma la predicción de MeteoGalicia (WRF/WW3/SWAN + mareas opcionales) y la ofrece a Signal K como “Weather Provider”.

2) Meteograma (esta webapp)

• Paquete: signalk-meteogalicia-meteogram
• Función: interfaz visual (HTML/JS) que consume los datos del provider desde Signal K y los presenta en formato meteograma.

Instalación

Opción A) Appstore / Add-ons (recomendada)

1. Entra en Signal K → Server → Appstore / Available
2. Busca: Meteograma MeteoGalicia
3. Instala y habilita:
   • signalk-meteogalicia-weather-provider
   • signalk-meteogalicia-meteogram

Opción B) Entorno Docker (nota importante)

Lo importante es que el plugin se instale dentro del mismo entorno donde corre Signal K.

Si Signal K corre en Docker, instalar npm “en tu Windows” no sirve. Debe quedar dentro del contenedor / volumen del servidor.

Configuración (paso a paso)

1) Configura el Weather Provider (obligatorio)

Signal K → Server → Plugin Config → MeteoGalicia Weather Provider

Campos:

• API_KEY de MeteoGalicia (obligatorio)
• Cache (min) (opcional)
• Incluir mareas (opcional)
• Debug (opcional)

Guarda y reinicia el servidor si te lo pide.

2) Habilita la webapp Meteograma

Signal K → Server → Webapps

• Debe aparecer: Meteograma MeteoGalicia
• Ábrela desde ahí.

Si no la ves en “Webapps”, revisa que el package.json incluya el bloque signalk (ver más abajo).

Cómo usarlo (para cualquier punto del mapa)

1. Abre la webapp Meteograma MeteoGalicia
2. Activa el modo de posición de Cursor (si existe en tu UI) o usa Mi posición.
3. Al mover el cursor/pulsar en el mapa, la webapp consulta el forecast de ese punto.

En términos técnicos, la webapp solicita el forecast a Signal K, que a su vez se lo pide al provider:

• Forecast por punto (Signal K): /signalk/v2/api/weather/forecasts/point?lat=...&lon=...&count=...

No hace falta conocer esta URL para usarlo, pero sirve para depurar.

Qué datos muestra (unidades)

El provider entrega, entre otros:

• Viento:
  • wind.speedTrue (m/s)
  • wind.directionTrue (rad, dirección FROM)
• Lluvia:
  • precipitation.amount (mm)
• Temperatura:
  • temperature.air (°C)
• Olas:
  • waves.significantHeight (m)
  • waves.meanDirection (°)
  • waves.peakPeriod (s)
• Temperatura del mar:
  • sea.waterTemperature (°C)
• Mareas (opcional):
  • tide.height (m) + resumen pleamar/bajamar

Problemas típicos

401 Unauthorized al abrir /plugins/...

Si tienes seguridad activada en Signal K, algunas rutas pueden requerir sesión. Solución:

• abre la webapp desde Webapps (UI oficial)
• o asegúrate de estar logueado en Signal K en ese navegador.

No aparece en Webapps

Revisa que el package.json contenga:

• keywords incluyendo signalk-webapp
• signalk.displayName
• signalk.appIcon

Licencia

MIT