Tipos de datos
📌 ClimaActualResponse
Ambos endpoints (/api/v1/clima-actual y /api/v1/clima-pronostico) utilizan la misma estructura de datos para representar la información climática de un día determinado. La diferencia radica en la cantidad de registros: el primero devuelve un solo objeto (data), mientras que el segundo entrega un arreglo de objetos bajo data[], representando varios días consecutivos.
| Campo | Tipo | Fuente (CONAGUA) | Descripción |
|---|---|---|---|
id_estado |
int |
ides |
ID del estado. |
id_municipio |
int |
idmun |
ID del municipio. |
nombre_estado |
string |
nes |
Nombre del estado. |
nombre_municipio |
string |
nmun |
Nombre del municipio. |
dia_local |
string |
dloc |
Fecha y hora local en formato YYYY-MM-DD HH:MM:SS. |
numero_dia |
int |
ndia |
Número del día dentro del conjunto pronosticado (0 = hoy). |
temperatura_maxima_c |
string |
tmax |
Temperatura máxima esperada en °C. |
temperatura_minima_c |
string |
tmin |
Temperatura mínima esperada en °C. |
descripcion_cielo |
string |
desciel |
Descripción del cielo (Ej. "Poco nuboso"). |
probabilidad_precipitacion_porcentaje |
int |
probprec |
Porcentaje de probabilidad de precipitación. |
precipitacion_litros_m2 |
string |
prec |
Precipitación estimada en litros por metro cuadrado. |
velocidad_viento_kmh |
string |
velvien |
Velocidad del viento en km/h. |
direccion_viento_cardinal |
string |
dirvienc |
Dirección cardinal del viento (Ej. "N", "SE", "Oeste"). |
direccion_viento_grados |
string |
dirvieng |
Dirección del viento en grados (0–360). |
cobertura_nubes_porcentaje |
string |
cc |
Porcentaje estimado de cobertura nubosa. |
latitud |
string |
lat |
Latitud de la ubicación consultada. |
longitud |
string |
lon |
Longitud de la ubicación consultada. |
diferencia_utc |
int |
dh |
Diferencia horaria respecto a UTC (Ej. 6 para UTC-6). |