PLZ-API: Postleitzahlen abfragen, validieren und geokodieren

Nicht jeder Anwendungsfall braucht eine vollständige Adresse. Sehr oft reicht die Postleitzahl: um ein Formular vorauszufüllen, ein Liefergebiet zu bestimmen, eine Filiale in der Nähe zu finden oder Kunden nach Region auszuwerten.

Genau dafür gibt es die PLZ-API. Sie ist der kleinste und günstigste Baustein im Adressthema und häufig der richtige Einstieg.

Typische Anwendungsfälle

Formular vorausfüllen. Der Kunde tippt die PLZ, Ort und Bundesland erscheinen automatisch. Zwei Felder weniger, und der Ort ist garantiert richtig geschrieben.
PLZ validieren. Existiert diese Postleitzahl überhaupt, und passt sie zum eingegebenen Ort? Ein regulärer Ausdruck prüft nur, ob es fünf Ziffern sind, nicht ob es sie gibt.
Liefergebiete abbilden. Versandkosten, Liefertage oder Verfügbarkeit hängen sehr oft an der PLZ.
Umkreissuche. Alle Filialen, Servicepartner oder Abholpunkte in einem Radius um eine Postleitzahl.
Regionale Auswertung. Umsätze nach Bundesland oder Region gruppieren.

Die PLZ identifiziert keinen Ort

Der wichtigste Punkt, und der am häufigsten übersehene: die Beziehung zwischen Postleitzahl und Ort ist in Deutschland nicht eindeutig, und zwar in beide Richtungen.

Eine PLZ kann mehrere Gemeinden abdecken. Im ländlichen Raum teilen sich benachbarte Gemeinden regelmäßig eine Postleitzahl, weil sie über dasselbe Zustellzentrum versorgt werden.

Eine Gemeinde kann mehrere PLZ haben. Jede größere Stadt hat viele; Berlin, Hamburg und München arbeiten mit Dutzenden.

Der Grund ist einfach: Die Postleitzahl ist ein postalisches Ordnungsmerkmal für die Zustellung, keine Verwaltungsgrenze. Sie folgt den Zustellwegen, nicht den Gemeindegrenzen.

Praktische Konsequenz: Wenn Sie sauber nach Gemeinde auswerten wollen, ist die PLZ der falsche Schlüssel. Verwenden Sie die Gemeindekennung und zeigen Sie den Ortsnamen nur an.

PLZ zu Koordinaten

Für Umkreissuchen und Kartendarstellungen brauchen Sie zur Postleitzahl einen Punkt. Wichtig ist zu wissen, welchen Punkt Sie bekommen: In aller Regel ist es der Mittelpunkt des PLZ-Gebiets, nicht eine Hausanschrift.

Das ist für Auswertung, Gebietsplanung und Filialsuche völlig ausreichend. Für Navigation zu einer bestimmten Tür ist es das nicht; dafür brauchen Sie ein Geokodierungsergebnis auf Hausnummernebene.

Was die Abfrage kann

Wenn Sie den Ort noch nicht kennen, sondern ihn aus der Postleitzahl ableiten wollen, lassen Sie PLZ, Ort und Straße einzeln vorschlagen. Für die Umkreissuche gibt es eine eigene Abfrage, die alles in einem Radius um einen Punkt liefert.

Die Parameter und ein fertiges Codebeispiel stehen in der Entwicklerdokumentation.

Kostenlose PLZ-Dienste und ihre Grenzen

Für Deutschland gibt es brauchbare kostenlose Quellen, und es lohnt sich, ihre Grenzen zu kennen:

Offene Datensätze und offene APIs decken PLZ, Ort und Verwaltungseinheiten ab. Für viele Anwendungen reicht das vollkommen. Was fehlt, ist meist die Straßenebene, eine Zusage zur Verfügbarkeit und ein verlässlicher Aktualisierungsrhythmus.
Amtliche Geodaten liefern PLZ-Gebiete als Flächen. Ideal für Karten, unhandlich für eine schnelle Abfrage im Checkout.
Kostenlose Tarife kommerzieller Anbieter sind gut zum Entwickeln und stoßen im Produktivbetrieb schneller an ihre Grenze als gedacht.

Wenn Sie die Daten lieber als Datei hätten statt als Schnittstelle, behandelt PLZ-Datenbank und Postleitzahlen-Liste genau diesen Weg samt seiner Nachteile.

Was Pro6PP anbietet

Pro6PP liefert zu deutschen Adressen die Postleitzahl, den Ort, die Gemeinde und Koordinaten, dazu Vorschläge während der Eingabe, Umkreissuche und Entfernungsberechnung. Dieselbe API deckt die Niederlande, Belgien, Frankreich, Luxemburg, Dänemark, Österreich, die Schweiz, Spanien und das Vereinigte Königreich ab, was Liefergebiete über Landesgrenzen hinweg erheblich vereinfacht.

Wenn Sie über die Postleitzahl hinaus vollständige Anschriften prüfen wollen, ist die Übersicht zur Adressprüfung für Webshops der nächste Schritt, und Adressvalidierung per API beschreibt die Umsetzung.

Häufige Fragen

Gibt es eine kostenlose PLZ-API für Deutschland?

Ja, es gibt offene Dienste und offene Datensätze mit Postleitzahlen, Orten und Verwaltungseinheiten. Die Grenzen liegen bei der Straßenebene, der Aktualität und der fehlenden Verfügbarkeitszusage.

Gehört eine PLZ immer zu genau einem Ort?

Nein. Eine Postleitzahl kann mehrere Gemeinden abdecken, und eine Gemeinde kann mehrere Postleitzahlen haben. Die PLZ ist ein Zustellmerkmal, keine Verwaltungsgrenze.

Wie prüfe ich, ob eine Postleitzahl existiert?

Ein regulärer Ausdruck bestätigt nur das Format aus fünf Ziffern. Ob es die PLZ gibt und ob sie zum eingegebenen Ort passt, beantwortet nur ein Abgleich gegen einen Referenzbestand.

Welche Koordinaten liefert eine PLZ-Abfrage?

In der Regel den Mittelpunkt des PLZ-Gebiets. Das genügt für Umkreissuche und Auswertung, nicht für Navigation zu einer bestimmten Hausnummer.

Wie baue ich eine Umkreissuche?

Sie ermitteln den Punkt zur Ausgangs-PLZ und suchen alle Einträge innerhalb eines Radius. Achten Sie darauf, ob Sie Luftlinie oder Straßenentfernung brauchen; für Liefer- und Servicegebiete ist meist die Straßenentfernung die realistischere Größe.