de_data QGIS Plugin

de_data ist ein QGIS-Plugin zum Laden deutscher Verwaltungsdaten (Flaechen und Grenzen), OSM-Daten und Regionalstatistikdaten sowie zum AGS-basierten CSV-Import in bestehende Layer.

Kurzbeschreibung

Das Plugin bietet vier Hauptbereiche:

• Gebiet: Verwaltungsflaechen und Grenzen (Bund, Laender, Bezirke, Kreise, Gemeinden)
• OSM: Netz- und POI-Daten ueber Overpass
• CSV: AGS-Erkennung und Attributimport in bestehende Layer
• Regionalstatistik: Katalog-/CSV-Abruf und Import per AGS

Aktuelle Plugin-Version (laut metadata.txt): 0.1

Voraussetzungen

• QGIS 3.x (mindestens 3.0)
• Python-Abhaengigkeiten im QGIS-Python-Umfeld:
  • requests
  • pandas
  • numpy

Hinweis: Wenn Module fehlen, zeigt das Plugin beim Laden einen Hinweis mit passendem pip-Befehl fuer den verwendeten QGIS-Python-Interpreter.

Installation (Endnutzer, aus ZIP)

1. Release-ZIP herunterladen (siehe GitHub Releases).
2. In QGIS: Plugins -> Plugins verwalten und installieren... -> Aus ZIP installieren.
3. Release-ZIP auswaehlen.
4. Plugin de_data aktivieren.

Installation (Entwickler)

1. Repository in einen QGIS-Pluginpfad klonen, sodass der Ordnername de_data ist.
2. QGIS mit passendem Pluginpfad starten (z. B. ueber QGIS_PLUGINPATH).
3. Plugin in der Plugin-Verwaltung aktivieren.

Release-ZIP bauen

Voraussetzung: Im Projektordner ausfuehren.

make release-zip

Optional Dateiliste pruefen:

make release-list

Das Build-Skript erzeugt ein QGIS-kompatibles ZIP in dist/ und stellt sicher, dass genau ein Top-Level-Ordner de_data/ enthalten ist. Entwicklungsdateien, lokale Cache-Artefakte und credentials.py werden beim ZIP-Bau ausgeschlossen.

Datenquellen

• Verwaltungsdaten (WFS): geodatenzentrum.de
• OSM-Daten: overpass-api.de
• Regionalstatistik: regionalstatistik.de

Netzwerkzugriffe

Folgende Funktionen benoetigen Netzwerkzugriff:

• WFS-Abrufe fuer Flaechen/Grenzen
• Overpass-Abfragen fuer OSM-Daten
• Regionalstatistik-API fuer Katalog und CSV

Bei nicht erreichbaren Diensten werden Meldungen im Plugin-Log/Status angezeigt.

Credentials / API-Zugang

Regionalstatistik-Zugangsdaten werden in dieser Reihenfolge gelesen:

1. Umgebungsvariablen REGIONALSTATISTIK_USERNAME / REGIONALSTATISTIK_PASSWORD
2. QSettings-Key (standardmaessig DeDataPlugin/regionalstatistik)
3. Optionales lokales Fallback credentials.py

Wichtig:

• Das Plugin startet auch ohne credentials.py.
• Fehlende Credentials werden erst bei Regionalstatistik-Funktionen als Fehlermeldung gemeldet.
• credentials.py darf nicht in Release-ZIPs enthalten sein.

Cache-Verhalten

• WFS-Daten werden lokal im Ordner cache/wfs als GeoPackage gecacht.
• Cache laeuft nicht automatisch ab.
• Cache loeschen fragt vor dem Loeschen nach Bestaetigung und zeigt Anzahl/Groesse der Cache-Dateien.
• Bei Abbruch (Nein) wird nichts geloescht und der Status entsprechend gesetzt.

Typischer Workflow

1. Gebietsauswahl treffen (Laender/Bezirke/Kreise).
2. Gewuenschte Flaechen und/oder Grenzen laden.
3. Optional OSM-Daten fuer die Auswahl laden.
4. Optional CSV oder Regionalstatistikdaten per AGS in Layer importieren.
5. Bei Bedarf Plugin-Layer und/oder Cache ueber die Buttons bereinigen.

Bekannte Einschraenkungen

• Internetabhaengige Funktionen sind von der Verfuegbarkeit externer Dienste abhaengig.
• XML-Importpfade sind nur teilweise umgesetzt.
• Abhaengigkeiten (requests, pandas, numpy) muessen im QGIS-Python-Umfeld installiert sein.

Support / Issues

Fehler und Feature-Wuensche bitte im Issue-Tracker melden:

• https://github.com/olileitner/de_data/issues

Lizenz

Dieses Projekt ist als GPL-2.0-or-later vorgesehen. Details siehe Datei LICENSE.

Screenshots

Aktuell sind keine finalen Screenshots im Repository enthalten. Empfohlene Platzhalter fuer die Einreichung:

• docs/screenshots/01_gebiet_tab.png
• docs/screenshots/02_osm_tab.png
• docs/screenshots/03_csv_tab.png
• docs/screenshots/04_regionalstatistik_tab.png