📘 Introducción

Descripción

Este proyecto es una API de Clima Local implementada con Laravel 12, que ofrece un servicio RESTful para obtener información climática basada en coordenadas geográficas.

A diferencia de las soluciones que dependen de APIs externas, esta API consulta directamente una base de datos local que contiene registros históricos y precargados de datos climáticos.

La carga de datos en la base de datos se realiza mediante un proceso automatizado con N8N, el cual consulta periódicamente la API de CONAGUA y persiste la información localmente. La aplicación sigue principios de diseño limpio, utilizando Laravel Actions para la encapsulación de la lógica de negocio y Laravel API Resources para una transformación y presentación de datos consistente y limpia.

Objetivo

Proveer un servicio confiable y eficiente para la consulta de información climática basada en coordenadas geográficas, a través de una API RESTful construida con Laravel 12. Esta solución permite acceder a datos meteorológicos históricos y actualizados sin depender de fuentes externas, gracias a una base de datos local alimentada automáticamente desde la API de CONAGUA mediante N8N. El sistema garantiza respuestas consistentes y estructuradas, siguiendo principios de diseño limpio que facilitan su mantenimiento, escalabilidad e integración con otras aplicaciones o servicios institucionales.

Características Principales

• Obtención de datos climáticos actuales desde una base de datos local.
• Organización de la lógica de negocio mediante Actions.
• Serialización de respuestas API limpia y consistente con API Resources.

Tecnologías Utilizadas

• Laravel 12: Framework de PHP para el desarrollo web.
• PHP 8.2+.
• Composer: Gestor de dependencias de PHP.
• MySQL: Base de datos (configurada en .env).
• Carbon: Para el manejo de fechas y horas.