home-assistant.io/source/_components/sensor.luftdaten.markdown
Christoph Gerneth 7ac437f5ac updated documentation: show on map (#4680)
* updated documentation: show on map

* Fix type

* changed a copy-paste error
2018-03-06 22:54:35 +01:00

2.5 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release, ha_iot_class
layout title description date sidebar comments sharing footer logo ha_category ha_release ha_iot_class
page Luftdaten Sensor Instructions how to setup Luftdaten sensor in Home Assistant. 2017-11-01 00:00 true false true true luftdaten.png Health 0.57 Cloud Polling

The luftdaten sensor platform will query the open data API of luftdaten.info to monitor air quality and other weather data from a specific (self build) sensor station.

  • To get the ID of a particle sensor you need to select it on the Feinstaub map and find it in the sidebar (Column "Sensor ID").
  • To get the ID of a temperature/humidity sensor you need to find it on the map hosted on Madavi.

To enable this sensor, add the following lines to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  - platform: luftdaten
    sensorid: 3123
    monitored_conditions:
      - P1
      - P2
  - platform: luftdaten
    sensorid: 155
    monitored_conditions:
      - temperature
      - humidity

{% configuration %} sensorid: description: The ID of the sensor. required: true type: string name: description: Name of the sensor to use in the frontend. required: false default: Luftdaten Sensor type: string monitored_conditions: description: A list of conditions you want to monitor. required: true type: list keys: P1: description: Show the particle sensors (particles 10 microns and below). P2: description: Show the particle sensors (particles 2.5 microns and below). temperature: description: Display the temperature from the sensor. humidity: description: Display the humidity from the sensor. pressure: description: Display the pressure from the sensor. show_on_map: description: Option to show the position of the sensor on the map. required: optional default: false type: boolean {% endconfiguration %}

If you set `show_on_map` to `True` then the location attributes are named `latitude` and `longitude`. The default name of the location attributes is `lat` and `long` to avoid showing them on the map.

Not all sensors provide all conditions. Also, it's possible that the sensor values are not available all the time. To check what a sensor is publishing use curl:

$ curl https://api.luftdaten.info/v1/sensor/[sensorid]/