Skip to content

Direct answer about category mismatches

Why can the OpenWeather category and pollutant component disagree?

The OpenWeather category and AirAgora’s strongest pollutant component can disagree because they are separate pieces of information. OpenWeather’s official air-pollution value from 1 to 5 remains the displayed provider result. AirAgora independently maps six supported pollutant concentrations through OpenWeather’s documented bands to compare forecast hours and explain the main pollutant. If the two ordinal contexts differ, AirAgora preserves both and records a mismatch; it does not rewrite the provider category or create a new AQI.

Short answer: preserve both fields instead of forcing a match

OpenWeather returns an official air-pollution value from 1 to 5 together with modeled concentrations for pollutants such as PM2.5, PM10, ozone, nitrogen dioxide, sulphur dioxide, and carbon monoxide. AirAgora displays that provider value and category as received.

Separately, AirAgora applies the concentration bands documented by OpenWeather to each supported pollutant. This derived component context is used for consistent window ranking and main-pollutant explanation. When its strongest ordinal differs from the provider category, the honest result is to keep both, label their roles, and record the difference.

The provider category and component context do different jobs

The official OpenWeather 1–5 value is the provider’s combined communication result. It remains the display truth and is never relabeled as U.S. AQI, European AQI, a local national index, or an AirAgora regulatory index.

The component calculation is AirAgora’s deterministic interpretation layer. It converts each supported pollutant through its own documented concentration bands, producing comparable dimensionless severity for ranking complete two-hour windows. It is not shown as a replacement index and cannot be compared numerically with a regulatory AQI.

A mismatch does not prove that either value is wrong

A recorded mismatch says only that the official provider category and the strongest independently derived component band do not share the same ordinal for that point. The public fields alone do not establish why the difference occurred, so AirAgora does not invent an explanation, silently change the category, or discard an otherwise usable forecast hour.

The mismatch also does not identify a pollution source or a street-level condition. The inputs are modeled values for a provider location and valid time. A nearby monitor, road, building, terrain feature, or rapidly changing plume can differ from the modeled grid.

How to read a result when the fields differ

Use the OpenWeather 1–5 category for the named provider result. Use the main pollutant and component detail to understand which supported concentration band most influenced AirAgora’s comparison. Then check the source timestamp, valid local hours, completeness, modeled-data label, and any stale or caution notice.

Do not choose the more reassuring field or treat the lower ordinal as a safety clearance. WHO guidance supports avoiding a universal safe threshold for air pollution. AirAgora is an informational planning product, not medical, diagnostic, emergency, monitoring, or universal-safety guidance.

  • Keep the official OpenWeather 1–5 category unchanged.
  • Read component severity as explanation and ranking context only.
  • Do not convert either field into a U.S., European, or national AQI.
  • Check timestamps, completeness, and stale status with the values.
  • Use official local information for urgent or severe conditions.

Direct answers

Frequently asked questions

Does a mismatch mean OpenWeather is wrong?

No. It means the provider category and AirAgora’s independently derived strongest component ordinal differ. The available fields alone do not establish why.

Does AirAgora replace the OpenWeather category?

No. The official OpenWeather air-pollution value from 1 to 5 remains the displayed provider result and is preserved even when a mismatch is recorded.

Is the derived component severity a new AQI?

No. It is internal dimensionless context used to rank complete windows and identify a main pollutant, not a regulatory or provider AQI.

Which pollutants are included in the component comparison?

PM2.5, PM10, ozone, nitrogen dioxide, sulphur dioxide, and carbon monoxide use OpenWeather’s documented concentration bands. AirAgora does not invent bands for nitrogen monoxide or ammonia.

Can a mismatch identify the local pollution source?

No. A category or component can describe modeled pollutant context, but it cannot prove traffic, industry, wildfire, dust, weather, or another local cause.

Does the lower of the two fields mean the time is safe?

No. Neither field is a universal-safety conclusion. Read the full modeled result and cautions, and follow official local guidance for urgent or severe conditions.

Evidence register

Sources and further reading

The links below identify the primary references used on this page. Selection, summary, and presentation are AirAgora modifications.

  1. 1.OpenWeather Air Pollution API documentation
  2. 2.WHO global air quality guidelines (2021)

Keep exploring

AirAgora provides informational planning guidance, not medical advice. Local conditions can differ from modeled forecasts; follow official guidance during severe events.