Adressen¶

Admin

Pfad: Einstellungen → Erweiterungen → Adressen

Das Adressverzeichnis ist die lokale Datenbank aller Hausadressen des Gemeindegebiets. Es dient als primäre Quelle für die automatische Geokodierung: Wenn eine Adresse in ein Vorgangsformular eingegeben wird, sucht das System zuerst hier nach den zugehörigen Koordinaten. Je vollständiger das Verzeichnis gepflegt ist, desto zuverlässiger funktioniert die Koordinatenermittlung ohne Abhängigkeit von externen Diensten.

Adressliste¶

Zeigt alle importierten Adressen in tabellarischer Form.

Spalte	Beschreibung
PLZ	Postleitzahl
Ort	Ortsname / Gemeinde
Straße	Straßenname
Hausnummer	Hausnummer
Hausnr.-Zusatz	Ergänzung zur Hausnummer (z. B. `a`, `b`, `/1`)

Einzelne Adressen können nicht manuell angelegt werden. Die Pflege erfolgt ausschließlich über den GeoJSON-Import.

Adressen löschen¶

Über die Mehrfachauswahl können beliebig viele Adressen markiert und über „Ausgewählte löschen" entfernt werden.

Vor einem Neuimport

Den gesamten Bestand löschen, um doppelte Einträge zu vermeiden.

Adressen importieren¶

Schaltfläche „Adressen importieren" in der Kopfzeile der Adressliste klicken.

Dateiformat: GeoJSON¶

Anforderung	Wert
Typ	`FeatureCollection`
Geometrie	`Point` (Einzelpunkt pro Feature)
Koordinatensystem	WGS84 / EPSG:4326
Max. Dateigröße	50 MB
Dateiendungen	`.geojson`, `.json`

Jedes Feature muss folgende properties enthalten:

Property	Beschreibung	Pflicht
`plz`	Postleitzahl	✓
`ortsgemeinde`	Ortsname / Gemeinde	✓
`strassenname`	Straßenname	✓
`hausnummer`	Hausnummer	✓
`adressierungszusatz`	Hausnummernzusatz (z. B. `a`, `b`)	–

Koordinatenreihenfolge

GeoJSON-Koordinaten sind in der Reihenfolge [Längengrad, Breitengrad] anzugeben – nicht [Breitengrad, Längengrad].

Beispiel¶

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [8.682127, 50.110924]
      },
      "properties": {
        "plz": "60311",
        "ortsgemeinde": "Frankfurt am Main",
        "strassenname": "Römerberg",
        "hausnummer": "23",
        "adressierungszusatz": ""
      }
    }
  ]
}

Importvorgang¶

„Adressen importieren" klicken.
GeoJSON-Datei hochladen.
„Importieren" klicken.

Der Import wird im Hintergrund verarbeitet (asynchron). Die Seite kann sofort weitergenutzt werden. Abhängig von der Datenmenge dauert die Verarbeitung einige Sekunden bis Minuten; die Tabelle aktualisiert sich nach einem Seitenneuladen.

Der Import läuft in einer Datenbanktransaktion: Schlägt die Verarbeitung eines Features fehl, wird die gesamte Importdatei zurückgerollt und kein Eintrag gespeichert. Features ohne geometry-Eigenschaft werden stillschweigend übersprungen.

Bezugsquelle¶

Amtliche Adressdaten im GeoJSON-Format sind über die zuständigen Landesbehörden (Vermessungsämter, Katasterämter) oder über das Bundesamt für Kartographie und Geodäsie (BKG) erhältlich. In einigen Bundesländern als Open Data frei verfügbar.

Geokodierung¶

Beim Speichern eines Vorgangs mit Adresseingabe durchläuft das System zwei Stufen:

Adresseingabe
     │
     ▼
1. Lokales Adressverzeichnis
   (Treffer → Koordinaten sofort, kein externer Aufruf)
     │
     │ kein Treffer
     ▼
2. OpenCage Geocoding API (externer Dienst)
   (Treffer → Koordinaten via Internet-API)
     │
     │ kein Treffer / kein API-Key
     ▼
   Geokodierung fehlgeschlagen

Stufe 1: Lokales Adressverzeichnis¶

Schnell, verbraucht kein API-Kontingent und funktioniert ohne Internetverbindung. Gesucht wird nach PLZ, Ort, Straße und Hausnummer. Die Suche ist nicht auf exakte Groß-/Kleinschreibung angewiesen, Schreibabweichungen können aber dazu führen, dass ein Eintrag nicht gefunden wird.

Stufe 2: OpenCage Geocoding API (Fallback)¶

Wird die Adresse nicht lokal gefunden und ein OpenCage API-Key ist hinterlegt, fragt das System automatisch den externen Dienst an. Der Key wird unter Einstellungen → Allgemein → Anwendung → API konfiguriert.

OpenCage ist kostenpflichtig

Die OpenCage Geocoding API ist ein kostenpflichtiger Drittanbieter-Dienst mit tagesbasiertem Anfragelimit. Ein vollständiges lokales Adressverzeichnis reduziert die Abhängigkeit erheblich.

Rückwärts-Geokodierung¶

Das Ermitteln einer Adresse aus Koordinaten (z. B. beim Klick auf die Karte) steht ausschließlich über die OpenCage API zur Verfügung. Das lokale Verzeichnis unterstützt keine Rückwärts-Geokodierung.

Hinweise¶

Verzeichnis aktuell halten — Nicht importierte Adressen (z. B. Neubauten, neu erschlossene Straßen) werden lokal nicht gefunden und fallen auf den externen Dienst zurück. Das Verzeichnis bei größeren Adressänderungen im Gemeindegebiet aktualisieren.

Koordinatensystem — Die GeoJSON-Datei muss Koordinaten in WGS84 / EPSG:4326 enthalten. Andere Systeme (z. B. ETRS89/UTM) werden nicht automatisch umgerechnet und führen zu falsch platzierten Adressen.

Geokodierungs-Feld — Welches Adressfeld (Stadt oder Stadtteil) für die Koordinatenermittlung herangezogen wird, wird in Einstellungen → Fachmodule → Aufbruch & VAO → Geokodierung festgelegt.