Guía Completa para Consultar Datos en la Interfaz Web de Aire Ciudadano

Instrucciones para el uso de la Interfaz Web

1. Acceso a la interfaz web:

  • La página web ofrece una interfaz sencilla para seleccionar parámetros y consultar los datos de la API de Aire Ciudadano.
  • Dirígete a la ruta /getdata de tu servidor para acceder al formulario que permite configurar y obtener los resultados.

2. Configuración de la consulta

Campos del formulario:

  1. Variables a seleccionar:
    • Debes elegir las variables que quieres incluir en los resultados. Las opciones disponibles son:
      • PM25
      • PM25raw
      • PM1
      • Humidity
      • Temperature
    • Puedes seleccionar una o más variables para realizar la consulta.
  2. Rango de fechas y horas:
    • Elige la fecha y la hora de inicio y fin del rango de tiempo en el que deseas obtener los datos.
    • Ejemplo:
      • Fecha de inicio: 2024-01-01
      • Hora de inicio: 01:00
      • Fecha de fin: 2024-02-01
      • Hora de fin: 01:00
  3. Método de agregación:
    • Puedes seleccionar entre dos métodos:
      • Step: Obtiene los datos sin promediarlos, según el intervalo de tiempo seleccionado.
      • Average: Calcula el promedio de los valores dentro del intervalo seleccionado.
  4. Intervalo de tiempo (Step/Average number):
    • Define el intervalo para consultar o calcular los datos. Elige el número de intervalos y si deben ser en minutos, horas, días o semanas.
    • Ejemplo:
      • Step number: 1
      • Opción: Hours (esto obtendrá datos a intervalos de una hora).
  5. Filtro por estación (opcional):
    • Puedes ingresar un filtro para limitar los resultados a una o más estaciones específicas, separadas por comas.
    • Ejemplo: station1,station2
  6. Formato del resultado:
    • Result in screen: Muestra el resultado directamente en la pantalla.
    • Result in json ZIP file: Descarga los resultados en un archivo comprimido .zip que contiene un archivo .json con los datos.

3. Ejemplos de uso

Ejemplo 1: Obtener resultados en pantalla

  • Variables seleccionadas: PM25, Temperature
  • Fecha de inicio: 2024-01-01
  • Hora de inicio: 06:00
  • Fecha de fin: 2024-02-01
  • Hora de fin: 05:00
  • Método de agregación: Step
  • Step number: 1
  • Opción: Hours
  • Resultado: En pantalla

Obtiene los datos de cada hora del valor de PM25 y Temperature desde las 06:00 del 2024-01-01 hasta las 05:00 del 2024-02-01, Valor a las 06:00, 07:00, 08:00 hasta las 05:00 del 2024-02-01, 24 grupos de datos. Cuando el formulario se complete, el resultado será un JSON con los datos de las estaciones filtradas en el rango de tiempo especificado.

Ejemplo 2: Descargar resultados en archivo comprimido

  • Variables seleccionadas: PM25, Humidity, Temperature
  • Fecha de inicio: 2024-07-01
  • Hora de inicio: 06:00
  • Fecha de fin: 2024-07-01
  • Hora de fin: 12:00
  • Método de agregación: Average
  • Step number: 1
  • Opción: Hours
  • Resultado: En archivo ZIP

Obtiene el rango promedio por cada hora (promedio de 60 datos minutales para calcular 1 hora) durante 24 horas el valor de PM25, Humidity y Temperature desde las 06:00 (desde 5:01 a 06:00) del 2024-07-01 hasta las 12:00 (desde 11:01 hasta 12:00) del 2024-07-01. Al presionar “Submit”, el servidor generará un archivo .zip que contendrá un archivo .json con los datos agregados de las estaciones seleccionadas.

4. Resultados esperados

Resultado en pantalla:

Si seleccionas “Result in screen”, el resultado será un JSON con el siguiente formato:

{
  "total_records": 120,
  "data": {
    "station1": [
      {
        "date": "2024-01-01T01:00:00Z",
        "PM25": 12.5,
        "Temperature": 23.6
      },
      {
        "date": "2024-01-01T02:00:00Z",
        "PM25": 15.1,
        "Temperature": 24.0
      }
    ],
    "station2": [
      {
        "date": "2024-01-01T01:00:00Z",
        "PM25": 9.8,
        "Temperature": 21.5
      }
    ]
  }
}

Resultado en archivo:

Si seleccionas “Result in json ZIP file”, el servidor comprimirá el archivo .json y te permitirá descargarlo en formato .zip.

5. Instrucciones finales

  • Asegúrate de ingresar correctamente las fechas y horas. El servidor ajusta automáticamente el rango de tiempo para incluir los datos solicitados.
  • Si optas por “Average”, el servidor promediará los datos en intervalos de una hora. Si optas por “Step”, se mostrarán los datos sin procesar según el intervalo seleccionado.