GIS-Akademie Geocoder Dokumentation v1.0.2

Überblick

Dieses QGIS-Plugin ordnet Adressen aus Tabellendateien (CSV, Excel, OpenDocument, Tab-getrennt) Koordinaten zu – man spricht von Geocodierung – und speichert das Ergebnis als Punkt-Layer in einem GeoPackage.

Grundlage ist eine lokale Datenbank amtlicher Hauskoordinaten aller 16 Bundesländer. Das Plugin lädt diese Daten selbst aus den freien Angeboten (Open Data) der Länder; Bayern stammt aus OpenStreetMap, weil amtliche Adressen dort kostenpflichtig sind. Adressen ohne lokalen Treffer können wahlweise beim Online-Dienst Nominatim (OpenStreetMap) nachgeschlagen werden.

Auf Wunsch arbeitet das Plugin vollständig DSGVO-konform: Mit der Option „DSGVO-konformes Geocodieren“ wird nur die lokale Datenbank genutzt — keine Adresse verlässt den Rechner (siehe Optionen).

Diese Hilfe öffnen Sie im Plugin jederzeit über Hilfe. Entwickelt von der GIS-Akademie.

Schnellstart in 3 Schritten

1. Datenbank einrichten (einmalig). Reiter „Datenbank & Quellen“ öffnen und Alle eingetragenen Quellen aktualisieren klicken. Das Plugin lädt alle 16 Bundesländer nacheinander. Beim ersten Mal dauert das rund 2,5–3 Stunden (siehe Aufwand je Bundesland) — am besten über Nacht. Wer die Einrichtung sparen möchte, kann eine fertige Datenbank einbinden (siehe Geodatenabo Plus).
2. Datei geocodieren. Im Reiter „Geocodierung“ die Adressdatei wählen, die Spaltenzuordnung prüfen, Ziel-GeoPackage und Layer-Name angeben und Geocodierung starten klicken.
3. Ergebnis prüfen. Der fertige Layer wird in QGIS geladen. Die Felder accuracy_level (Genauigkeit) und local_score (Übereinstimmung) zeigen, wie gut jeder Treffer ist; nicht gefundene Adressen lassen sich gezielt nacharbeiten (siehe Ergebnis).

Datenbank einrichten

Die lokale Suche braucht eine Geocodierungsdatenbank: eine einzelne Datei mit den Adressen und Koordinaten aller geladenen Bundesländer. Sie wird einmal eingerichtet und danach nur noch aktualisiert. Ohne Datenbank kann das Plugin nur über Nominatim (Internet) geocodieren; im DSGVO-Modus findet es dann nichts.

Schritt 1: Speicherort festlegen

Im Reiter „Datenbank & Quellen“ zeigt der Rahmen Geocodierungsdatenbank den Pfad der Datenbankdatei. Standard ist ein Ordner im QGIS-Profil (<QGIS-Profil>/gis_akademie_geocoder/geocoder.db); dort übersteht die Datenbank Plugin-Updates. Meist können Sie diesen Pfad unverändert lassen.

Soll die Datenbank woanders liegen (z. B. auf einem Laufwerk mit mehr Platz), tragen Sie den Pfad unter Pfad zur Datenbankdatei ein und klicken Pfad speichern und Datenbank verwenden. Gibt es die Datei noch nicht, meldet das Plugin „Pfad gespeichert. Datei wird beim ersten Import angelegt.“

Schritt 2: Daten laden

• Alle Länder auf einmal: Alle eingetragenen Quellen aktualisieren lädt alle 16 Bundesländer nacheinander — Herunterladen, Umwandeln, Importieren und Ergänzen fehlender Postleitzahlen geschehen automatisch. Fortschritt und Protokoll stehen im Rahmen Fortschritt; am Ende nennt eine Zusammenfassung je Land aktualisiert, unverändert, übersprungen oder Fehler.
• Nur einzelne Länder: In der Tabelle Quellen je Bundesland auf den Stift am Zeilenende klicken (oder die Zeile doppelklicken). Auf der Detailseite lädt Jetzt aktualisieren nur dieses Land.

Empfehlungen für den ersten Lauf

