documentación de meridian
Guías para usar el panel, las suscripciones y el comportamiento de la API.
Primeros pasos
meridian es un panel del tiempo para varios lugares a la vez. Busca una ciudad, abre su página, fíjala en Tus ubicaciones y sigue la temperatura, las condiciones y pronósticos breves. No necesitas una cuenta. Tus ciudades fijadas y la mayoría de preferencias permanecen en este dispositivo.
Panel principal
De arriba a abajo: 1. Hero — texto de bienvenida, búsqueda y una comprobación rápida del tiempo en tu ubicación. 2. Tus ubicaciones — tarjetas del tiempo para los lugares que fijaste. 3. Cerca y popular — dos columnas: Cerca de ti y Búsquedas populares. 4. Un anuncio bajo Tus ubicaciones (marcador o AdSense). 5. Journal — carrusel de artículos. Ocultar con NEXT_PUBLIC_SHOW_HOME_STRETCH=0.
Detalle de la ciudad
Los resultados de búsqueda y las tarjetas de inicio abren una página para ese lugar. No necesitas fijar una ciudad para verla. Fijarla solo la añade a Tus ubicaciones en la página de inicio. Algunas ciudades de muestra y lugares ya conocidos por el sitio siempre abren; direcciones desconocidas muestran un estado vacío útil o 404.
Suscripciones
Puedes pedir a meridian que te envíe correos — sin iniciar sesión. Elige un boletín sobre el producto, un resumen semanal para una ciudad fijada y/o alertas del tiempo cuando las condiciones coincidan con lo que te importa. Todo es voluntario; cada correo incluye una forma de darte de baja.
Monetización y consentimiento
meridian funciona como un sitio del tiempo gratuito. No hay un pago Premium operativo ni un plan de pago que quite anuncios. La publicidad solo aparece si permites el consentimiento publicitario y el operador configuró Google AdSense.
Iconos del tiempo
Las imágenes del tiempo en tarjetas y pronósticos son iconos de línea/relleno claros (Meteocons de Bas Milius, licencia MIT). Muestran sol, nubes, lluvia, nieve, niebla y condiciones similares junto a la descripción escrita — el texto lleva el significado si una imagen no carga.
Cerca y popular
Bajo Tus ubicaciones la página de inicio muestra dos listas cortas de lugares. Cerca de ti — lugares sugeridos cerca de tu hogar o región, con condiciones en vivo. No es un registro privado de todo lo que buscaste. Búsquedas populares — lugares que se buscan a menudo en este sitio. También es a nivel del sitio, no «tu historial personal».
Pronósticos y caché
Los visitantes habituales pueden omitir esta página. Explica cómo el sitio almacena y actualiza datos del tiempo para quienes operan o integran meridian. En términos simples: tu navegador recuerda una lectura reciente; el servidor también recuerda lecturas compartidas para no llamar al proveedor del tiempo en cada clic.
Límites de API
Esta página es para quienes gestionan el sitio. Los datos del tiempo visitados se comparten y son favorables a la caché para que los límites gratuitos de OpenWeather (por defecto 1000 llamadas/día) se agoten con menos frecuencia.
Referencia de API
Esta página es para desarrolladores y operadores que integran las API de meridian — los visitantes habituales pueden omitirla. Todas las rutas API son manejadores Next.js App Router bajo src/app/api/. Tiempo y geocode requieren OPENWEATHER_API_KEY. Las rutas cron requieren Authorization: Bearer CRON_SECRET. Las rutas admin requieren cookie de sesión admin autenticada (meridian_admin_session) tras iniciar sesión en /login, salvo que ALLOW_DEV_ADMIN_BYPASS aplique en desarrollo.
Despliegue y entorno
Esta página es para quienes despliegan meridian. Los visitantes habituales no necesitan estos ajustes. Una demo funcional solo necesita OPENWEATHER_API_KEY; todo lo demás es stretch opcional.