# \[APP\]\[PRO\] Outdoor AirQuality Monitor (Luftdaten) **URL:** \ **Category:** Apps\ **Tags:** app\ **Created:** [August 31, 2019, 1:05pm UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548 "2019-08-31T13:05:37Z")\ **Posts on this page:** 20\ **Page:** 1
**Author:** ![Gruijter](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/gruijter/32/1973_2.png) [@Gruijter](https://community.homey.app/u/Gruijter)\ **Post date:** [August 31, 2019, 1:05pm UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/1 "2019-08-31T13:05:37Z")
> **[Outdoor AirQuality | Homey](https://homey.app/en-us/app/com.gruijter.openaq/Outdoor-AirQuality/)** > > Outdoor Air quality monitor ![2019-09-06%20(1)](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/7/7a0fd73fe58af6750edde88ca60e3b04e0677c45.png) # Outdoor AirQuality Monitor Know the air pollution levels, in near real-time, at many locations in the world. Add one or multiple virtual outdoor air quality monitors to Homey. The information is made available free of charge by a number of services. Depending on the service and station you select, the following parameters are provided: - PM2.5 - PM10 - O3 (Ozone) - SO2 (sulfur dioxide) - NO2 (nitrogen dioxide) - CO (carbon monoxide) - BC (black carbon, only available with OpenAQ in certain countries) - Temperature (only available with Luftdaten) - Pressure (only available with Luftdaten) - Humidity (only available with Luftdaten) - Noise (only available with Luftdaten) [![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/0/0c3c8fa891ac398ce395c85f6cbdd5eba1d19896.jpeg)](https://camo.githubusercontent.com/2fc4c09fa003349d88ce775e2582c9a551709c5f/68747470733a2f2f617773312e646973636f757273652d63646e2e636f6d2f627573696e657373342f75706c6f6164732f6174686f6d2f6f726967696e616c2f32582f302f306333633866613839316163333938636533393563383566366362646435656261316431393839362e6a706567) ### Air Quality Monitor Device setup When adding a device, you can choose which service provider to use. Deciding on which service to use depends on your personal preferences, and mostly if the the service has monitoring stations nearby. Check the different coverages for your own location in the maps below. [![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/e/e92f7d5a1043622325236307dce3e2ee5ce139e0.png)](https://camo.githubusercontent.com/5a68d08277ac56dfdb401b9f6f504c917b56386c/68747470733a2f2f617773312e646973636f757273652d63646e2e636f6d2f627573696e657373342f75706c6f6164732f6174686f6d2f6f726967696e616c2f32582f652f653932663764356131303433363232333235323336333037646365336532656535636531333965302e706e67) By default the virtual monitor will be ‘installed’ at the location of your Homey. If you choose the @Homey station, Homey will always search the nearest source of data. If you select any of the other discovered stations, Homey will always use that particular station as data source. If you want to add a station anywhere else in the world, just add a local station first, and change the lat/lon in the device settings. [![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/f/f8ed8249d710fac26ef155ad7b5ddb7923991345.jpeg)](https://camo.githubusercontent.com/7f876ba3bcc4e7d2172b9b2ec533e6aa019fbfc2/68747470733a2f2f617773312e646973636f757273652d63646e2e636f6d2f627573696e657373342f75706c6f6164732f6174686f6d2f6f726967696e616c2f32582f662f663865643832343964373130666163323665663135356164376235646462373932333939313334352e6a706567) ### OpenAQ Monitor This free service provides government and research grade sources in over 60 countries. This service provides the easiest setup. Data is usually updated every hour. [![OpenAQ Coverage Map](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/c/cac597cf447eb628060eca732c9125f0439c39a7.jpeg)](https://openaq.org/#/map) ### WAQI Monitor This service provides government and research grade sources in over 90 countries. It has better coverage then OpenAQ, but it needs an API key. You can get a free API key [here](http://aqicn.org/data-platform/token/#/). [![WAQI Coverage Map](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/6/604388f07d54be99d4658ab5a9ebb988fc499d27.jpeg)](http://aqicn.org/nearest) ### Luftdaten Monitor Luftdaten is dedicated to fine dust measurement with the Citizen Science project luftdaten.info. Thousands of citizens around the world installed self-built sensors on the outside their home. The data is limited to only show PM2.5 and PM10, but has a very high update rate up to once every minute. [![LD Coverage Map](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/9/9417995ddd2875423bac02fbc35deff413005af4.jpeg)](https://maps.luftdaten.info/#2/0/0) ### Manually changing device settings After adding a new monitor device, you can change the device settings. [![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/8/8db52a776ae464a0680aa4a4fce46fc3adcba222.jpeg)](https://camo.githubusercontent.com/2db8a74e8b40d705b3b9e5c014534591f5629688/68747470733a2f2f617773312e646973636f757273652d63646e2e636f6d2f627573696e657373342f75706c6f6164732f6174686f6d2f6f726967696e616c2f32582f382f386462353261373736616534363461303638306161346134666365343666633361646362613232322e6a706567) ### Creating a flow You can trigger a flow on every change in value: [![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/0/0ea1821d42cd7b844e1b6eef0a50446dab0990b2.jpeg)](https://camo.githubusercontent.com/b97dcb1845de4eb3483aa7aea0a0f2ee68f67e32/68747470733a2f2f617773312e646973636f757273652d63646e2e636f6d2f627573696e657373342f75706c6f6164732f6174686f6d2f6f726967696e616c2f32582f302f306561313832316434326364376238343465316236656566306135303434366461623039393062322e6a706567) The measured data is available as token cards: [![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/6/6bac3300e8a9b2425d148d01d4fdc7f2873f46ae.jpeg)](https://camo.githubusercontent.com/c566d8df9472b9b70aefd422960453c1ce7e9f93/68747470733a2f2f617773312e646973636f757273652d63646e2e636f6d2f627573696e657373342f75706c6f6164732f6174686f6d2f6f726967696e616c2f32582f362f366261633333303065386139623234323564313438643031643466646337663238373366343661652e6a706567) ### Donate: If you like the app you can show your appreciation by posting it in the [forum](https://community.homey.app/t/17548). If you really like the app you can buy me a beer. [![Paypal donate](https://us1.discourse-cdn.com/flex025/uploads/athom/original/1X/59f7c705afb5f5f8fe3a9fb29a4a3f85b51c2cc1.gif)](https://www.paypal.me/gruijter) This app uses: - OpenAQ API for data retrieval. See license information here: [https://docs.openaq.org/](https://docs.openaq.org/) - Luftdaten API for data retrieval: [Sensor Community](https://luftdaten.info/en/home-en/) - World Air Quality Index (WAQI) API for data retrieval: [http://waqi.info/](http://waqi.info/) - Data provided by the world’s Environmental Protection Agencies: [World-wide Air Quality Monitoring Data Coverage](http://aqicn.org/sources/) =============================================================================== Version changelog: [changelog.txt](https://github.com/gruijter/com.gruijter.openaq/blob/master/changelog.txt) ---
**Author:** ![Gruijter](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/gruijter/32/1973_2.png) [@Gruijter](https://community.homey.app/u/Gruijter)\ **Post date:** [August 31, 2019, 1:11pm UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/2 "2019-08-31T13:11:55Z")
![opeaq_worldmap_500](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/c/cac597cf447eb628060eca732c9125f0439c39a7.jpeg) ![worldmap_waqi_500](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/6/604388f07d54be99d4658ab5a9ebb988fc499d27.jpeg) ![worldmap_ld_500](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/9/9417995ddd2875423bac02fbc35deff413005af4.jpeg) ![device%20select_300](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/e/e92f7d5a1043622325236307dce3e2ee5ce139e0.png) ![discovered_300](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/f/f8ed8249d710fac26ef155ad7b5ddb7923991345.jpeg) ![Screenshot_300](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/0/0c3c8fa891ac398ce395c85f6cbdd5eba1d19896.jpeg) ![settings_300](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/8/8db52a776ae464a0680aa4a4fce46fc3adcba222.jpeg) ![tags_300](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/6/6bac3300e8a9b2425d148d01d4fdc7f2873f46ae.jpeg) ![flows_300](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/0/0ea1821d42cd7b844e1b6eef0a50446dab0990b2.jpeg) ![insights1_500](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/2/28bdd8eaed9dac639119056a4e7fffa73ea93f30.jpeg) ![insights2_500](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/6/65569fcd85ea465fae3f84d5df7fdec5881a5dde.jpeg) ---
**Author:** ![Dennis\_H74](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/dennis_h74/32/11177_2.png) [@Dennis\_H74](https://community.homey.app/u/Dennis_H74)\ **Post date:** [August 31, 2019, 1:20pm UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/3 "2019-08-31T13:20:02Z")
Looks good … where do i get it ---
**Author:** ![Gruijter](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/gruijter/32/1973_2.png) [@Gruijter](https://community.homey.app/u/Gruijter)\ **Post date:** [August 31, 2019, 1:27pm UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/4 "2019-08-31T13:27:20Z")
working on it… Hang on 🙂 ---
**Author:** ![Dennis\_H74](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/dennis_h74/32/11177_2.png) [@Dennis\_H74](https://community.homey.app/u/Dennis_H74)\ **Post date:** [August 31, 2019, 1:29pm UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/5 "2019-08-31T13:29:56Z")
🙂 👍 ---
**Author:** ![Gruijter](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/gruijter/32/1973_2.png) [@Gruijter](https://community.homey.app/u/Gruijter)\ **Post date:** [August 31, 2019, 1:34pm UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/6 "2019-08-31T13:34:53Z")
Get it from Github, or wait for the Homey appstore release … > **[gruijter/com.gruijter.openaq](https://github.com/gruijter/com.gruijter.openaq)** > > Homey app that integrates OpenAQ.org. Contribute to gruijter/com.gruijter.openaq development by creating an account on GitHub. ---
**Author:** ![Dennis\_H74](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/dennis_h74/32/11177_2.png) [@Dennis\_H74](https://community.homey.app/u/Dennis_H74)\ **Post date:** [August 31, 2019, 3:11pm UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/7 "2019-08-31T15:11:12Z")
Not sure how that works. Will wait for the app via Homey Thanks for the work on the app 👍 ---
**Author:** ![lucasvdh](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/lucasvdh/32/54915_2.png) [@lucasvdh](https://community.homey.app/u/lucasvdh)\ **Post date:** [August 31, 2019, 11:06pm UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/8 "2019-08-31T23:06:01Z")
Nice work! I’ll definitely give the app a try. ---
**Author:** ![viix](https://avatars.discourse-cdn.com/v4/letter/v/4af34b/32.png) [@viix](https://community.homey.app/u/viix)\ **Post date:** [September 2, 2019, 2:53am UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/9 "2019-09-02T02:53:54Z")
Nice work! I’ve been using AQICN for getting my data with the HTTP app… looks like this might replace it! Edit: Darn, not available for my locale in South East Asia… I wonder how easy it is to use the API from [AQICN](https://aqicn.org/api/) ---
**Author:** ![Gruijter](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/gruijter/32/1973_2.png) [@Gruijter](https://community.homey.app/u/Gruijter)\ **Post date:** [September 2, 2019, 5:14am UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/10 "2019-09-02T05:14:14Z")
Interesting! I’ll look into it. If it provides compatible data I might be able to add it as an alternative data source. ---
**Author:** ![Gruijter](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/gruijter/32/1973_2.png) [@Gruijter](https://community.homey.app/u/Gruijter)\ **Post date:** [September 2, 2019, 11:20am UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/11 "2019-09-02T11:20:13Z")
The app is available NOW in the appstore 🥳 To everyone: Install it and let me know what you think of it. [https://apps.athom.com/app/com.gruijter.openaq](https://apps.athom.com/app/com.gruijter.openaq) ---
**Author:** ![DaneedeKruyff](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/daneedekruyff/32/964_2.png) [@DaneedeKruyff](https://community.homey.app/u/DaneedeKruyff)\ **Post date:** [September 2, 2019, 5:41pm UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/12 "2019-09-02T17:41:01Z")
Nice app Robin! Unfortunately there are no stations close to where I live so I had to change the Max. range setting. That made me wonder, how far is that station located from my position? Would it be possible to retrieve/calculate and show the distance to the selected station? Oh, and good news for [homeydash.com](https://community.homey.app/t/homeydash-com-a-homey-dashboard/13509) users, it works out of the box! ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/5/5e0b0731a37240e87bbd6957581b3445eeb9edfa.png) ---
**Author:** ![Gruijter](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/gruijter/32/1973_2.png) [@Gruijter](https://community.homey.app/u/Gruijter)\ **Post date:** [September 2, 2019, 6:36pm UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/13 "2019-09-02T18:36:40Z")
Very nice that it works in homeydash! I didn’t have time to check that yet. The distance is already there, but hidden in the app logs. I even made a clickable link that takes you to google.maps 😋 ---
**Author:** ![DaneedeKruyff](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/daneedekruyff/32/964_2.png) [@DaneedeKruyff](https://community.homey.app/u/DaneedeKruyff)\ **Post date:** [September 2, 2019, 6:45pm UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/14 "2019-09-02T18:45:43Z")
Found it `distance: 32674.406719985833` guess it’s in meters, pretty accurate 😉 Maybe worth mentioning in a FAQ in the first or second post. (And I wouldn’t mind seeing it in a field on the settings pages.) ---
**Author:** ![Gruijter](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/gruijter/32/1973_2.png) [@Gruijter](https://community.homey.app/u/Gruijter)\ **Post date:** [September 2, 2019, 6:58pm UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/15 "2019-09-02T18:58:31Z")
Thx 4 the feedback! That helps me make software design decissions for the next release. 😘 The distance is actually dynamic, and can be different between polls and per parameter. For each parameter I take the closest valid value. Also this strategy is something I am still evaluating. Depending on what I decide on the long term I might display the station and/or distance e.g. in the device settings. ---
**Author:** ![Satoer](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/satoer/32/38113_2.png) [@Satoer](https://community.homey.app/u/Satoer)\ **Post date:** [September 2, 2019, 7:01pm UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/16 "2019-09-02T19:01:57Z")
Although I find this very interesting, I wonder what the use case is for this information. What would you control with this data available? Or if it’s just information you want to know (Show it on a display or something, and don’t want to control anything with it): Why would you want to know this? Would you think “Wow, there’s a lot of O3 today, I stay inside”? Would this information make your life more comfortable? ---
**Author:** ![DaneedeKruyff](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/daneedekruyff/32/964_2.png) [@DaneedeKruyff](https://community.homey.app/u/DaneedeKruyff)\ **Post date:** [September 2, 2019, 7:08pm UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/17 "2019-09-02T19:08:39Z")
Imagine living here ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/b/b997011e5b6b57fefa9b8a3dda00cba9a1cb1a80.jpeg) A quick rise in some value’s are worth being notified of. But yeah it’s also a case of ‘Just because we can’ ---
**Author:** ![Gruijter](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/gruijter/32/1973_2.png) [@Gruijter](https://community.homey.app/u/Gruijter)\ **Post date:** [September 2, 2019, 7:13pm UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/18 "2019-09-02T19:13:52Z")
Exactly! And I have my ventilation system (WTW) shutting down now on high levels of pollution. That is a real useful use case I think🤗 ---
**Author:** ![viix](https://avatars.discourse-cdn.com/v4/letter/v/4af34b/32.png) [@viix](https://community.homey.app/u/viix)\ **Post date:** [September 3, 2019, 3:57am UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/19 "2019-09-03T03:57:56Z")
Here in Singapore, the transboundary haze can get quite bad with forest fires raging in the hotter months in Indonesia and Malaysia. The information gives me early warning to run the air purifier on full blast and close all the windows so I don’t wake up in the middle of the night choking especially with a little one in the home. ---
**Author:** ![Gruijter](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/gruijter/32/1973_2.png) [@Gruijter](https://community.homey.app/u/Gruijter)\ **Post date:** [September 3, 2019, 9:25am UTC](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548/20 "2019-09-03T09:25:43Z")
My API key from AQICN got activated this morning. I’m now rewriting the app to see if I can add them. They provide the locations and data in quite a different way, so need a lot of time to find a solution. But I think it is worth it since they have many more worldwide locations available! > **[Real-time Air Quality Index for more than 60 countries in the world](http://aqicn.org/here/)** > > How polluted is the air today? Check out the real-time air pollution map, for more than 60 countries. [Next page](https://community.homey.app/t/app-pro-outdoor-airquality-monitor-luftdaten/17548.md?page=2)