• Freier Speicher: Die fertige Datenbank für alle Länder belegt rund 5–6 GB; während des Imports werden zusätzlich bis ca. 2–3 GB gebraucht.
• Stabile Internetverbindung: Insgesamt werden rund 11 GB heruntergeladen.
• Zeitpunkt: Am besten über Nacht oder außerhalb der Arbeitszeit starten. QGIS muss währenddessen geöffnet bleiben; den Rechner nicht herunterfahren.
• Abbrechen ist jederzeit möglich (Knopf Abbrechen im Rahmen Fortschritt). Bereits importierte Länder bleiben erhalten. Ein späterer Klick auf Alle eingetragenen Quellen aktualisieren lädt fertige Länder nicht erneut, weil sie keine neuen Daten haben oder gesperrt sind (siehe Sperre nach Abruf).
• Ein Fehler bei einem Land bricht die anderen nicht ab. Ist ein Server gerade nicht erreichbar, laden Sie dieses Land später erneut.

Nach dem ersten Einrichten

• Am Ende jedes Abrufs aktualisiert das Plugin sein Verzeichnis der Orte und Ortsteile — nur für die Länder mit neuen Daten, meist in Sekunden; danach ist die Datenbank sofort einsatzbereit.
• Aktualisieren: Ein erneuter Klick auf Alle eingetragenen Quellen aktualisieren lädt nur, was seit dem letzten Abruf neu ist — meist dauert das nur Minuten. Das Plugin lädt nie von selbst; wann Sie aktualisieren, bestimmen Sie.

Aufwand je Bundesland

Messwerte vom 26.10.2026 auf einem Rechner mit schneller Internetleitung, gemessen mit einer bereits gefüllten bundesweiten Datenbank. Die Dauer umfasst Download, Umwandlung und Import einschließlich PLZ-Ergänzung und ist als ungefährer Wert zu verstehen. Am meisten Zeit kostet bei Ländern ohne Postleitzahlen in der Quelle das Ergänzen der PLZ, nicht der Download.

PLZ: „enthalten“ = die Quelle liefert Postleitzahlen mit; „ergänzt“ = das Plugin ergänzt sie automatisch aus den mitgelieferten PLZ-Gebieten (siehe Postleitzahlen). WFS (Web Feature Service) ist ein Internetdienst, der Geodaten in Teilen ausliefert; bei „Kacheln“ lädt das Plugin das Land Stück für Stück in räumlichen Ausschnitten.

• Download: rund 11 GB für alle Länder. Die Download-Dateien sind nur vorübergehend nötig und werden nach dem erfolgreichen Import gelöscht.
• Fertige Datenbank: rund 5–6 GB; während des Imports zusätzlich bis ca. 2–3 GB.
• Danach: Aktualisieren lädt nur, was neu ist — meist in wenigen Minuten.

Alternative ohne Einrichtung: Geodatenabo Plus

Geocodierung: Eingabedatei

Alle Schritte des Geocodierens finden im Reiter „Geocodierung“ statt. Im Rahmen 1 · Eingabedatei wählen Sie die Datei über Durchsuchen … oder tippen den Pfad ein. Ein roter Rahmen zeigt einen ungültigen Pfad an.

Nach dem Laden zeigt Erkannter Dateityp Format und Tabellenblatt; die Vorschau zeigt die ersten Felder der ersten Zeile.

Geocodierung: Spaltenzuordnung

Im Rahmen 2 · Spaltenzuordnung legen Sie fest, welche Spalte welche Adressangabe enthält. Häufige Spaltennamen werden automatisch erkannt.

Unterreiter „Mehrere Spalten“

* Mindestens Straße oder Stadt muss zugeordnet sein.

Unterreiter „Eine Spalte“

Steht die komplette Adresse in einer einzigen Spalte (z. B. Lorettoplatz 7, 81377 München), wählen Sie den Unterreiter Eine Spalte und ordnen nur die Adressspalte zu. Straße, Hausnummer, PLZ und Ort werden dann automatisch erkannt — mit oder ohne Komma.

Geocodierung: Ausgabe

Im Rahmen 3 · Ausgabe geben Sie an, wohin das Ergebnis geschrieben wird.

