Air quality datasets

Average background levels of nitrogen dioxide and particulate matter (PM10 and PM2.5) in each UK local authority, from Defra's modelled pollution maps.

Published by

Department for Environment, Food and Rural Affairs

Covers

UK

Years

2024

Measures

Each measure is one kind of value you can request, using its id.

MeasureUnitCombining areas
PCM grid cellsair-quality-grid-cells1x1 km grid cellsAdds up
Background nitrogen dioxide, area meanno2-background-meanµg/m³Weighted average
Background PM10, area meanpm10-background-meanµg/m³Weighted average
Background PM2.5, area meanpm25-background-meanµg/m³Weighted average
Population-weighted PM2.5pm25-population-weightedµg/m³Not combined
Population-weighted anthropogenic PM2.5pm25-population-weighted-anthropogenicµg/m³Not combined

“Adds up” means you can total it over areas or convert it to other areas. See Measures and periods for why some can't be combined.

Areas and years

Request each of these with its geography and code year as geography and boundaryYear.

AreasCode yearPeriodsCoversRecords
Local authorities20242024UK361

Things to know

  • How many of Defra's 1x1 km PCM cells have their centre in the authority, roughly its land area in square kilometres. It is the weight for the area means.
  • Background concentrations are modelled for 1x1 km squares away from the immediate influence of roads and industrial sources, so they are lower than roadside measurements.
  • PCM maps from https://uk-air.defra.gov.uk/data/pcm-data. Each cell is assigned to the December 2024 authority containing its centre; a coastal cell whose centre lies offshore of the generalised coastline belongs to none.
  • The mean of Defra's modelled 2024 annual mean background nitrogen dioxide (NO2) concentration over the 1x1 km cells whose centres lie in the authority: an average across its area, not weighted by where people live.
  • The mean of Defra's modelled 2024 annual mean background PM10, in gravimetric units, concentration over the 1x1 km cells whose centres lie in the authority: an average across its area, not weighted by where people live.
  • The mean of Defra's modelled 2024 annual mean background PM2.5 concentration over the 1x1 km cells whose centres lie in the authority: an average across its area, not weighted by where people live.
Show 2 more
  • Defra's published population-weighted annual mean PM2.5 for 2024, total of anthropogenic and non-anthropogenic, which Defra advises for estimating the health burden of long-term exposure.
  • The anthropogenic part of Defra's population-weighted PM2.5 for 2024, excluding natural sources such as sea salt.

Corrections and improvements

These reviewed changes apply to what the API serves for this data. The publisher's source files are not changed; when a code correction applies, the served record retains the publisher's code as sourceAreaCode.

ChangeWhat the API servesApplies when
Opt-in canonical measure-unit presentationOn the explicit canonical request, each numeric value and any publisher-supplied interval bound is multiplied by the measure's declared scale; the response names the resulting unit and calculation.GET /v1/data/{measure-id}?units=canonical
curl "https://api.ukdataatlas.com/v1/corrections?measure=air-quality-grid-cells"
get/correctionsList reviewed corrections

Request it

Get the first page of air-quality-grid-cells for local authorities:

curl "https://api.ukdataatlas.com/v1/data/air-quality-grid-cells?period=2024&geography=localAuthority&boundaryYear=2024&limit=5"

Read the measure's full definition, including every period it's published for:

curl "https://api.ukdataatlas.com/v1/measures/air-quality-grid-cells"
get/data/{measure-id}Get observationsget/data/{measure-id}/seriesGet a time series

Source and licence

DatasetPublisherLicence
Air QualityDepartment for Environment, Food and Rural AffairsOpen Government Licence v3.0

Using this data in something you publish? Get attribution text with measure=air-quality-grid-cells returns the credit line to include.

Downloads

Download complete publisher-observation files instead of paging through the API. Each file has a stable hash and covers one measure, period set and source geography. Any reviewed served code correction is documented and retains its publisher code on the affected record. The source and licence information above applies to these files too; preserve the attribution and note any cleaning or reformatting when you redistribute one.

MeasureCoverageRecordsDownload
PCM grid cellsair-quality-grid-cellsLocal authorities · 2024 · code year 2024361JSON
Background nitrogen dioxide, area meanno2-background-meanLocal authorities · 2024 · code year 2024361JSON
Background PM10, area meanpm10-background-meanLocal authorities · 2024 · code year 2024361JSON
Background PM2.5, area meanpm25-background-meanLocal authorities · 2024 · code year 2024361JSON
Population-weighted anthropogenic PM2.5pm25-population-weighted-anthropogenicLocal authorities · 2024 · code year 2024361JSON
Population-weighted PM2.5pm25-population-weightedLocal authorities · 2024 · code year 2024361JSON