Created At

Jan 08, 2022

Last Update

Nov 14, 2022

Platforms

HC 3 Lite, Z-box Hub, Yubii Home Pro, Yubii Home, Venture WISE, HC 3

Views

1990

Download

148

Type Quick App

The QuickApp Air Quality OpenWeatherMap provides the current and forecast measurements for your location on Air Quality. 


Besides basic Air Quality Index the QuickApp provides also data about polluting gases such as Carbon monoxide (CO), Nitrogen monoxide (NO), Nitrogen dioxide (NO2), Ozone (O3), Sulphur dioxide (SO2), Ammonia (NH3), and particulates (PM2.5 and PM10). 


This QuickApp has Child Devices for Carbon monoxide (CO), Nitrogen monoxide (NO), Nitrogen dioxide (NO2), Ozone (O3), Sulphur dioxide (SO2), Ammonia (NH3), PM2.5 and PM10 for current measurement. 


This QuickApp has also Child Devices for Air Quality Index, Carbon monoxide (CO), Nitrogen monoxide (NO), Nitrogen dioxide (NO2), Ozone (O3), Sulphur dioxide (SO2), Ammonia (NH3), PM2.5 and PM10 for forecast measurement. 

 

 

Air_Quality_OWM-2.thumb.png.ceec3133b82dcd1f61c2dea717a8dbe7.png

 

This QuickApp has Child Devices for Carbon monoxide (CO), Nitrogen monoxide (NO), Nitrogen dioxide (NO2), Ozone (O3), Sulphur dioxide (SO2), Ammonia (NH3), PM2.5 and PM10. 

 

 

Air_Quality_OWM-1.thumb.png.b3013c2c2856373c66e58a9940499395.png


Common Air Quality Index (CAQI)
The Common Air Quality Index (CAQI) is an air quality index used in Europe since 2006. In November 2017, the European Environment Agency announced the European Air Quality Index (EAQI) and started encouraging its use on websites and for other ways of informing the public about air quality. 


As of 2012, the EU-supported project CiteairII argued that the CAQI had been evaluated on a "large set" of data, and described the CAQI's motivation and definition. CiteairII stated that having an air quality index that would be easy to present to the general public was a major motivation, leaving aside the more complex question of a health-based index, which would require, for example, effects of combined levels of different pollutants. The main aim of the CAQI was to have an index that would encourage wide comparison across the EU, without replacing local indices. CiteairII stated that the "main goal of the CAQI is not to warn people for possible adverse health effects of poor air quality but to attract their attention to urban air pollution and its main source (traffic) and help them decrease their exposure."


The CAQI is a number on a scale from 1 to 100, where a low value means good air quality and a high value means bad air quality. The index is defined in both hourly and daily versions, and separately near roads (a "roadside" or "traffic" index) or away from roads (a "background" index). As of 2012, the CAQI had two mandatory components for the roadside index, NO2 and PM10, and three mandatory components for the background index, NO2, PM10 and O3. It also included optional pollutants PM2.5, CO and SO2. A "sub-index" is calculated for each of the mandatory (and optional if available) components. The CAQI is defined as the sub-index that represents the worst quality among those components.

 

 

Here is a description of Air Quality index levels Pollutant concentration in μg/m3: 
          Index   NO2       PM10     O3      PM25 (optional)
Good        1    0-50      0-25     0-60    0-15
Fair        2   50-100    25-50    60-120   15-30
Moderate    3   100-200   50-90    120-180  30-55
Poor        4   200-400   90-180   180-240  55-110
Very Poor   5    >400      >180     >240     >110

 

See more on CAQI: https://en.wikipedia.org/wiki/Air_quality_index

 

Version 1.1 (10th November 2022)

  • Added extra check for partly empty response ("coord" not empty but "list" is empty)
  • Added extra message to the labels and de log text if there is no response
  • Warning added in case the "forecast measurements" are not available

IMPORTANT

Variables (mandatory): 

  • apiKey = Get your free API key from https://home.openweathermap.org
  • latitude = latitude of your location (Default is the latitude of your HC3)
  • longitude = longitude of your location (Default is the longitude of your HC3)
  • interval = [number] in seconds time to get the data from the API
  • timeout = [number] in seconds for http timeout
  • debugLevel = Number (1=some, 2=few, 3=all, 4=simulation mode) (default = 1)

openweather.png.8bc2df0570a90ba4b9205fbe6284b960.png

 

Download the QuickApp here (download the file and un-zip):

https://github.com/GitHub4Eddy/air_quality_openweathermap/archive/refs/tags/air_quality_owm-1.zip

 

How to install: 

  1. Open the Configuration Interface
  2. Go to Settings > Devices
  3. Click  +
  4. Choose Other Device
  5. Choose Upload File
  6. Choose file from your computer with .fqa

5 Comments,  Want to add comment please login
04801fd12b48c36cbcdf5af0b140e42d

A new version is available which handle empty and partly empty responses better

04801fd12b48c36cbcdf5af0b140e42d

For this QuickApp you (only) need an API key from https://home.openweathermap.org/users/sign_up

358e0b8691a1c1a1d0b9b98aa6fd8ace

ok, let's move to the Fibaro forum (yep, the link is working well with my API string, as I wrote in my message, the "both services" are those you have in your manual - openweather and agrominitoring)

04801fd12b48c36cbcdf5af0b140e42d

Hi Artur, Thanks for using the quickapp. "both services", I think you also run an other quickapp with OpenWeatherMap for weather data. You can indeed use the same account. Let first try if your API key is working. If you use this link in your browser, you can check if you get an answer. Change the apikey at the end of the url with your key from your account. http://api.openweathermap.org/data/2.5/air_pollution?lat=50&lon=50&appid=apikey You should see something like: {"coord":{"lon":51.1266,"lat":16.9656},"list":[{"main":{"aqi":4},"components":{"co":206.95,"no":0.02,"no2":0.07,"o3":107.29,"so2":1.01,"pm2_5":21,"pm10":56.05,"nh3":0},"dt":1645095600}]} This Marketplace is a bit difficult to message, could you use the Fibaro forum? If the above url works, we should look at some loggings.

358e0b8691a1c1a1d0b9b98aa6fd8ace

trying to set it up, but looks like something fails... here are the steps I did (working on your .fqa): 1) created an account on both services (looks like this is an mistake, because both are the same services, just different interface.. but OK, I have both) 2) copy/pasted the API string from OpenWeather into the "Air Quality OWM" in a form suggested by OpenWeather: api.openweathermap.org/data/2.5/weather?q=Wroclaw,pl&APPID=(and here is my API string) 3) updated LON and LAT for my location (Wroclaw): i.e. LON: 51.1266 and LAT: 16.9656 (with dots, precisely taken from google maps) in "Air Quality OWM" 4) saved, of course.. and I still see "last updated 31.10.2021 13:00" in my devices... I tried also clean API string only (without the link) - no changes... When I paste the OpenWeather link with API string into the browser, I can see the location properly set up, current weather (temp, wind, clouds), but in this view I can not see the air quality, so not necessarily what I'm looking for. Any chance for help?

Load more comments
© 2024. Nice-Polska Sp. z o.o.Privacy policyTerms & ConditionsFeedback