• GeoPackage: Pfad zur .gpkg-Zieldatei. Existiert die Datei bereits, wird der neue Layer hinzugefügt — bestehende Layer bleiben erhalten.
• Layer-Name: nur Buchstaben, Ziffern und _, keine Leerzeichen. Er wird aus dem Namen der Eingabedatei vorgeschlagen; ein roter Rahmen zeigt einen ungültigen Namen an.

Geocodierung: Optionen

Layer nach Geocodierung in QGIS laden

Lädt den fertigen Layer automatisch ins aktuelle QGIS-Projekt.

Nicht gefundene Adressen aussortieren und als CSV ablegen

Ohne diese Option stehen nicht gefundene Adressen mit leerer Geometrie im Ergebnis-Layer. Mit der Option enthält der Layer nur Treffer; die übrigen Adressen landen als CSV-Datei <Layer-Name>_nicht_gefunden.csv im Ordner des GeoPackages (Semikolon-getrennt, UTF-8) — mit den ursprünglichen Spalten, der zusammengesetzten Abfrage und einem Hinweis zum Grund.

Punkte mit identischen Koordinaten um 1 m versetzen

Erhalten mehrere Adressen genau dieselben Koordinaten, werden die weiteren Punkte auf einem Kreis mit 1 m Radius verteilt (bis zu 8 Positionen). Der erste Treffer bleibt an seiner Stelle. Der Versatz dient nur der Darstellung; die Original-Koordinaten stehen weiter in lat und lon.

DSGVO-konformes Geocodieren (nur lokale Quellen)

Es wird ausschließlich die lokale Datenbank genutzt, keine Online-Abfrage — keine Adresse verlässt den Rechner. Adressen ohne lokalen Treffer bleiben „nicht gefunden (nur lokal)“. Geeignet für datenschutzsensible Bereiche wie Verwaltung, Gesundheit oder Soziales.

Geocodierung starten / Abbrechen

Geocodierung starten arbeitet im Hintergrund — QGIS bleibt bedienbar. Das Protokoll zeigt für jede Adresse die verwendete Quelle und am Ende eine Zusammenfassung. Abbrechen beendet den Lauf; das Plugin fragt dann, ob das Teilergebnis gespeichert werden soll — als eigener Layer mit der Endung _teil, ein vorhandener Layer gleichen Namens bleibt unverändert.

Während Daten in die Datenbank importiert werden (Reiter „Datenbank & Quellen“), ist die Datenbank gesperrt: Geocodieren und Aktualisieren schließen sich deshalb gegenseitig aus.

Lokal oder Nominatim: Welche Quelle wird genutzt?

Der Geocoder entscheidet für jede Adresse selbst:

Im DSGVO-Modus entfallen beide Nominatim-Zeilen.

Bundesland-Erkennung über die PLZ

Fehlt ein Bundesland-Feld (oder steht dort nur „Deutschland“), schätzt der Geocoder das Bundesland aus den ersten Ziffern der PLZ. Es dient nur als Vorfilter, damit die Suche schneller ist; den Ausschlag geben Ort und PLZ.

Nominatim (Online-Dienst)

Nominatim ist der Geocoder von OpenStreetMap. Er wird für Adressen außerhalb der geladenen Bundesländer genutzt und als Ersatz, wenn die lokale Suche nichts findet. Erlaubt ist höchstens 1 Anfrage pro Sekunde; das Plugin hält das automatisch ein (siehe Nutzungsrichtlinien).

Reiter „Datenbank & Quellen“ im Überblick

Hier richten Sie die Datenbank ein und halten sie aktuell. Der Reiter besteht aus vier Rahmen:

Bezug

• Internet — die Daten werden direkt beim Land geladen.
• Datei — eine eingetragene Datei auf diesem Rechner.
• nicht eingetragen — die Daten gibt es nur über ein Portal (Shop, Anmeldung); derzeit betrifft das kein Land.

Knöpfe unter der Tabelle

• Alle eingetragenen Quellen aktualisieren — lädt für jedes Land mit Quelle die aktuellen Daten und ersetzt dessen Bestand, aber nur, wenn es seit dem letzten Abruf neue Daten gibt. Ob etwas neu ist, erkennt das Plugin am Datenstand, den der Server meldet, bzw. an einer Prüfsumme der Datei.
• Auch ohne neue Daten erneut laden — erzwingt den Abruf, auch wenn nichts neu ist oder die Sperre nach Abruf greift.
• Quellenliste prüfen — holt die aktuelle Liste der Download-Adressen (siehe Quellenliste online).

