---
title: Adressverzeichnis
description: Straßen und Adresspunkte importieren und pflegen.
---

Das Adressverzeichnis liefert die Vorschläge in allen Adressfeldern. Es besteht aus Straßen und
Adresspunkten (Hausnummern mit Koordinaten).

## Datenquellen

- **OpenPLZ**: Straßenverzeichnis je Ort, abrufbar aus der Verwaltung.
- **Amtliche Hauskoordinaten (HK-DE)**: Adresspunkte mit Koordinaten, Import als CSV. Die
  Anleitung steht in [`docs/entwicklung.md`](https://git.wannenmacher.org/lagewerk/server/-/blob/main/docs/entwicklung.md).
- **Photon**: optionaler Geocoder für Adressen außerhalb des Verzeichnisses. Er braucht einen
  regionalen Index, siehe ebenfalls `docs/entwicklung.md`.

## Reihenfolge beim Aufbau

Die amtlichen Hauskoordinaten enthalten keine Postleitzahl. Der Import übernimmt sie von der
passenden Straße im Verzeichnis. Deshalb zuerst die Straßen anlegen, dann die Hausnummern. Das
Adressverzeichnis erinnert oben auf der Seite daran:

1. **Straßen mit PLZ per OpenPLZ** für jede Postleitzahl des Einsatzgebiets abrufen. Den
   Abruf am besten über das Feld **PLZ** machen: Ein Ortsname holt alle gleichnamigen Orte in
   ganz Deutschland, etwa jedes „Winterbach“, und füllt das Verzeichnis mit fremden Straßen.
2. **Hauskoordinaten** als CSV mit dem Import-Typ „Hauskoordinaten (HK-DE)“ importieren.

:::warning[Andersherum entstehen Zeilen ohne PLZ]
Laufen die Hauskoordinaten zuerst, findet der Import keine Straße. Ohne Geocoder legt er dann
für jede Straße eine Zeile **ohne PLZ** an und markiert ihre Hausnummern als unsicher. Ein
späterer OpenPLZ-Abruf legt dieselben Straßen ein zweites Mal an, dann mit PLZ, aber ohne
Hausnummern. Die Hausnummern lassen sich im Bearbeiten-Fenster der Zeile ohne PLZ in die Zeile
mit PLZ verschieben.
:::

Kommt eine Straße in einem Ort unter mehreren Postleitzahlen vor (größere Städte), entscheidet
der Import je Hausnummer über den Geocoder. Ohne Geocoder bleiben diese Hausnummern als
unsicher markiert und tragen in der Liste ein Warndreieck. Mit dem Warnfilter „Nur unsichere
PLZ“ bzw. „Nur ohne PLZ“ findet man sie wieder.

## Pflege

Straßennamen werden bei jedem Import in eine einheitliche Schreibweise gebracht („str.“ wird
„straße“). Mögliche Duplikate zeigt das Adressverzeichnis an und führt sie auf Wunsch zusammen.
Hausnummern lassen sich je Straße anlegen, ändern, verschieben und löschen. Von Hand gepflegte
Punkte bleiben bei einem erneuten Import erhalten.

Details: [`docs/spec/adressen.md`](https://git.wannenmacher.org/lagewerk/server/-/blob/main/docs/spec/adressen.md).
