(For the English documentation, see README_en.md)

Baumradar ist ein Open-Data-basiertes Werkzeug, mit dem Bäume in der direkten Umgebung erkundet und bei der Fortbewegung durch die Stadt gezielt gemieden werden können – besonders hilfreich bei einer Baumpollen-Allergie (z. B. gegen Frühblüher). Im Hintergrund: eine Open-Data-Geodaten-Pipeline, die Baumkataster aus derzeit 19 Städten vereinheitlicht, räumlich clustert und signiert verteilt.

Allergie-Hotspots Rote Zonen markieren Gebiete mit allergen-relevanten Bäumen	Intelligentes Routing Routen werden nach Hotspot-Kollisionen bewertet und sortiert	Erkundungsmodus Alle Bäume im 100m-Umkreis anzeigen und identifizieren
Multi-Modus Routing Zu Fuß, Fahrrad oder Auto – mit Allergenwarnung	Multi-City Support 19 Städte in AT, DE und CH frei wählbar	Allergie-Profil Baumarten einzeln als „Warnung" oder „Umfahren" markieren

Im persönlichen Allergie-Profil lassen sich gezielt die Baumgattungen auswählen, die allergische Reaktionen auslösen (z. B. Birke, Hasel, Esche). Die App unterscheidet dabei zwischen zwei Stufen:

• „Umfahren ✕": Diese Bäume werden beim Routing berücksichtigt – die App berechnet Routen, die diese Baumgattungen möglichst meiden.
• „Warnung 🔔": Für diese Bäume registriert Baumradar im Hintergrund Geofence-Zonen bei Android. Eine Push-Benachrichtigung direkt auf den Sperrbildschirm erscheint, sobald sich der Standort einem solchen Baum nähert – auch bei geschlossener App. Dafür ist keine permanent laufende Hintergrund-App nötig, Android überwacht die Zonen energieeffizient über die Play Services.

„Was ist das da für ein Baum?" – Der Erkundungsmodus (Lupen-Icon unten rechts) zeigt alle Bäume im Umkreis von 100 Metern an, unabhängig vom Allergie-Profil. Jeder Marker auf der Karte zeigt den deutschen Gattungsnamen und, falls bekannt, die spezifische Art.

Auf dem Karten-Bildschirm blendet Baumradar transparente Pfeile und Entfernungsangaben ein. Diese zeigen in Echtzeit die Richtung und Distanz zu den nächstgelegenen markierten Bäumen (die nächsten 15). Die Pfeile reagieren auf den Kompass (Gyroskop) und drehen sich mit – für jeden nahen Baum, egal ob er seitlich, hinter dir oder direkt vor dir liegt. So bleibt die Richtung auch dann sichtbar, wenn du gerade auf einen markierten Baum zugehst.

Baumradar berechnet Routen, die Allergen-Hotspots aktiv umfahren:

1. Adressen werden über den Nominatim Geocoder (OpenStreetMap) in Koordinaten aufgelöst.
2. Vom öffentlichen OSRM Routing Server werden bis zu 3 Routen-Alternativen angefragt.
3. Alle Geofence-Zonen der als „Umfahren" markierten Baumarten werden aus der lokalen Datenbank geladen.
4. Jede Route wird auf Kollisionen mit diesen Zonen geprüft (siehe Kollisionserkennung).
5. Falls alle Alternativen Hotspots schneiden, werden automatisch Umfahrungs-Wegpunkte berechnet und eine neue Route angefragt, die die Zonen physisch umgeht.
6. Die allergenfreie Route wird als „Allergiefrei 🟢" markiert. Routen mit Hotspots zeigen die Anzahl der Kollisionen an (z. B. „Route 2 ⚠️ · 3 Hotspots").

Die berechnete Route kann per GPX-Export geteilt werden, z. B. an eine Navigations-App.

Unterstützte Städte:

Beim ersten Start wird mindestens eine Stadt ausgewählt. Bei Reisen in eine neue Stadt schlägt die App automatisch vor, die lokalen Baumdaten herunterzuladen.