Detailseite eines Bundeslands

Sie öffnen sie über den Stift in der Tabelle Quellen je Bundesland oder per Doppelklick auf die Zeile. Oben stehen der Stand in der Datenbank und die Standardquelle mit Link. Darunter legen Sie im Rahmen Quelle für dieses Bundesland die Bezugsart fest:

Datei auf diesem Rechner

Eine Adressdatei auf diesem Rechner oder einem Netzlaufwerk: HK-DE-Text (.txt/.csv), INSPIRE-GML, Shapefile, OpenStreetMap-Extrakt (.osm.pbf) oder ein Zip davon (zu den Formaten siehe Datenformate). Das Format wird an der Datei erkannt. Die Vorschau zeigt zwei Adressen und warnt, wenn die Datei Adressen eines anderen Bundeslands enthält; bei Shapefiles erscheint eine Feldzuordnung. Datei importieren speichert die Angaben und importiert sofort. Ersetzen Sie die Datei später durch eine neuere Fassung unter demselben Pfad, importiert Alle eingetragenen Quellen aktualisieren sie automatisch erneut (erkannt an Größe und Änderungsdatum).

Internetquellen

Feste Datei-URL, Verzeichnisindex, Link auf einer Webseite, Atom-/RSS-Feed, CKAN-Datenkatalog, WFS 2.0, Dateiliste als GeoJSON (je Kreis eine Datei), GaiaLight-Downloaddienst oder OGC API Features. Für die Standardquellen ist alles vorbelegt; ändern müssen Sie hier normalerweise nichts.

• Platzhalter: Eine feste Datei-URL darf Platzhalter enthalten, die beim Abruf ersetzt werden: {datum} (heutiges Datum als JJJJMMTT, sonst gestern), {jahr} und {nr} (Datenfassung wie „2026-01“; geprüft werden das laufende und das vorige Jahr — die neueste vorhandene Fassung gilt).
• Datenformat: Auch OpenStreetMap-Extrakt (.osm.pbf) steht für eigene Quellen zur Verfügung — als Datei oder Internetquelle.
• Abrufart (bei WFS): seitenweise oder in räumlichen Kacheln — Kacheln für Dienste, die beim Blättern unzuverlässig sind.
• Sperre nach Abruf: siehe Sperre nach Abruf.

Knöpfe

• Jetzt aktualisieren — lädt nur dieses Land (nur bei neuen Daten, außer mit Auch ohne neue Daten erneut laden).
• Quelle prüfen — testet die Erreichbarkeit, ohne etwas zu importieren.
• Datei importieren — bei Bezugsart Datei auf diesem Rechner.
• Standardquelle wiederherstellen — verwirft eine eigene Quelle; die Adressen in der Datenbank bleiben erhalten.

Wer nur aktualisiert und nichts ändert, behält die Standardquelle. Geänderte Angaben werden als eigene Quelle im QGIS-Profil gespeichert, ersetzen die Standardquelle des Landes und überstehen Plugin-Updates.

Sperre nach Abruf

Das Plugin lädt nie von selbst, sondern nur, wenn Sie Alle eingetragenen Quellen aktualisieren oder auf der Detailseite Jetzt aktualisieren klicken. Einige Quellen melden jedoch keinen Datenstand (z. B. die WFS-Dienste) oder ändern sich täglich (OpenStreetMap für Bayern). Ohne Sperre würde jeder Klick den kompletten Bestand — teils mehrere Gigabyte — neu laden.

Diese Quellen werden beim Aktualisieren deshalb übersprungen, solange der letzte Abruf weniger als 28 Tage zurückliegt. Das betrifft derzeit Bayern, Brandenburg, Hamburg, Mecklenburg-Vorpommern, Niedersachsen und das Saarland. Die Zusammenfassung meldet sie als übersprungen.

• Sofort laden: Auch ohne neue Daten erneut laden anhaken.
• Dauer ändern: auf der Detailseite im Feld Sperre nach Abruf.

Die Sperre ist kein Zeitplan — nach 28 Tagen wird nichts automatisch geladen.

Quellenliste online aktualisieren

