About the project
Mr. Duck’s Air Quality is a clean, fast way to explore air quality by continent, country, and city. The focus is clarity for everyday readers: short takeaways, readable parameter cards, and compact visualizations.
Goals
- Explain what air-quality numbers mean in practice.
- Show recent values at city level in a clean layout.
- Offer structured navigation: continents → countries → cities.
Design principles
Readable typography, minimal motion, and accessible color contrast. Pages are lightweight and mobile-friendly for quick browsing anywhere.
How it works
- Fetch recent measurements via the OpenAQ platform.
- Enrich with resolved city/state names and ISO country codes.
- Resolve continents from country codes (fallback to “Unknown” when missing).
- Generate pages for continents, countries, and cities.
- Visualize with simple parameter cards and a compact bar chart; add a concise AI summary.
Availability and granularity vary by region and network. Some locations have dense monitoring; others have sparse or intermittent stations.
Mr. Duck’s score (quick explainer)
City pages include a friendly “Mr. Duck’s Air Quality Score” — a concise verdict based on the most recent parameters available. It is descriptive, not medical guidance. Always consult local health advisories when air quality is poor.
- Inputs: primarily PM2.5/PM10, plus gases when available.
- Bands: aligned to commonly used thresholds (e.g., WHO/EPA style) for Good / Moderate / Unhealthy categories.
- Display: a compact verdict, parameter cards, and a small bar chart.
Thresholds may be refined as coverage and parameters expand.
About the data
Data on this site comes from the OpenAQ platform, which aggregates measurements from government and community monitoring networks worldwide. We transform those feeds into pages organized by continent, country, and city.
What we collect
- Station name (location)
- Parameter (PM2.5, PM10, O3, NO2, SO2, CO, etc.)
- Latest value and unit
- Resolved city / state / country
- ISO country code and inferred continent
Coverage & limitations
- Uneven station density. Some regions have sparse or intermittent monitors.
- Different instruments & methods. Comparability across networks may vary.
- Point-in-time. Pages show recent values rather than long-term averages.
- Geocoding caveats. City/state resolution can occasionally mismatch.
Glossary of parameters
| Parameter | What it is | Typical unit |
|---|---|---|
| PM2.5 | Fine particulate matter ≤2.5 μm (penetrates deep into lungs) | µg/m³ |
| PM10 | Coarser particulate matter ≤10 μm | µg/m³ |
| PM1 | Ultrafine particulate matter ≤1 μm | µg/m³ |
| O3 | Surface ozone, an irritant gas formed by reactions in sunlight | ppm or ppb |
| NO2 | Nitrogen dioxide, a traffic/combustion pollutant | ppm or ppb |
| SO2 | Sulfur dioxide, often from fuel combustion | ppm or ppb |
| CO | Carbon monoxide from incomplete combustion | ppm |
Units are taken as reported by the source network via OpenAQ.
Licensing & attribution
OpenAQ content is generally distributed under the CC BY 4.0 license unless noted otherwise. Please attribute “OpenAQ” when reusing the underlying measurements.
Site text and UI are © Mr. Duck’s Air Quality. Where we summarize or transform the data, we link back to the source platform.
Contact & feedback
Questions, corrections, or partnership ideas? Email us at info@mrducksaqscore.com.