Getting Started

Learnings

VORBEREITUNGEN 

In diesem Beispiel wollen wir die Grundlagen der deeeper.API kennenlernen, indem wir die Gebäude innerhalb einer vorgegebenen Bounding-Box extrahieren. Dieses Tutorial nutzt Python 3.9. In unserem öffentlich verfügbaren Gitlab-Repository finden sich auch Beispiele in Bash. 

Die deeeper.API nutzt den OGC-API Standard, um möglichst kompatibel mit gängigen GIS-Systemen zu sein. Eine tiefgreifende, technische Dokumentation der API ist hier einsehbar.

Wir definieren zunächst alle Imports sowie die Basis-URLs von deeeper.Kassandra. Mit OWSLib steht ein Python-Paket zur Verfügung, durch das sich die dem OGC Standard entsprechenden APIs leicht ansprechen lassen. Der API Key ist nur zu Demozwecken und auf Abfragen des Gebiets der Städteregion Aachen beschränkt.

Die Bounding-Box wird zu Beginn des Koordinatenreferenzsystems EPSG:4326 übergeben. Um handlich verschiedene Bounding-Boxen zu erstellen, empfiehlt sich die Webseite bboxfinder.com.

VERBINDUNG HERSTELLEN

Im nächsten Schritt rufen wir die API mit unserem API-Key auf. Die API antwortet nach OGC Standard mit einem JSON-String, welcher Parameter (wie Größe oder ID) und die Geometrien der einzelnen Objekte enthält. Für dieses einfache Tutorial wollen wir zunächst nur Geometrien betrachten. Die Objekte lassen sich leicht in Shapely-Polygone umwandeln, welche dann leicht in einem GeoPandas Dataframe zusammengefasst werden können.

Die Ausgabe zeigt uns, dass der Download erfolgreich war. Wir können sehen, dass der Dataframe mit mehreren Objekten gefüllt ist.

DARSTELLUNG IN EINER WEBKARTE

Nach dem erfolgreichen Importieren der Geometrien mittels der API wollen wir diese interaktiv in einer Webkarte darstellen. Dazu nutzen wir Folium. Um die Ergebnisse visuell zu überprüfen nutzen wir die Luftbilder, welche vom Bundesland Nordrhein-Westfalen kostenlos als Web Map Service (WMS) zur verfügung gestellt werden.

Die entstehende Karte ist interaktiv. Sie können zoomen, die Position der Karte verschieben sowie die bestehenden Layer ein- und ausschalten.

ZUSAMMENFASSUNG

In diesem Tutorial haben wir die Grundlagen der deeeper.API kennengelernt. Dazu wurden zunächst alle Gebäude in einem Bereich extrahiert und anschließend in ein leichter handhabbares Standardformat - den GeoPandas Dataframe - umgewandelt. Dieser Dataframe wurde dann mithilfe von Folium in einer interaktiven Webkarte dargestellt. Weitere Beispiele für komplexere Anwendungen finden Sie unter Tutorials.