Welche Download-Adresse für welches Land gilt, steht in einer Quellenliste, die mit dem Plugin geliefert wird. Ändert ein Land seinen Download, kommt die neue Adresse ohne neue Plugin-Version an: Quellenliste prüfen lädt die aktuelle Liste von der Projektseite des Plugins auf GitHub. Das geschieht auch automatisch vor Alle eingetragenen Quellen aktualisieren. Unter der Tabelle steht, welche Liste gilt und von wann sie ist.

• Die Online-Liste wird nur verwendet, wenn sie neuer ist als die mitgelieferte. Sie wird im QGIS-Profil gespeichert und gilt auch ohne Internet weiter.
• Eigene Quellen haben immer Vorrang und werden nie überschrieben.
• Die Liste enthält nur Daten, kein Programm. Einträge, die das Plugin nicht kennt (z. B. ein neuer Abruf-Typ für eine spätere Version), werden übergangen — für dieses Land gilt dann die mitgelieferte Quelle.
• Abgerufen wird nur auf Klick, nie beim Start von QGIS. GitHub sieht dabei wie bei jedem Download die IP-Adresse des Rechners; Adressdaten werden nicht übertragen.

Ausweichquellen und Schutz des Bestands

Für ein Land kann eine Ausweichquelle hinterlegt sein, die einspringt, wenn die Hauptquelle scheitert. Derzeit gilt das für Thüringen: Ist die Datei des Landes nicht erreichbar, dient der ältere INSPIRE-Download als Ersatz — aber nur, solange noch keine Thüringer Adressen in der Datenbank sind (er ist älter, und rund 66.000 Adressen fehlt die Koordinate).

Außerdem schützt das Plugin den vorhandenen Bestand:

• Liefert eine Quelle eine Webseite statt der Datei (z. B. bei Wartungsarbeiten), bricht ein Download vorzeitig ab oder enthält eine Datei keine Adressen, bleibt der bisherige Bestand des Landes erhalten.
• Ein unvollständiger WFS-Download ersetzt nie einen vollständigen Bestand (siehe Vollständigkeitsprüfung).
• Enthalten neue Daten weniger als die Hälfte der bisherigen Adressen eines Landes, werden sie nicht übernommen — meist ist dann die Lieferung unvollständig. Sind sie wirklich richtig, übernimmt sie Auch ohne neue Daten erneut laden.
• Alle Dateien eines Landes werden gemeinsam übernommen: Scheitert eine davon oder wird abgebrochen, bleibt der bisherige Bestand vollständig erhalten.
• Ein Fehler bei einem Land bricht die übrigen nicht ab.

Die Quellen der 16 Bundesländer

Alle 16 Bundesländer lädt das Plugin selbst — mit einem Klick auf Alle eingetragenen Quellen aktualisieren.

Wie und wo die Daten abgerufen werden

Die Dauerangaben in dieser Tabelle stammen aus der Quellenliste; aktuelle Messwerte stehen unter Aufwand je Bundesland. Links und Lizenzen der Quellen: Lizenzen und Quellenvermerke.

Besonderheiten einzelner Länder

