weberius/gruenflaechenkoeln

#Grünflächen Kataster Köln

Dieser Service liest das Shape-File für das Grünflächekataster von Gruenflaechenkataster Koeln Flaechentypen aus und bietet die so gewonnen Informationen als GeoJson - Information an.

Status

In Entwicklung/ lauffähig/ nicht getestet

Ziele

Es soll ein Service erstellt werden, der die von der Stadt Köln zur Verfügung gestellten Informationen bzgl. der Grünflächen als GeoJson formatiert. Desweiteren soll es möglich sein, gezielt Flächentypen abfragen zu können. Folgende Flächentypen werden unterstützt:

• 2: Kleingärten
• 4: Spielplätze
• 7: Grünanlagen
• 8: Friedhöfe
• 9: Biotopflächen
• 11: Sondergrünflächen
• 12: Forsteigene Flächen

Hierfür werden REST-Endpoints eingerichtet.

GeoTools

Zur Interpretation der Shape-Dateien wird das Projekt GeoTools verwendet (vgl. auch GeoTools Quickstart)

Projektion

Die Polygone stehen als Gauß-Krüger Koordinatensystem zur Verfügung. Für die Verwendung von GeoJson bietet sich aber die Koordination in Dezimalgrad (WGS84) umzuwandeln. Für manuelle Tests kann dies mit dem Online Koordinaten Umrechner für WGS84, UTM, CH1903, UTMREF(MGRS), Gauß-Krüger, NAC geschehen.

Vorgehensweise

Der Service geht folgendermaßen vor:

1. Download der ZIP-Datei in das temporäre Verzeichnis des verwendeten Betriebssystems
2. Entpacken der im ZIP-File vorhanden Dateien
3. Einlesen des shapes
4. ggf. Filtern nach Flächentyp
5. Umwandeln der Projektion
6. Umwandeln in GeoJson

Schnittstellen

/gruenflaechenkoeln/service/flaechen

Diese Schnittstelle liefert alle Grünflächen im GeoJson Format.

/gruenflaechenkoeln/service/flaechen?resource

Da die Berechnung auf Systemen mit geringen Resourcen länger dauern kann, liegen bereits fertig berechnete Ergebnisse im resources-Verzeichnis. Diese werden von der Applikation aus über den Parameter 'resource' erreicht.D

/gruenflaechenkoeln/service/flaechen/{id}

Diese Schnittstelle liefert ein Subset von Flächen in Abhängigkeit von der Flächen-Typ-Id. Folgende Flächen stehen zu Zeit zur Verfügung:

• 2: Kleingärten
• 4: Spielplätze
• 7: Grünanlagen
• 8: Friedhöfe
• 9: Biotopflächen
• 11: Sondergrünflächen
• 12: Forsteigene Flächen

/gruenflaechenkoeln/service/flaechen/{id}?resourcee

Da die Berechnung auf Systemen mit geringen Resourcen (z.B. Raspberry Pi) länger dauern kann, liegen bereits fertig berechnete Ergebnisse im resources-Verzeichnis. Diese werden von der Applikation aus über den Parameter 'resource' erreicht. Diese json-Dateien finden sich auch auf github und können von dort direkt bezogen werden:

• /gruenflaechenkoeln/service/flaechen/2?resource (Kleingärten)
• /gruenflaechenkoeln/service/flaechen/4?resource (Spielplätze)
• /gruenflaechenkoeln/service/flaechen/7?resource (Grünanlagen)
• /gruenflaechenkoeln/service/flaechen/8?resource (Friedhöfe)
• /gruenflaechenkoeln/service/flaechen/9?resource (Biotopflächen)
• /gruenflaechenkoeln/service/flaechen/11?resource (Sondergrünflächen)
• /gruenflaechenkoeln/service/flaechen/12?resource (Forsteigene Flächen)

Installationn

Der Service kann über git heruntergeladen werden

git clone https://github.com/codeforcologne/gruenflaechenkoeln.git

Danach muss er noch installiert werden. Dabei wird vorausgesetzt, dass auf dem Rechner mindestens JAVA 7 und das aktuelle maven installiert ist.

Wechsel ins Verzeichnis

cd gruenflaechenkoeln

Aufruf des build-Skripts:

mvn clean install

Danach befindet sich im Verzeichnis target die Datei 'gruenflaechenkoeln.war'. Diese kann z.B. in einen Tomcat Server deployed werden.

mv gruenflaechenkoeln.war $CATALINA_HOME/webapps

Alternativ kann der Service direkt von der Kommandozeile aus gestartet werden:

mvn jetty:run

Der Service kann dann z.B. unter http://localhost:8080/service/flaechen/4 aufgerufen werden.

License

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

gruenflaechenkoeln's Issues

Download file to filesystem

URL url = new URL("http://www.offenedaten-koeln.de/sites/default/files/Gruenobjekte_Koeln.zip");
File file = new File(System.getProperty("java.io.tmpdir") + "/file.zip");
FileUtils.copyURLToFile(URL, File);

vgl. How to download and save a file from Internet using Java?

Oberfläche zur Anzeige der Ergebnisse erstellen

Es soll eine einfache Oberfläche erstellt werden, auf der die unterschiedlichen Kategorien auswählbar sind:

• Kleingärten
• Spielplätze
• Grünanlagen
• Friedhöfe
• Biotopflächen
• Sondergrünflächen
• Forsteigene Flächen

Shape nur auf Anforderung laden

Zur Zeit wird mit jeder Anfrage die zip-Datei heruntergeladen, entpackt und ausgewertet. Das ist nicht notwendig, weil sich die Datenbasis nur selten ändert. Dieser Service soll so geändert werden, dass der Download nur beim ersten Aufruf stattfindet. Alle weiteren Anfragen werden dann aus dem Speicher gelesen.

Flächen berechnen

Es soll die Fläche aller Grünflächen, aber auch der jeweiligen Flächentypen ermittelt werden. Die so ermittelten Flächen können dann mit den Flächen für die Stadt Köln, der Stadtbezirke und der Stadtteile in Beziehung gesetzt werden. Die dafür verwendete Technologie ist noch nicht festgelegt.

Shape2GeoJsonTransformer schliesst polygone nicht

Der Shape2GeoJsonTransformer schliesst einige Polygone nicht. Wird das Schliessen erzwungen, stimmen die Polygone nicht mehr. bitte prüfen

Temporäres Verzeichnis

Best practice to store temporary data for a webapp

Ergebnisse in PostGreSQL/ Postgis persistieren

Es soll möglich sein, auf Wunsch die Inhalte der heruntergeladenen Shape-Dateien in einer PostGreSQL/ Postgis zu persistieren. Wenn bereits Daten in der Datenbank vorhanden sind, sollen diese zunächst gelöscht werden.