Luftdaten Sensor


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 Variables

sensorid

(string)(Required)The ID of the sensor.

name

(string)(Optional)Name of the sensor to use in the frontend.

Default value: Luftdaten Sensor

monitored_conditions

(list)(Required)A list of conditions you want to monitor.

P1

Show the particle sensors (particles 10 microns and below).

P2

Show the particle sensors (particles 2.5 microns and below).

temperature

Display the temperature from the sensor.

humidity

Display the humidity from the sensor.

pressure

Display the pressure from the sensor.

show_on_map

(boolean)(Optional)Option to show the position of the sensor on the map.

Default value: false

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]/