luftdatenpumpe 0.4.3

Live Data

• Feinstaub Verlauf Berlin

• Feinstaub Karte Deutschland

List of stations

• LDI Stations #1 » Select by name, country and state

• LDI Stations #2 » Cascaded » Stations

• LDI Stations #3 » Cascaded » Measurements

• LDI Stations #4 » Select by sensor type

Overview

# List stations
luftdatenpumpe stations --station=28,297 --reverse-geocode

# Write list of stations and metadata to PostgreSQL database
luftdatenpumpe stations --station=28,1071 --reverse-geocode --target=postgresql:///weatherbase

# Forward readings to MQTT
luftdatenpumpe readings --station=28,1071 --target=mqtt://mqtt.example.org/luftdaten.info

Details

$ luftdatenpumpe --help
    Usage:
      luftdatenpumpe stations [options] [--target=<target>]...
      luftdatenpumpe readings [options] [--target=<target>]...
      luftdatenpumpe --version
      luftdatenpumpe (-h | --help)

    Options:
      --station=<stations>          Filter data by given location ids, comma-separated.
      --sensor=<sensors>            Filter data by given sensor ids, comma-separated.
      --reverse-geocode             Compute geographical address using the Nominatim reverse geocoder and add to MQTT message
      --target=<target>             Data output target
      --progress                    Show progress bar
      --version                     Show version information
      --dry-run                     Run data acquisition and postprocessing but skip publishing to MQTT bus
      --debug                       Enable debug messages
      -h --help                     Show this screen

    Station list examples:

      # Display metadata for given stations in JSON format
      luftdatenpumpe stations --station=28,1071 --reverse-geocode

      # Display metadata for given sensors in JSON format
      luftdatenpumpe stations --sensor=657,2130 --reverse-geocode

      # Display list of stations in JSON format, suitable for integrating with Grafana
      luftdatenpumpe stations --station=28,1071 --reverse-geocode --target=json.grafana+stream://sys.stdout

      # Write list of stations and metadata to PostgreSQL database, also display on STDERR
      luftdatenpumpe stations --station=28,1071 --reverse-geocode --target=postgresql:///weatherbase --target=json+stream://sys.stderr

    Data examples:

      # Publish data to topic "luftdaten.info" at MQTT broker "mqtt.example.org"
      luftdatenpumpe readings --station=28,1071 --target=json+stream://sys.stderr --target=mqtt://mqtt.example.org/luftdaten.info

      # MQTT publishing, with authentication
      luftdatenpumpe readings --station=28,1071 --target=mqtt://username:password@mqtt.example.org/luftdaten.info

Prerequisites

Debian packages:

apt install postgis redis-server redis-tools

createuser --no-createdb --pwprompt hiveeyes
createdb --owner hiveeyes weatherbase

su - postgres
psql

postgres=# \c weatherbase
weatherbase=# CREATE ROLE readonly WITH LOGIN PASSWORD 'XXX';
weatherbase=# GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO readonly;
weatherbase=# GRANT SELECT ON ALL TABLES IN SCHEMA public TO readonly;

Python module

# Not published yet, please install from repository
pip install luftdatenpumpe

Upstream luftdaten.info

• http://luftdaten.info/

• http://archive.luftdaten.info/

• http://deutschland.maps.luftdaten.info/

Standing on the shoulders of giants

• https://github.com/vinsci/geohash/

• https://github.com/openstreetmap/Nominatim

• https://github.com/influxdata/influxdb

• https://github.com/grafana/grafana

• https://grafana.com/plugins/grafana-worldmap-panel

Development

• opendata-stuttgart/sensors-software: Support for InfluxDB and MQTT as backend.

• https://getkotori.org/docs/applications/luftdaten.info/

• https://community.hiveeyes.org/t/datenmischwerk/702

• https://community.hiveeyes.org/t/environmental-metadata-library/1190

• https://community.hiveeyes.org/t/erneuerung-der-luftdatenpumpe/1199

Icons and pictograms

• Water Pump Free Icon from Icon Fonts is licensed by CC BY 3.0.