From b267b7848b86c63cb6a8ce6cbed13b2d6841380b Mon Sep 17 00:00:00 2001 From: Heine Furubotten Date: Sun, 27 Jan 2019 19:29:47 +0100 Subject: [PATCH] Docs for nilu air_quality platform (#7993) * Docs for nilu air_pollution platform * Updated with new location of pollution index * Fixed stations to be plural * platform rename from air_pollutants to air_quality Managed to remove a commit from maintainer. Edits should be within this renaming commit. * Update 'ha_release' --- source/_components/air_quality.nilu.markdown | 164 +++++++++++++++++++ source/images/supported_brands/nilu_logo.png | Bin 0 -> 6555 bytes 2 files changed, 164 insertions(+) create mode 100644 source/_components/air_quality.nilu.markdown create mode 100644 source/images/supported_brands/nilu_logo.png diff --git a/source/_components/air_quality.nilu.markdown b/source/_components/air_quality.nilu.markdown new file mode 100644 index 00000000000..458429601a4 --- /dev/null +++ b/source/_components/air_quality.nilu.markdown @@ -0,0 +1,164 @@ +--- +layout: page +title: "Norwegian Institute for Air Research" +description: "Instructions on how to integrate air pollution data from NILU within Home Assistant." +date: 2018-12-30 18:45 +sidebar: true +comments: false +sharing: true +footer: true +logo: nilu_logo.png +ha_category: Health +ha_iot_class: "Cloud Polling" +ha_release: 0.87 +--- + +The `nilu` air quality platform shows measurements of current air quality from NILU (Norsk Institutt for luftforskning/Norwegian Institute for Air Research) sensor stations within Norway. Makes data from the open API at [luftkvalitet.info](http://luftkvalitet.info/) and [nilu.no](https://nilu.no/) available in Home Assistant. + +## {% linkable_title Configuration %} + +To enable this platform, add the following lines to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +air_quality: + - platform: nilu +``` + +{% configuration %} + latitude: + description: Manually specify latitude. By default, the value will be taken from the Home Assistant configuration. + required: false + type: number + default: Provided by Home Assistant configuration. + longitude: + description: Manually specify longitude. By default, the value will be taken from the Home Assistant configuration. + required: false + type: number + default: Provided by Home Assistant configuration. + name: + description: Name of the sensor to use in the frontend. + required: false + default: NILU + type: string + area: + description: Name of an area to get sensor stations from. See available areas below. + required: exclusive + type: string + stations: + description: Name of a specific station to get measurements from. + required: exclusive + type: string + show_on_map: + description: Option to show the position of the sensor station on the map. + required: false + default: false + type: boolean +{% endconfiguration %} + +## {% linkable_title Health risk index explainations %} + +Under the attributes from a NILU station, there will be a `nilu pollution index`. This indicates how polluted the air is in the area around the sensor station. Following is a longer explanation of what the indexes mean. + +### {% linkable_title Low %} + +Low or no health risk linked to measured air pollution. Outdoor activites are recommended. + +### {% linkable_title Moderate %} + +Health effects may occur in some asthmatics and people with other respiratory diseases, as well as serious cardiovascular diseases. Outdoor activity can be recommended for the vast majority, but some should consider their activity in areas with high traffic or high emissions. + +### {% linkable_title High %} + +Health effects may occur in asthmatics and people with other respiratory diseases, as well as serious cardiovascular disease. Children with respiratory distress (asthma, bronchitis) and adults with severe cardiac or respiratory distress should reduce outdoor activity and not stay in the most polluted areas. + +### {% linkable_title Extremely high %} + +Sensitive groups in the population can have health effects. Respiratory irritation and discomfort may occur in healthy subjects. People with heart or respiratory distress should reduce outdoor activity and not stay in the most polluted areas. + +Source: [Explainations in Norwegian](http://www.luftkvalitet.info/home/Varslingsklasser.aspx) + +## {% linkable_title Available areas %} + +The `area` configuration is restricted to the areas NILU has defined. Here is the list of available areas: + +- `Bergen` +- `Birkenes` +- `Bodø` +- `Brumunddal` +- `Bærum` +- `Drammen` +- `Elverum` +- `Fredrikstad` +- `Gjøvik` +- `Grenland` +- `Halden` +- `Hamar` +- `Harstad` +- `Hurdal` +- `Karasjok` +- `Kristiansand` +- `Kårvatn` +- `Lillehammer` +- `Lillesand` +- `Lillestrøm` +- `Lørenskog` +- `Mo i Rana` +- `Moss` +- `Narvik` +- `Oslo` +- `Prestebakke` +- `Sandve` +- `Sarpsborg` +- `Stavanger` +- `Sør-Varanger` +- `Tromsø` +- `Trondheim` +- `Tustervatn` +- `Zeppelinfjellet` +- `Ålesund` + +## {% linkable_title Configuration examples %} + +Example of adding health risk monitoring from sensor stations around the Home Assistant location. + +```yaml +# Example configuration.yaml entry +# Adds all sensor stations within 20km. +air_quality: + - platform: nilu +``` + +Example where the sensors are also added to the map. + +```yaml +# Example configuration.yaml entry +# Adds all sensor stations within 20km. +# Additionally adds the sensors to the map. +air_quality: + - platform: nilu + show_on_map: True +``` + +Example of a specific station. + +```yaml +# Example configuration.yaml entry +# Monitors stations 'Alnabru' +air_quality: + - platform: nilu + stations: + - Alnabru +``` + +Example of getting stations from a specified area, giving the sensors a custom name. + +```yaml +# Example configuration.yaml entry +# Stations from specific area, 'Bergen' +# Custom name for the sensors. +air_quality: + - platform: nilu + area: Bergen + name: Forurensing Bergen +``` diff --git a/source/images/supported_brands/nilu_logo.png b/source/images/supported_brands/nilu_logo.png new file mode 100644 index 0000000000000000000000000000000000000000..de170a7ef932a11cb5678983518e344eae1b8d80 GIT binary patch literal 6555 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