• Bayern: Amtliche Gebäudeadressen gibt es nur gebührenpflichtig. Das Plugin lädt deshalb den OpenStreetMap-Extrakt von Geofabrik und wandelt ihn selbst um (siehe OpenStreetMap als Quelle) — nicht amtlich, Lizenz ODbL. Amtliche Daten lassen sich kaufen und als eigene Datei eintragen (siehe Amtliche Hauskoordinaten kaufen).
• Niedersachsen: ALKIS-Daten des LGLN je Kreis (45 Dateien, zusammen rund 4,4 GB). Übernommen werden die Gebäude mit Straße und Hausnummer; die Gemeinde kommt aus den Flurstücken derselben Datei, die PLZ aus den PLZ-Gebieten. Jede Kreisdatei wird nach der Umwandlung gleich wieder gelöscht.
• Baden-Württemberg: Die landesweite Datei enthält auch Gebäude ohne echte Hausnummer (aus Koordinaten gebildete Pseudo-Nummern); sie werden beim Import übergangen.
• Hessen: Das Downloadcenter legt die Datei täglich unter einem neuen Datumsordner ab; Tagesdatum und Datenfassung ermittelt das Plugin beim Abruf.
• Schleswig-Holstein: Der Downloaddienst des Landes stellt die Datei als Auftrag zusammen; das Plugin startet den Auftrag, wartet und lädt die Datei.
• Brandenburg: Die Hauskoordinaten gibt es nur über den (derzeit abgeschalteten) Geobroker; das Plugin lädt daher die INSPIRE-Adressen aus dem WFS in räumlichen Kacheln.
• Hamburg: Geladen wird der aktuelle Stand aus dem WFS des Datensatzes INSPIRE HH Adressen Hauskoordinaten; die dort angebotenen Zip-Dateien enden 2020.
• Sachsen-Anhalt: Frei verfügbar sind die Gebäudereferenzen (ohne PLZ); vollständige Hauskoordinaten gibt es nur auf Antrag.
• Thüringen: Hauptquelle ist die HK-DE-Datei des Landes, mit Ausweichquelle (siehe Ausweichquellen).
• Saarland: Die Hauskoordinaten kommen über eine OGC-API-Features-Schnittstelle; als Ort dient der Postort (die Gemeinde steht dort nur als Schlüssel).
• Bremen: Shapefile mit Adresspunkten (Bremen und Bremerhaven).
• Rheinland-Pfalz: In den Daten steht als Gemeinde oft der Ortsteil (z. B. „Harbach“) statt der Stadt (z. B. „Altenkirchen“). Die lokale Suche trifft am besten, wenn als Ort der Ortsteil angegeben ist; sonst greift gegebenenfalls Nominatim.

Postleitzahlen: mitgelieferte PLZ-Gebiete

Viele amtliche Hauskoordinaten enthalten keine Postleitzahl (z. B. Nordrhein-Westfalen und Mecklenburg-Vorpommern). Damit die PLZ trotzdem für die Suche zur Verfügung steht, liefert das Plugin die PLZ-Gebiete Deutschlands mit und ergänzt fehlende PLZ automatisch anhand der Lage des Adresspunkts:

• beim Import jeder Datei (automatisch oder von Hand, alle Formate) für Adressen ohne PLZ,
• beim Aktualisieren der Quellen für bereits vorhandene Adressen ohne PLZ — auch in Ländern ohne neue Daten.

PLZ aus den amtlichen Quellen haben immer Vorrang und werden nie überschrieben. Bringt eine neue Plugin-Version neuere PLZ-Gebiete mit, werden nur die ergänzten PLZ beim nächsten Aktualisieren neu berechnet. Eine Einstellung ist nicht nötig.

Eigene PLZ-Gebiete: Im Rahmen Postleitzahlen des Reiters „Datenbank & Quellen“ lässt sich über Eigene PLZ-Gebiete … eine eigene Datei setzen (GeoPackage, Shapefile, GeoJSON), z. B. lizenzierte PLZ-Gebiete der Deutschen Post. Mitgelieferte verwenden stellt den Standard wieder her.

OpenStreetMap als Quelle (Bayern)

Für Bayern lädt das Plugin den Extrakt bayern-latest.osm.pbf von Geofabrik (rund 860 MB) und wandelt ihn mit den Werkzeugen von QGIS in Adressen um:

• Übernommen werden alle Objekte mit Hausnummer und Straße (bzw. Platzname): Adresspunkte, Gebäude und Linien. Hausnummern-Listen wie „5;7“ ergeben je Nummer eine Adresse.
• Doppelte Adressen (z. B. Adresspunkt und Gebäude) werden zusammengeführt.
• Der Ort kommt aus der Adressangabe in OpenStreetMap; fehlt sie, wird er aus den Gemeindegrenzen im selben Extrakt bestimmt. Der Ortsteil dient der Suche als zusätzlicher Name.
• Fehlende Postleitzahlen ergänzt das Plugin aus den PLZ-Gebieten.

Download, Umwandlung und Import dauern zusammen rund 15 Minuten (zuletzt rund 2,57 Mio. Adressen). Da sich OpenStreetMap täglich ändert, gilt eine Sperre nach Abruf von 28 Tagen. Die Bayern-Daten sind nicht amtlich und stehen unter der ODbL (siehe Lizenzen).

