#Feinstaubwerte

Entwicklungsstand

Dieser Service befinded sich in Entwicklung.

Schnittstellen

/feinstaubwerte/service/sensor/{id}

nicht implementiert

/feinstaubwerte/service/location/{lat}/{lng}

Mit dieser Schnittstelle wird der letzte erfasste Messwert der nächsten Messstation im Umkreis von 500 m zur lat-lng Position zur Verfügung gestellt. Die Schnittstelle antwortet mit folgender Datenstruktur:

{
  "locationid":110,
  "geojson":"{\"type\":\"Point\",\"coordinates\":[7,50.961]}",
  "distance":222.495021748,
  "datum":"Feb 13, 2017 3:58:43 AM",
  "temperature":1.4,
  "humidity":91.3,
  "p1":89.9,
  "p2":33.25
}

Feld	Beschreibung
locationid	id der location an der gemessen wurde
geojson	die Position der Messung im geojson Format
distance	Entfernung der Messstation zur abgefragten Position in metern
datum	Datum der Messung in GMT
temperature	Temperatur in Grad Celsius
humidity	Luftfeuchte
p1	PM 10 Wert
p2	PM 2.5 Wert

Beispiel: /feinstaubwerte/service/sensordata/7.0/50.959

/feinstaubwerte/service/load

Service zum Einlesen der Daten. Der Vorgang kann jederzeit wiederholt werden. Die Daten werden aus dem Filesystem gelesen. Gemäß [https://de.wikipedia.org/wiki/Filesystem_Hierarchy_Standard](Filesystem Hierarchy Standard) werden die Daten aus dem Verzeichnis /var/cache/feinstaubwerte gelesen. Dabei ist das System auf dem die Anwendung installiert ist, dafür zuständig die Daten dort zur Verfügung zu stehen. Dies ist z.B. über curl möglich:

curl https://www.madavi.de/sensor/feinstaub-map-sds/data.json > /var/cache/feinstaubwerte/feinstaubwerte-$(date +%Y%m%d_%H%M%S).json

Durch Ausführen von load werden alle im Verzeichnis '/var/cache/feinstaubwerte' enthaltenen Dateien gelesen, in der Datenbank gespeichert und danach gelöscht. Die wiederholte Ausführung von load führt nicht zu einer zusätzlichen Belastung von www.madavi.de. In der Datenbank bereits vorhandene Daten werden nicht gelöscht.

Datenbank

Postgres und Postgis installieren

sudo apt-get install -y postgresql postgresql-contrib

sudo apt-get install -y postgis postgresql-9.3-postgis-2.1

DB User auf Postgres einrichten

sudo -u postgres createuser -P feinstaubwerte

Datenbank meinsensor anlegen

sudo -u postgres createdb -O feinstaubwerte feinstaubwerte

Postgis topology

sudo -u postgres psql -c "CREATE EXTENSION postgis; CREATE EXTENSION postgis_topology;" feinstaubwerte

DB-Tabellen initial einrichten

psql -h localhost -U feinstaubwerte -d feinstaubwerte -a -f src/main/sql/feinstaubwerte.init.sql

Verbindungsparameter

Die Datenbankverbindungsparameter werden per JNDI zur Verfügung gestellt. Dies bedeutet, dass sie im Container definiert sein müssen. Für den Online-Betrieb mit Tomcat sind folgende Parameter zu setzen:

context.xml

<Context>
    <ResourceLink 
         name="jdbc/feinstaubwerte" 
         global="jdbc/feinstaubwerte"
         type="javax.sql.DataSource" />
</Context>

server.xml

<GlobalNamingResources>
    <Resource 
        name="jdbc/feinstaubwerte"
        auth="Container"
        driverClassName="org.postgresql.Driver"
        maxTotal="25" 
        maxIdle="10"
        username="username"
        password="password"
        type="javax.sql.DataSource"
        url="jdbc:postgresql://localhost:5432/feinstaubwerte"
        validationQuery="select 1"/>

Zu Testzwecken muss die Datei src/test/resources/jndi.properties.template in jndi.properties umbenannt und die Verbindungsparameter angepasst werden.

Installation

git clone
mvn clean install
jetty run

Dependencies

tomcat

Die Webapplikation benötigt folgende PostGresSQL - Bibliotheken:

postgis-jdbc-2.1.7.2.jar
postgresql-9.1-901-1.jdbc4.jar
postgresql-9.3-1104-jdbc41.jar

Für Entwicklungszwecke werden die Bibliotheken über den build-Mechanismus gezogen. Für die Ausführung auf dem Tomcat müssen sie im tomcat/lib Verzeichnis liegen und dürfen nicht mit der Webapplikation ausgeliefert werden. Aus diesem Grund wird in den dependencies der scope 'provided' verwendet:

	<dependency>
		<groupId>org.postgresql</groupId>
		<artifactId>postgresql</artifactId>
		<version>9.3-1104-jdbc41</version>
		<scope>provided</scope>
	</dependency>
	<dependency>
		<groupId>net.postgis</groupId>
		<artifactId>postgis-jdbc</artifactId>
		<version>2.1.7.2</version>
		<scope>provided</scope>
	</dependency>

Die Bibliotheken können von PostGres JDBC Driver bezogen werden und müssen manuell in das Verzeichnis <tomcat-home>/lib kopiert werden.

Anmerkung: Die Bibliothek 'postgresql-9.1-901-1.jdbc4.jar' wird über den Maven Mechanismus gezogen.

License

Dieses Werk ist lizenziert unter einer Creative Commons Namensnennung - Weitergabe unter gleichen Bedingungen 4.0 International Lizenz.

weberius / feinstaubwerte