query_climate
Retrieve historical air quality and meteorological data for any location on Earth using Copernicus CAMS reanalysis and ERA5 data. Specify a bounding box, time range, variables, and aggregation to get CSV or stats output.
Instructions
Query historical climate and air quality data for a geographic region.
Returns Copernicus CAMS reanalysis (NO₂, PM2.5, PM10, O₃) and/or ECMWF ERA5 meteorological data (temperature, precipitation, wind, boundary layer height) for any location on Earth.
Args: lat_min: Southern boundary latitude (decimal degrees, e.g. 48.8) lat_max: Northern boundary latitude (decimal degrees, e.g. 49.0) lon_min: Western boundary longitude (decimal degrees, e.g. 2.2) lon_max: Eastern boundary longitude (decimal degrees, e.g. 2.5) time_start: Start of the period, e.g. "2022-01-01" or "2022-01" time_end: End of the period, e.g. "2023-12-31" or "2023-12" variables: Comma-separated list of variables to query. Air quality: no2, pm2p5, pm10, o3. Meteorology: era5_t2m (2m temperature), era5_tp (precipitation), era5_blh (boundary layer height), era5_u10, era5_v10 (wind). Default: "no2" aggregate: Time aggregation — "hourly", "daily", "monthly", "seasonal", or "trend" (OLS slope per year). Default: "monthly" format: Output format — "csv" (rows of data) or "stats" (summary: min/max/mean). Default: "csv"
Returns: CSV data or stats summary depending on the format argument. Credits used are shown in the response metadata.
Examples: - Air quality in Paris 2022: lat_min=48.8, lat_max=49.0, lon_min=2.2, lon_max=2.5, time_start="2022-01", time_end="2022-12", variables="no2,pm2p5" - 5-year NO₂ trend for London: aggregate="trend", time_start="2020-01", time_end="2024-12"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat_min | Yes | ||
| lat_max | Yes | ||
| lon_min | Yes | ||
| lon_max | Yes | ||
| time_start | Yes | ||
| time_end | Yes | ||
| variables | No | no2 | |
| aggregate | No | monthly | |
| format | No | csv |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |