Adressvalidierung per API: Adressen in Echtzeit prüfen

Sie haben eine Adresse in einem Formularfeld oder einer Datenbankspalte. Sie wollen wissen, ob sie existiert, sie in einheitlicher Form zurückbekommen und speichern. Das ist ein HTTP-Aufruf, und dieser Artikel beschreibt, was hineingeht und was zurückkommt.

Wenn Sie noch grundsätzlich entscheiden, ob Sie das brauchen, ist unser Überblick zum Thema Adressprüfung der bessere Einstieg. Diese Seite setzt die Entscheidung voraus.

Was eine Adressvalidierungs-API zurückgibt

Drei Dinge, in aufsteigender Nützlichkeit:

Ein Ergebnis. Wurde die Adresse gefunden, und wie gut? Behandeln Sie das als Aufzählung, nicht als Ja-Nein: exakter Treffer, Treffer mit Korrektur, mehrdeutig, kein Treffer.
Eine normalisierte Adresse. Die Bestandteile getrennt in Feldern, einheitlich geschrieben, damit zwei Datensätze desselben Gebäudes vergleichbar werden.
Anreicherung. Koordinaten, Gemeinde, Bundesland und weitere Angaben, die Sie vorher nicht hatten.

Auf das Ergebnis verzweigt Ihr Code. Die normalisierte Adresse speichern Sie. Die Anreicherung ist der Grund, warum sich der Aufruf überhaupt lohnt.

Was Sie mitschicken

Für Deutschland brauchen Sie Postleitzahl, Ort und Straße, dazu Hausnummer und Zusatz. Wer die Adresse erst noch einsammeln muss, lässt sie Feld für Feld vorschlagen, statt den Kunden alles tippen zu lassen.

Die vollständige Anfrage, die Felder der Antwort und das Verhalten bei einem Ausfall stehen in der Entwicklerdokumentation.

Die Antwort auswerten

Behandeln Sie drei Fälle ausdrücklich.

Exakter Treffer. Speichern Sie die normalisierte Adresse. Bewahren Sie die ursprüngliche Eingabe separat auf, falls Sie später eine Abweichung erklären müssen.

Treffer mit Korrektur. Die API hat die Adresse gefunden, aber etwas geändert: eine Schreibweise, einen fehlenden Ort, eine umformatierte PLZ. Zeigen Sie die Korrektur und lassen Sie den Kunden zustimmen. Eine stille Überschreibung der Eingabe ist der Weg zur Lieferung in die falsche Hauptstraße.

Kein Treffer oder mehrdeutig. Nicht blockieren. Zeigen Sie die nächstliegenden Vorschläge, und wenn keiner passt, lassen Sie den Kunden seine Eingabe bestätigen und markieren Sie den Datensatz als ungeprüft. Neubaugebiete sind hier der häufigste berechtigte Fall.

Teiltreffer und Sonderfälle

Die Fälle, die in der Praxis Probleme machen:

Hausnummernzusätze. „117a", „117 a" und „117A" meinen dieselbe Tür. Speichern Sie den Zusatz in einem eigenen Feld statt ihn an die Straße zu hängen.
Packstationen und Postfächer. Gültige Zustellwege, aber keine Hausanschriften. Wer ausschließlich gegen Hausanschriften prüft, weist echte Kunden ab.
Firmenzusätze und „c/o". Gehören nicht in die Adressprüfung. Halten Sie sie in einem eigenen Empfängerfeld.
Neubau. Existiert real, fehlt im Bestand. Übersteuerung zulassen.
Umlaute. Normalisieren Sie vor dem Vergleich, sonst erzeugen „Invalidenstraße" und „Invalidenstrasse" zwei Datensätze.

Massenprüfung und Rate Limits

Für eine einmalige Bereinigung des Bestands nutzen Sie, sofern vorhanden, den Stapelweg des Anbieters. Wenn Sie über Einzelaufrufe iterieren, gelten drei Regeln:

Das Aufruflimit beachten und bei einer Drosselung kurz warten statt sofort erneut zu senden.
Zwischenspeichern. In jeder Kundendatenbank wiederholen sich Adressen. Ein lokaler Cache auf der normalisierten Eingabe senkt das Aufrufvolumen erheblich.
Zwischenstände sichern. Ein Lauf, der nach einer Stunde von vorn beginnen muss, wird nie fertig.

Wenn es eher um Bestandsdaten als um den Checkout geht, ist Adressabgleich und Adressbereinigung der passendere Artikel.

Was Pro6PP anbietet

Pro6PP liefert Adressvalidierung, Vervollständigung, Eingabevorschläge, Umkreissuche und Geokodierung für Deutschland. Dieselbe API und dasselbe Antwortformat decken die Niederlande, Belgien, Frankreich, Luxemburg, Dänemark, Österreich, die Schweiz, Spanien und das Vereinigte Königreich ab. Der Ländercode steht im Pfad, die Struktur der Antwort bleibt gleich, was den DACH-Raum zu einer Integration statt drei macht.

Wenn Sie lieber ein fertiges Produkt kaufen als selbst zu integrieren, ordnet Adressvalidierung-Software die Anbietertypen ein.

Häufige Fragen

Wie validiere ich eine Adresse per API?

Sie senden die Adressbestandteile mit Ihrem Schlüssel an den Endpunkt des Anbieters und erhalten ein Trefferergebnis, die Adresse in normalisierten Feldern und meist Koordinaten zurück. Verzweigen Sie auf das Ergebnis statt die Antwort als reines Ja-Nein zu behandeln.

Client oder Server?

Server, sobald der Schlüssel abgerechnet oder limitiert ist. Ein Schlüssel im Browser-JavaScript ist für jeden auslesbar.

Was tun, wenn die API ausfällt?

Kunden durchlassen und den Datensatz als ungeprüft markieren. Eine Bestellung wegen eines Drittanbieterausfalls zu blockieren verwandelt ein Infrastrukturproblem in Umsatzverlust.

Wie schnell muss die Prüfung sein?

So schnell, dass sie den Checkout nicht spürbar verlangsamt. Eine Adressprüfung, die mehrere hundert Millisekunden hinzufügt, kostet Sie Konversion und damit genau das, was sie einsparen soll.

Ist Adressvalidierung DSGVO-relevant?

Ja, Adressen sind personenbezogene Daten. Regeln Sie Auftragsverarbeitung, Serverstandort und Speicherfristen, und senden Sie nur die für die Prüfung notwendigen Felder.