Ergebnis: Ausgabefelder im GeoPackage-Layer

Zusätzlich zu den Spalten der Eingabedatei enthält der Layer diese Felder:

Ergebnis: Genauigkeitsstufen (accuracy_level)

Ergebnis: Fuzzy-Score der lokalen Suche (local_score)

Die lokale Suche ist fehlertolerant („unscharf“, englisch fuzzy): Sie findet Adressen auch bei Tippfehlern und abweichender Schreibweise und bewertet, wie gut der Treffer zur Eingabe passt.

Was die Suche ausgleicht

• Abkürzungen: „Marienstr.“ → „Marienstraße“, „Päpinghauser Str.“ → „Päpinghauser Straße“.
• ß/ss: „Grosse Straße“ findet „Große Straße“.
• Orte: Ortsteile und Bezirke („Blankenese“ → Hamburg, „Pankow“ → Berlin), „Berlin-Mitte“ und Kurznamen („Oldenburg“ → Oldenburg (Oldenb.)) werden aufgelöst. Bleibt ein Ortsname ohne PLZ oder Bundesland mehrdeutig, steht im Label „Ort mehrdeutig (N Orte) — … gewählt“.
• Treffer aus einem anderen Ort werden verworfen — außer die PLZ stimmt genau.

Wie der Score entsteht

Fehlt eine Angabe in der Eingabe, wird ihr Gewicht auf die übrigen verteilt — vor allem auf die Straße. Eine Eingabe ohne Hausnummer oder ohne PLZ wird dadurch nicht pauschal abgewertet. Die räumliche Genauigkeit zeigt davon unabhängig accuracy_level (z. B. 4 = Straße, auch wenn der Score „Exakt“ ist).

Ergebnis: Nicht gefundene Adressen

Was mit Adressen ohne Treffer geschieht, steuert die Option „Nicht gefundene Adressen aussortieren und als CSV ablegen“ (siehe Optionen). In beiden Fällen werden sie am Ende im Protokoll aufgelistet.

Häufige Gründe: Das Bundesland der Adresse ist nicht in der Datenbank geladen (im DSGVO-Modus), die Straße ist falsch geschrieben oder neu, oder der Ort ist mehrdeutig und keine PLZ angegeben. Eine PLZ in der Eingabe hilft oft schon.

Anhang: Datenformate (technisch)

Diese Angaben brauchen Sie nur, wenn Sie auf der Detailseite eine eigene Datei oder Internetquelle eintragen.

Shapefile: Geometrie und Feldzuordnung

• Adresspunkte (z. B. ALKIS „Georeferenzierte Gebäudeadresse“): Die Koordinate wird direkt übernommen.
• Gebäudeumrisse (Flächen): Als Koordinate dient ein Punkt, der sicher innerhalb des Gebäudes liegt.

Objekte ohne Straßenangabe werden übersprungen. Die Feldzuordnung erscheint auf der Detailseite, sobald eine Shapefile-Datei (oder ein Zip damit) gewählt ist; häufige Feldnamen werden vorbelegt, und die Zuordnung wird mit der Quelle gespeichert. Koordinaten werden bei Bedarf automatisch umgerechnet.

Koordinaten

Die amtlichen Hauskoordinaten liegen je nach Land in UTM Zone 32N (EPSG:25832) oder 33N (EPSG:25833). Das Plugin erkennt die Zone und rechnet die Ergebnisse nach WGS84 (EPSG:4326) um.

Dateien und Speicherorte

Fehlerbehebung und häufige Fragen

Eine Quelle ist nicht erreichbar oder liefert „eine Webseite statt der Datei“

Meist ist der Server des Landes gerade in Wartung oder überlastet. Der bisherige Bestand des Landes bleibt erhalten, die übrigen Länder werden normal geladen. Versuchen Sie es später erneut — über Alle eingetragenen Quellen aktualisieren oder auf der Detailseite mit Jetzt aktualisieren.

Ein Land wird als „übersprungen“ gemeldet

Für dieses Land gilt die Sperre nach Abruf: Der letzte Abruf liegt weniger als 28 Tage zurück. Sofort laden: Auch ohne neue Daten erneut laden anhaken.

Ein Land wird als „unverändert“ gemeldet

