Adressvalidierung und PLZ-API für die Schweiz

Sie haben eine Schweizer Adresse in einem Formularfeld und wollen wissen, ob es sie gibt. Das ist ein HTTP-Aufruf, und dieser Beitrag beschreibt, was hineingeht, was zurückkommt, und worauf Sie in der Schweiz besonders achten müssen.

Was hineingeht und was zurückkommt

Sie schicken Postleitzahl, Ort und Strasse, dazu die Hausnummer. Zurück kommt die Adresse in getrennten Feldern, mit Ortschaft, Gemeinde und Koordinaten. Wer die Adresse erst einsammeln muss, lässt PLZ, Ort, Strasse und Hausnummer einzeln vorschlagen.

Die Parameter, die Felder der Antwort und ein fertiges Codebeispiel stehen in der Entwicklerdokumentation.

Drei Antworten, drei Reaktionen

Exakter Treffer. Normalisierte Adresse speichern, ursprüngliche Eingabe separat aufbewahren.

Treffer mit Korrektur. Korrektur anzeigen und bestätigen lassen. Gerade in der Schweiz häufig, weil Strasse und Strassenname unterschiedlich geschrieben werden und Ortsnamen zweisprachig sind.

Kein Treffer. Nicht blockieren. Vorschläge zeigen, sonst bestätigen lassen und den Datensatz markieren.

Schweizer Sonderfälle

Die Punkte, an denen eine für Deutschland gebaute Prüfung stolpert:

Vier statt fünf Ziffern. Ein Feld mit fester Länge fünf lehnt jede Schweizer Adresse ab.
Strasse gegen Strasse mit ss. In der Schweiz wird durchgehend ss statt ß geschrieben. Vergleiche ohne Normalisierung erzeugen Dubletten.
Zweisprachige Ortsnamen. Genf und Genève sind derselbe Ort. Über eine Kennung vergleichen, den Namen nur anzeigen.
Liechtenstein. Nutzt Schweizer PLZ von 9485 bis 9498. Das Land gehört in ein eigenes Feld, siehe Versand in die Schweiz.
Postfächer. Gültige Zustellwege, aber keine Hausadressen. Wer nur gegen Hausadressen prüft, weist echte Kunden ab.

Umkreissuche

Für Filialfinder, Servicegebiete und Liefergebiete brauchen Sie nicht nur eine Adresse, sondern alles im Umkreis. Der Ablauf ist immer derselbe: Koordinaten des Ausgangspunkts ermitteln, dann alle Einträge innerhalb eines Radius suchen.

Die eine Entscheidung, die zählt: Luftlinie oder Strasse. In der Schweiz ist der Unterschied besonders gross, weil Berge und Seen dazwischenliegen. Zwei Orte, die auf der Karte zwanzig Kilometer auseinanderliegen, können über die Strasse eine Stunde entfernt sein. Für Liefer- und Servicegebiete ist die Strassenentfernung deshalb fast immer die ehrlichere Grösse.

Post-Angebote oder kommerzielle API?

Die Schweizerische Post bietet eigene Adressdienste an, und für rein postalische Anwendungsfälle mit grossem Briefvolumen sind sie der naheliegende Weg, weil sie gegen den Bestand des Zustellers arbeiten.

Eine kommerzielle API lohnt sich, wenn mindestens einer dieser Punkte zutrifft:

Sie brauchen mehr als die Schweiz, typischerweise DACH mit Deutschland und Österreich in einem Antwortformat.
Die Prüfung sitzt im Checkout und muss in Millisekunden antworten, nicht im Stapelbetrieb.
Sie brauchen Funktionen über die Prüfung hinaus, etwa Umkreissuche oder Entfernungsberechnung.

Was Pro6PP anbietet

Pro6PP deckt die Schweiz mit Adressvalidierung, Vervollständigung, Eingabevorschlägen, Umkreissuche, Geokodierung und Entfernungsberechnung ab, und dieselbe API mit demselben Antwortformat gilt für Deutschland, Österreich, die Niederlande, Belgien, Frankreich, Luxemburg, Dänemark, Spanien und das Vereinigte Königreich.

Für den Einstieg ins Schweizer Postleitzahlensystem siehe PLZ Schweiz: Karte, Liste und Suche; die Datenmodell-Frage behandelt PLZ, Ortschaft und Gemeinde.

Häufige Fragen

Gibt es eine kostenlose PLZ-API für die Schweiz?

Es gibt offene Datensätze mit Postleitzahlen und Ortschaften. Für vollständige Adressen mit Strasse und Hausnummer sowie für eine Verfügbarkeitszusage brauchen Sie in der Regel einen kommerziellen Dienst.

Warum lehnt mein Formular Schweizer Adressen ab?

Meist wegen einer festen Länge von fünf Ziffern im PLZ-Feld. Die Schweiz hat vier.

Wie gehe ich mit ß und ss um?

In der Schweiz wird ss geschrieben. Normalisieren Sie vor jedem Vergleich, sonst entstehen zwei Datensätze für dieselbe Strasse.

Luftlinie oder Strassenentfernung?

In der Schweiz fast immer Strassenentfernung, weil Berge und Seen die Luftlinie unrealistisch machen.

Muss ich für Liechtenstein etwas Besonderes tun?

Ja: das Land als eigenes Feld führen. Postalisch liegt es im Schweizer Raum und nutzt Schweizer PLZ, rechtlich ist es ein eigener Staat.