🚀 Introducción
MeteoRide es una aplicación web diseñada para ciclistas que permite cargar rutas GPX/KML y obtener pronósticos meteorológicos detallados a lo largo del recorrido.
La app calcula automáticamente los pasos de la ruta basados en la velocidad de ciclismo seleccionada y recupera datos de varios proveedores meteorológicos para mostrar temperatura, viento, precipitaciones, humedad, nubosidad, luminosidad y más.
Incluye opciones de fallback automático para asegurar datos incluso si un proveedor falla, y permite comparar pronósticos de diferentes fuentes.
Es ideal para planificar rutas seguras y preparadas para el clima.
🚀 Primeros Pasos
1. Cargar una Ruta GPX/KML
Haz clic en el botón 📁 para seleccionar tu archivo GPX o KML. MeteoRide soporta tracks, rutas y waypoints estándar.
💡 Consejo: También puedes usar URLs directas con parámetros como
?gpx_url= para cargar rutas automáticamente. Para información detallada sobre cómo compartir rutas desde iOS o Android consulta la página del proyecto en
GitHub.
🔗 Exportar desde Komoot/Bikemap: Existe un userscript para Tampermonkey que añade un botón en Komoot y Bikemap para abrir la ruta directamente en MeteoRide. Ten en cuenta que en Komoot solo es posible descargar GPX si tienes una cuenta Premium. Consulta el README del proyecto para instrucciones de instalación.
➡️ Exportar desde MeteoRide a Hammerhead: El proyecto incluye un userscript que permite exportar el GPX actual desde MeteoRide a Hammerhead (dashboard.hammerhead.io). El script sube el GPX en bruto a un share-server configurado y solicita a Hammerhead que importe la URL. Consulta el README para instalar y configurar el userscript.
2. Configurar Fecha y Hora
Selecciona cuándo planeas hacer la ruta. El sistema ajusta automáticamente a intervalos de 15 minutos.
3. Ajustar Velocidad
Introduce tu velocidad media estimada o usa los presets: 5, 10, 12, 15, 20 km/h.
4. Elegir Intervalo
Selecciona cada cuántos minutos quieres ver la información meteorológica (15 o 30 minutos).
5. Elegir Proveedor Meteorológico
Selecciona el proveedor meteorológico que deseas utilizar para obtener los datos.
- Open-Meteo: Gratuito, no requiere API key, hasta 14 días de previsión.
- MeteoBlue: Requiere API key, hasta 7 días, muy preciso
- OpenWeather: Requiere API key, hasta 5 días, datos detallados
- AromeHD: Modelo de alta resolución de MeteoFrance, accesible vía Open-Meteo. Solo disponible para Europa (aprox. 39-52°N, 10.5°W-16.5°E) y dentro de 48 horas (fuera de estas horas conmuta directamente al mejor provedor que provee Open-Meteo para esa localización). Es especialmente útil para viento y precipitaciones a corto plazo.
- OpenWeather - AromeHD Utilizar Openweather para la primera hora, luego AromeHD hasta 48 horas. Rutas fuera de este periodo se calculan con OpenMeteo. Solo disponible si hay key de Openweather. Esta cadena aprovecha los datos en tiempo real de OpenWeather para planificación inmediata y la precisión hiperlocal de AROME para viento y precipitaciones.
- Comparar (Comp.): Activa el modo de comparación para evaluar diferencias entre proveedores.
💡 Fallback Automático: Si tu proveedor principal falla o no tiene datos, MeteoRide cambia automáticamente a Open-Meteo. Meteoride notificará mediante un mensaje esta situación (siempre que esté seleccionado en Configuración)
6. Modo Comparar Fechas
Este modo permite comparar pronósticos meteorológicos entre dos fechas/horas diferentes para la misma ruta:
- Selecciona "Comparar Fechas" en el menú desplegable de proveedores para entrar en este modo
- Configura Fecha A y Fecha B usando los controles de fecha/hora que aparecen
- Usa los botones de solo iconos, para desplegar la segunda fecha y luego debes pulsar el botón 🔄 Comparar para actualizar la tabla
- La tabla muestra 4 filas: intervalos de Fecha A, resumen de Fecha A, intervalos de Fecha B, resumen de Fecha B
- Sin recálculo automático - si cambias los parámetros debes ejecutar la comparación para su recalculo
🌤️ Proveedores Meteorológicos y Ventajas
Comparación de Proveedores
MeteoRide soporta múltiples proveedores meteorológicos, cada uno con fortalezas únicas:
- Open-Meteo: Gratuito, sin API key, cobertura global, hasta 14 días. OpenMeteo usa su mejor modelo dependiendo de la zona de tu track. Recomendado para todos los escenarios, ideal para planificación a largo plazo y rutas globales.
- MeteoBlue: Requiere API key, hasta 7 días, muy preciso especialmente para clima de montaña. Perfecto para rutas alpinas y terrenos complejos.
- OpenWeather: Requiere API key, hasta 4 días, excelente datos en tiempo real y alertas meteorológicas oficiales. Ideal para salidas inmediatas y áreas urbanas.
- AROME-HD: Modelo de alta resolución (~1-2km) de MeteoFrance, disponible para Europa dentro de 48 horas. Superior para pronósticos de viento y precipitaciones a corto plazo en Francia y países cercanos.
Cadenas de Proveedores
Las cadenas combinan las fortalezas de múltiples proveedores:
- OpenWeather → AROME-HD → Open-Meteo: Usa datos en tiempo real de OpenWeather para la primera hora, precisión hiperlocal de AROME para las siguientes 47 horas, luego Open-Meteo confiable para pronósticos más largos. Requiere API key de OpenWeather.
💡 Consejo: Elige según tus necesidades: precisión en tiempo real (OpenWeather), precisión local (AROME-HD), terrenos de montaña (MeteoBlue), o planificación a largo plazo (Open-Meteo).
� Instalación como App
MeteoRide se puede instalar como una Aplicación Web Progresiva (PWA) en tu dispositivo para una experiencia similar a una app nativa.
Android
- Abre MeteoRide en Chrome.
- Toca el menú (tres puntos) en la parte superior derecha.
- Selecciona "Agregar a pantalla de inicio".
- Confirma tocando "Agregar".
iOS (iPhone/iPad)
- Abre MeteoRide en Safari.
- Toca el botón Compartir (cuadrado con flecha).
- Selecciona "Agregar a pantalla de inicio".
- Toca "Agregar" en la parte superior derecha.
Chrome en Escritorio
- Abre MeteoRide en Chrome.
- Haz clic en el icono de instalar en la barra de direcciones o en el menú.
- Haz clic en "Instalar".
Edge en Escritorio
- Abre MeteoRide en Edge.
- Haz clic en el icono de instalar en la barra de direcciones.
- Haz clic en "Instalar".
Safari en Mac
- Abre MeteoRide en Safari.
- Ve a Archivo > Agregar al Dock.
- O, haz clic en el botón Compartir y selecciona "Agregar al Dock".
🛠️ Configuración
🔑 API Keys
Para MeteoBlue y OpenWeather necesitas registrarte y obtener una API key gratuita:
Usa el botón 🔍 Check para verificar que tu API key funciona correctamente.
🔑 Test de API Keys y avisos
En el panel de configuración hay botones Check para MeteoBlue y OpenWeather. Al pulsarlos
se realiza una petición simple y el estado se muestra junto al campo (válida / inválida / cuota / HTTP).
Además existe la casilla Mostrar avisos no críticos que controla la verbosidad de las notificaciones:
si está activada verás banners informativos cuando se produzcan fallbacks por horizonte temporal, cuota o errores API;
si está desactivada solo se muestran errores críticos.
Cuando un proveedor excede su horizonte o falla repetidamente, la app cae automáticamente a Open‑Meteo solo para los pasos afectados.
Esto se indica con un aviso breve en la cabecera.
📏 Unidades
- Viento: km/h, m/s, mph
- Temperatura: °C, °F
- Distancia: km, mi
- Precipitación: mm, in
🌐 Idiomas
La aplicación soporta español e inglés. Selecciona tu idioma preferido en la configuración para cambiar el idioma de la interfaz y los mensajes.
📊 Interpretando los Datos
🌤️ Tabla Meteorológica
La tabla muestra información hora por hora:
- Primera fila: Hora y distancia acumulada
- Segunda fila: Iconos del tiempo
- Temperatura: En grados Celsius o Fahrenheit
- Viento: Velocidad + flecha de dirección (rachas entre paréntesis)
- Lluvia: Cantidad en mm/h (probabilidad entre paréntesis)
- Humedad: Porcentaje de humedad relativa
- Nubosidad: Porcentaje de cobertura de nubes
- Luminosidad: Se muestra como una barra vertical junto al símbolo del tiempo en la segunda fila (representa 0–100% de luz disponible para ese intervalo)
- UV: Índice ultravioleta (número entero) — aparece en la fila combinada "Nubes / UV"
🗺️ Mapa Interactivo
- Flechas azules: Viento suave (<12 km/h)
- Flechas rojas: Viento fuerte (30-50 km/h)
- Flechas moradas: Viento muy fuerte (>50 km/h)
- Gotas 💧: Precipitación esperada
- Marcadores verdes/rojos: Inicio y final de ruta
💡 Interactividad: Haz clic en cualquier columna de la tabla o flecha del mapa para ver detalles específicos de ese punto.
📱 Funciones Avanzadas
🔄 Desplazamiento Horizontal
La tabla meteorológica es interactiva y adaptada para pantallas táctiles:
- Arrastra horizontalmente la tabla o usa la rueda del ratón para desplazar columnas (gestos y "drag‑to‑scroll").
- Haz clic en cualquier columna (o cualquier celda para seleccionar esa columna) la fila y el mapa se resaltarán.
- El mapa se centra en el punto seleccionado si haces clic en una flecha de viento o en la columna.
- Si la penúltima columna queda a menos de 5 minutos de la última, la app la oculta para evitar duplicados visuales.
Consejo: usa el pequeño icono ⇆ que aparece para indicar que la tabla tiene más columnas disponibles al desplazarte.
🌅 Información Solar
La app muestra automáticamente:
- Hora de amanecer y atardecer
- Crepúsculo civil (marcado con "c")
- Cálculo de luminosidad real según la hora y condiciones
🎯 Fallbacks Inteligentes
MeteoRide maneja automáticamente:
- Cambio a Open-Meteo si tu proveedor excede su horizonte temporal
- Reintentos cuando hay errores temporales
- Notificaciones claras sobre limitaciones de datos
🔗 URLs con Parámetros
Puedes usar enlaces directos con parámetros:
?gpx_url=https://ejemplo.com/ruta.gpx?datetime=2024-03-15T10:00?speed=25
🗺️ Rutas recientes (guardadas localmente)
MeteoRide guarda localmente las últimas rutas GPX que has cargado para que puedas recuperarlas rápidamente sin subir de nuevo el archivo. Esta funcionalidad es totalmente local: no se envían las rutas al servidor.
- Cómo usarlo: junto al botón de subir archivo (📁) verás un desplegable con tus rutas recientes. Selecciona una ruta y se cargará exactamente como si la hubieras subido ahora.
- Límite: se guardan las últimas 3 rutas por defecto.
- Tamaño recomendado: soporta archivos GPX grandes, hasta aproximadamente 750 KB. Si tu GPX es significativamente más grande, considera recortarlo o usar un host público y cargarlo con
?gpx_url=.
- Privacidad: Los GPX se almacenan en tu navegador usando IndexedDB (o localStorage como fallback). No se comparten fuera de tu dispositivo.
- Eficiencia: Para ahorrar memoria, MeteoRide mantiene en memoria solo la información básica (nombre, tamaño y fecha) y carga el contenido completo solo cuando seleccionas una ruta del desplegable.
💾 Caché local y rendimiento
Las respuestas de los proveedores se almacenan en localStorage durante ~30 minutos por paso/hora.
Esto acelera recargas frecuentes y reduce peticiones a APIs con límites. Puedes borrar la caché desde las herramientas del navegador.
⚠️ Limitaciones y Consejos
🚨 Limitaciones Importantes
- Horizonte temporal: Open-Meteo (14 días), MeteoBlue (7 días), OpenWeather (2 días)
- Precisión: Las previsiones son menos fiables a partir del día 3-4
- APIs gratuitas: Las APIS de Meteoblue y OpenWeatherMap tienen modalidad gratuita (Open-Meteo no requiere una API) por lo que tienen límites de uso mensuales
✅ Mejores Prácticas
- Usa rutas de máximo 100-200 km para mejor rendimiento
- Planifica con 1-2 días de antelación para mayor precisión
- Combina información de múltiples fuentes para decisiones importantes
- Ten siempre un plan B para condiciones adversas
- Lleva equipo de lluvia aunque la probabilidad sea baja
� Alertas meteorológicas oficiales
MeteoRide puede mostrar avisos y alertas oficiales que publican los servicios meteorológicos nacionales cuando estos aparecen en las alertas del servicio OpenWeather. Para que las alertas estén disponibles debes introducir tu OpenWeather API Key en el panel de configuración y activar la casilla Mostrar alertas meteorológicas oficiales.
- Disponibilidad: Requiere una OpenWeather API Key. Si la clave está configurada, MeteoRide comprobará alertas aunque no hayas seleccionado OpenWeather como proveedor principal.
- Visibilidad: Cuando se detecta una alerta se mostrará una tarjeta informativa en pantalla (auto‑oculta tras 15 segundos). Además se crea un indicador persistente ⚠️ en la interfaz que permite reabrir todas las alertas detectadas.
- Muestreo y eficiencia: Para reducir el número de llamadas a la API se comprueba una muestra representativa de puntos a lo largo de la ruta (aprox. 2/3 de los pasos, mínimo 3). Las respuestas de alertas se cachean localmente durante ~1 hora.
- Compatibilidad temporal: Solo se considerarán alertas cuyo periodo (start/end) coincida con la ventana temporal del tramo de la ruta (se aplica un filtro de ±1 hora alrededor del paso correspondiente).
⚠️ Aviso importante
Estas alertas se proporcionan solo como información adicional. No confíes exclusivamente en ellas para decisiones de seguridad. Siempre consulta el servicio meteorológico oficial de tu país o las autoridades competentes antes de realizar una actividad que pueda verse afectada por condiciones adversas. OpenWeather puede contener errores, retrasos o no incluir avisos locales específicos; MeteoRide no sustituye a los comunicados oficiales.
��🐛 Resolución de Problemas
❌ Problemas Comunes
- GPX/KML no carga: Verifica que el archivo contenga tracks válidos
- Sin datos meteorológicos: Comprueba tu API key o usa Open-Meteo
- Fecha fuera de rango: Reduce el horizonte temporal
- Tabla vacía: Asegúrate de que la ruta tiene suficiente longitud
🔒 Privacidad y Datos
🛡️ Protección de tu Privacidad
MeteoRide funciona completamente en tu dispositivo. Toda la configuración, preferencias y datos se almacenan únicamente en tu navegador local mediante localStorage. Solamente en el caso de utilizar shortcuts para compartir un GPX se enviará este fichero en cloudflare. Esto es impprescindible para el uso con shorcuts de IOS que solo aceptan POST (si no abres el fichero directamente desde Meteoride entonces no se enviará ya que se procesa en local). En cualquier caso, el fichero GPX se borra automáticamente en un periodo máximo de dos minutos.
- Sin registro: No necesitas crear cuenta ni proporcionar datos personales
- Control total: Puedes borrar todos los datos desde la configuración de tu navegador
- Código abierto: Puedes inspeccionar todo el código fuente en GitHub
🌐 Datos Compartidos con Proveedores Meteorológicos
Para obtener las predicciones meteorológicas, MeteoRide comparte únicamente:
- Coordenadas geográficas de los puntos de tu ruta
- Fechas y horas para las que necesitas la previsión
- Tu API Key (si usas MeteoBlue u OpenWeather) estarán en el local storage de tu equipo. Esto significa que podrían ser accesibles, hipotéticamente por un tercero. El riesgo con este tipo de claves es bajo, pero se recomienda el uso de una clave free a estos proveedores con datos que no supongan un problema en caso de leak. O no usarlos y usar los proveedores (openmeteo-Arome) que no tienen necesidad de API.
💡 Importante: Los proveedores meteorológicos (Open-Meteo, MeteoBlue, OpenWeather) tienen sus propias políticas de privacidad. MeteoRide solo actúa como intermediario para solicitar los datos meteorológicos que necesitas.
🗂️ Qué se Guarda Localmente
- Configuración de unidades y idioma
- API Keys (encriptadas en tu navegador)
- Preferencias de velocidad e intervalos
- Caché temporal de datos meteorológicos (30 minutos)
📄 Licencia y Créditos
👨💻 Desarrollador
MeteoRide ha sido desarrollado por Lockevod.
📝 Licencia
Este proyecto está licenciado bajo la Licencia MIT, lo que significa que:
- ✅ Puedes usar la aplicación libremente
- ✅ Puedes modificar el código fuente
- ✅ Puedes distribuir tu propia versión
- ✅ Para uso personal y comercial
- ✅ Tienes que informar sobre el autor y la licencia MIT
Bikemap, Komoot, OpenWeatherMaps, Openmeteo, Meteoblue y Hammerhead son marcas registradas. Pueden tener licencias propietarias específicas, por favor, si usas este código o la aplicación web publicada debes cumplir con ellas. Si no quieres, no puedes usar este código ni la aplicación.
Este código y la aplicación web están diseñados con la seguridad de tipo "zero trust" en mente, pero no son un código ni un servicio comercial. El código y la aplicación web se proporcionan tal cual, sin ninguna garantía ni responsabilidad. Aceptas esto si descargas este repositorio, usas el código o usas la aplicación web.
La información actualizada sobre esta aplicación está siempre en GitHub. Aceptas toda la información actualizada, responsabilidades y restricciones en la página de GitHub enlazada si usas esta aplicación.
📋 Código Fuente: El código completo está disponible en
GitHub. ¡Las contribuciones son bienvenidas!
⚖️ Exención de Responsabilidad
MeteoRide es una herramienta de planificación. Los datos meteorológicos son estimaciones y pueden no ser completamente precisos. Siempre usa tu criterio y verifica las condiciones antes de salir. El desarrollador no se hace responsable de decisiones basadas en esta información.
📞 Soporte y Contribuciones
🐛 Reportar Problemas
- Visita el repositorio en GitHub
- Activa el modo debug (🐞) para obtener información técnica
- Incluye detalles sobre tu dispositivo y navegador
🤝 Contribuir al Proyecto
- Fork del repositorio en GitHub
- Reporta bugs o sugiere mejoras
- Traduce a nuevos idiomas
- Mejora la documentación
💡 Consejo final: ¡El tiempo puede cambiar rápidamente! Usa MeteoRide como guía, pero mantente flexible y seguro en tus rutas.
💰 Apoya el Proyecto
Si encuentras útil MeteoRide, considera apoyar el proyecto con una donación:
