Zona horaria y unidades

Pides en instantes reales; recibes filas agrupadas por el día y la hora del campo, y cada valor con su unidad.

Fechas en los parámetros

desde y hasta son instantes ISO 8601. Puedes indicar la zona (2026-10-01T00:00:00-03:00) o usar UTC (2026-10-01T03:00:00Z); ambos son el mismo instante. Si omites la zona se interpreta como UTC, así que es mejor escribirla siempre.

hasta es exclusivo: para todo octubre usa desde=2026-10-01T00:00:00-03:00 y hasta=2026-11-01T00:00:00-03:00.
En lecturas y clima, un hasta en el futuro se recorta al presente; un desde en el futuro responde 400.
En riegos no se recorta: así ves también los riegos programados hacia adelante.

Fechas en las respuestas

Campo	Qué es	Ejemplo
`fecha`	Día del campo (zona horaria del campo, `zonaHoraria` en `/campos`), formato AAAA-MM-DD.	`2026-10-14`
`hora`	Hora de reloj del campo (HH:00) en consultas por hora; `null` por día.	`13:00`
`inicio`	Instante real de inicio del período, ISO 8601 en UTC. Úsalo para ordenar y para sincronizar.	`2026-10-14T16:00:00.000Z`
`inicio`, `fin` (riegos)	Instantes reales en UTC.	`2026-10-14T05:30:00.000Z`
`creadoEn`, `actualizadoEn`, `ultimaActividad`	Instantes reales en UTC.

Casi todos los campos de Chile están en America/Santiago. Cuando cambia el horario (verano/invierno), la hora que se repite se junta en una sola fila.

Granularidad

`granularidad`	Filas	Rango máximo
`dia` (por defecto)	Una por día del campo, tipo de sensor y profundidad.	31 días
`hora`	Una por hora del campo, tipo de sensor y profundidad.	7 días

No hay lecturas crudas (cada 15 minutos, por ejemplo) en esta versión.

Agregados de cada fila

Campo	Significado	Útil para
`promedio`	Media de las lecturas del período.	Humedad, temperatura, viento.
`minimo` / `maximo`	Extremos del período.	Heladas, calor, estrés.
`ultimo`	Última lectura del período.	Estado al cierre del día.
`suma`	Suma de las lecturas.	Lluvia acumulada, lámina de riego.
`cantidad`	Cuántas lecturas se agregaron.	Detectar huecos de datos.

Unidades

Cada fila trae unidad tal como la reporta el equipo. Las más comunes:

Tipo de sensor (`tipoSensor`)	Unidad habitual
`Soil Moisture`	% (humedad volumétrica)
`Temperature`, `Soil Temperature`	°C
`Humidity`	%
`Rain`	mm (usa `suma`)
`Solar Radiation`	W/m²
`Wind Velocity`, `Wind Speed`, `Wind Gust`	km/h o m/s según la estación
`Wind Direction`	grados (0–360)
`Atmospheric Pressure`	hPa (estaciones Davis)
`UV Index`	índice (estaciones Davis)
`ET Davis`	mm (estaciones Davis)

Profundidad de las sondas: profundidad con unidadProfundidad (normalmente cm). Superficies: hectáreas. Riegos: volumen y precipitacion traen { valor, unidad } (m³ y mm). Coordenadas: WGS84 (lat, lng), como en Google Maps.