Seit dem letzten Abruf gibt es keine neuen Daten — es wurde nichts geladen. Mit Auch ohne neue Daten erneut laden erzwingen Sie den Abruf, z. B. nach einem Plugin-Update mit geändertem Datenbankformat. Jeder Import ersetzt den bisherigen Bestand seines Landes.

Downloads scheitern im Behördennetz (Proxy, Firewall)

Das Plugin lädt direkt von den Servern der Länder (Adressen in der Tabelle Wie und wo die Daten abgerufen werden) und die Quellenliste von GitHub. In abgeschotteten Netzen blockieren Proxy oder Firewall solche Abrufe oft. Möglichkeiten:

• den Proxy in QGIS eintragen (Einstellungen → Optionen → Netzwerk) — das Plugin übernimmt ihn für alle Abrufe,
• die IT bitten, diese Adressen freizugeben,
• die Datei auf anderem Weg beschaffen und auf der Detailseite als Datei auf diesem Rechner eintragen,
• eine fertige Datenbank einbinden (siehe Geodatenabo Plus).

Zu wenig Speicherplatz

Für alle Länder braucht die fertige Datenbank rund 5–6 GB, während des Imports zusätzlich bis ca. 2–3 GB (siehe Aufwand). Abhilfe: nur die benötigten Länder laden oder die Datenbank auf ein größeres Laufwerk legen (Pfad speichern und Datenbank verwenden). Download-Dateien werden nach dem erfolgreichen Import gelöscht; nach einem Fehler bleiben sie im Ordner quellen neben der Datenbank bis zum nächsten Abruf liegen.

Wo finde ich technische Details zu einem Fehler?

Das Protokoll im Plugin zeigt Schritte und Ergebnisse in verständlicher Form. Technische Angaben für den Support (Adressen der Dienste, Dateinamen, Fehlerdetails) stehen im QGIS-Meldungsprotokoll: Ansicht → Bedienfelder → Protokollmeldungen, Reiter „GIS-Akademie Geocoder“. Bei einem Fehler weist das Protokoll im Plugin darauf hin.

Kann die Datenbank auf einem Netzlaufwerk liegen?

Die Datenbank ist eine einzelne Datei; ihr Pfad kann frei gewählt werden, auch auf einem Netzlaufwerk. Da sie mehrere Gigabyte groß ist, laufen Einrichten und Aktualisieren auf einem lokalen Laufwerk in der Regel schneller. Eine Möglichkeit: lokal einrichten und die fertige Datei anschließend auf das Netzlaufwerk kopieren. Aktualisieren Sie nicht, während andere damit geocodieren.

Nominatim ist langsam oder liefert wenig

Nominatim erlaubt höchstens eine Anfrage pro Sekunde (rund 2 Minuten je 100 Adressen) und ist nicht für große Mengen gedacht. Laden Sie die betroffenen Bundesländer in die lokale Datenbank — dann wird Nominatim nur noch als Ersatz gebraucht. Für große Mengen über Nominatim ist eine eigene Nominatim-Instanz nötig.

Wie halte ich die Daten aktuell?

Klicken Sie von Zeit zu Zeit (z. B. monatlich) auf Alle eingetragenen Quellen aktualisieren. Geladen wird nur, was neu ist. Das Plugin aktualisiert nie von selbst.

Lizenzen, Quellenvermerke und Nutzungsrichtlinien

Nominatim

Höchstens 1 Anfrage pro Sekunde; das Plugin hält dies automatisch ein (1,1 Sekunden Pause). Für größere Mengen eine eigene Instanz betreiben. Weitere Infos: operations.osmfoundation.org/policies/nominatim/

Lokale Daten

Die amtlichen Hauskoordinaten stehen überwiegend unter der Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0); Niedersachsen, Schleswig-Holstein, Thüringen und Bremen nutzen CC BY 4.0, Berlin dl-de/zero-2-0 (keine Namensnennung erforderlich). Bitte geben Sie bei Karten und weitergegebenen Ergebnissen die Namensnennung laut Quellenvermerk an.

Quellenvermerke je Bundesland

Quellen und Lizenzen

Änderungsprotokoll

Die Änderungen je Version, die neueste zuerst. Dieselben Angaben zeigt QGIS in der Pluginverwaltung bei den Details des Plugins.