Für jede Stadt wird eine komprimierte, aufbereitete SQLite-Datenbank heruntergeladen. Kartenanzeige, Erkundungsmodus und Hintergrund-Warnungen funktionieren danach komplett ohne Internetverbindung. Nur für die Routenberechnung (OSRM) wird kurzzeitig eine Verbindung benötigt.

Die Daten werden vom Backend verarbeitet und kryptografisch mit Ed25519 signiert. Bevor die App eine heruntergeladene Datenbank verwendet, wird die Signatur gegen einen fest eingebetteten Public Key geprüft. Erst bei erfolgreicher Prüfung werden die Daten importiert – damit ist die Authentizität und Unverfälschtheit der Daten sichergestellt.

Beim Start prüft die App auf Neuerungen: Gibt es im GitHub-Release eine neuere App-Version, lädt und installiert sie sich auf Wunsch selbst (mit Hinweis auf die nötige Installationsberechtigung und direktem Sprung in die passende Einstellung). Ebenso werden aktualisierte oder korrigierte Baumdaten erkannt – jede Stadt trägt eine inhaltsbasierte Daten-Version, und bereits geladenen Städten wird ein Refresh angeboten, sobald sich ihre Daten ändern.

Neben der App gibt es ein komplettes Web-GIS zum Selbst-Hosten (webgis/): PostGIS und GeoServer publizieren dieselben signierten Datenbestände als OGC-Dienste (WMS 1.3.0, WFS 2.0, OGC API Features), ein Angular/OpenLayers-Client bringt Karte, Gattungsfilter und Stadt-Scoping — dazu lokales Routing (GraphHopper-Insel-Graph, Allergiezonen-Vermeidung per Custom Model — mit wählbarer Meidungs-Stärke von „5-fach" bis „praktisch strikt") und lokale Adress-/POI-Suche (Photon). Die Besonderheit: Auch Routing-OSM und Geocoder-Index werden aus pro Stadt geschnittenen, signierten Häppchen gespeist — wer nur Zug ausprobiert, lädt für die Adresssuche 25 MB statt der 11 GB fertiger Länder-Indizes. Ein Befehl genügt (nur Docker nötig):

cd webgis
.\start.cmd -Cities zug      # Karte + lokales Routing + lokale Adresssuche für Zug

→ Schnellstart & Dienste · Architektur-Doku mit Lessons Learned

1. Die aktuellste Baumradar.apk aus den Releases herunterladen.
2. Auf dem Smartphone die Installation aus „Unbekannten Quellen" erlauben.
3. APK öffnen und den Anweisungen folgen.
4. Beim ersten Start: Mindestens eine Stadt auswählen und deren Daten herunterladen.
5. Berechtigungen für Standort (inkl. Hintergrund-Standort für Geofence-Warnungen) und Benachrichtigungen erteilen.

git clone https://github.com/matthili/BaumRadar.git
cd BaumRadar
./gradlew assembleDebug
# Die APK findet sich unter app/build/outputs/apk/debug/

Voraussetzungen: Android Studio (aktuelle Version), JDK 21, Android SDK 34.

Beim allerersten Start erscheint ein Städte-Assistent. Hier werden per Schalter die gewünschten Städte ausgewählt. Die App zeigt einen Lade-Fortschritt inkl. Signatur-Verifizierung an. Danach geht es mit „Weiter" zum Hauptbildschirm.

Die App hat am unteren Rand eine Tab-Leiste mit drei Bereichen:

Ein langer Druck auf eine beliebige Stelle der Karte öffnet ein Kontextmenü:

• Virtueller Standort setzen: Für Tests oder Vorausplanung – die App verhält sich, als wäre der Standort an diesem Punkt.
• Route HIER starten/beenden: Setzt Start- bzw. Endpunkt für eine Route.

Baumradar besteht aus zwei Hauptteilen und einer offenen Datenstruktur:

Dieses Projekt ist unter der MIT License veröffentlicht. Siehe LICENSE für weitere Details.