Die US Adressstruktur wirkt von außen einfach: eine Nummer, eine Straße, ein Ort, ein Bundesstaatskürzel und eine Postleitzahl. Genau wegen dieser Einfachheit behandeln viele Formulare sie schlecht — die Teile, die fest aussehen, sind nämlich die Teile mit Regeln, und die Teile, die variieren, sind die, für die niemand Platz lässt.
Dieser Artikel zerlegt die Struktur Feld für Feld, behandelt die Einheitsnummer und die Postleitzahlerweiterung und erklärt, warum Militär- und Außengebietsadressen außerhalb des Musters liegen, das die meisten Entwickler erwarten.
Die Bestandteile einer US-Adresse
Eine inländische Postanschrift besteht aus wenigen Komponenten, die üblicherweise auf drei oder vier Zeilen stehen.
| Komponente | Was sie enthält | Hinweise |
|---|---|---|
| Straßenzeile | Hausnummer, Straßenname, Straßenart, Richtung | Die Straßenart ist Teil des Namens und keine Ausschmückung |
| Einheitszeile | Apartment, Suite, Etage, Gebäude | Optional und konventionell in einer eigenen Zeile |
| Ort, Bundesstaat, Postleitzahl | Stadt oder Ort, zweibuchstabiges Kürzel, ZIP | Das Kürzel ist standardisiert; erfinden Sie keines |
| Land | Nur bei internationaler Post | Innerhalb des Landes entfällt es |
Die Straßenzeile selbst hat eine interne Reihenfolge, die man kennen sollte: ein Richtungspräfix, der Straßenname, die Straßenart und ein Richtungssuffix, wo eines existiert. Die Hausnummer führt. Diese Ordnung ist eine Konvention des Landes und keine allgemeine, weshalb dasselbe Gebäude in anderen Ländern mit der Nummer am Ende erscheint, wie der Leitfaden zum internationalen Adressformat darlegt.
Hausnummern, Straßenarten und Richtungen
Die Hausnummer ist eine führende Ganzzahl, und sie ist insofern wirklich eine Zahl, als ungerade und gerade Seiten für die Zustellung zählen — aber sie ist keine Menge, und sie als Menge zu behandeln erzeugt eine eigene Fehlerklasse. Es gibt Bereiche, es gibt alphanumerische Zusätze, und eine einzelne Straße kann Nummern tragen, die beim Überqueren von Gemeindegrenzen nicht fortlaufend sind.
Straßenarten sind Wörter wie Street, Avenue, Road, Boulevard, Drive, Lane oder Court, und sie folgen normalerweise dem Namen. Richtungsangaben wie North, South, East und West können vor dem Namen, nach der Straßenart oder an beiden Stellen stehen. Ausgeschrieben und abgekürzt hat dieselbe Adresse mehrere korrekte Schreibweisen, weshalb Postbetreiber Abkürzungstabellen pflegen und weshalb ein Formular normalisieren sollte, statt eine bestimmte Schreibweise zu verlangen.
Für Testdaten ist die nützliche Konsequenz, dass die Straßenzeile das Feld ist, das am ehesten die erwartete Länge überschreitet, weil sie ein Richtungspräfix, einen mehrteiligen Namen, eine Straßenart und manchmal einen Einheitszusatz in einer Zeichenkette sammelt.
Wie schreiben Sie eine Wohnungs- oder Suitenummer?
Setzen Sie sie in eine eigene Zeile oder hinter die Straßenzeile, getrennt durch ein deutliches Kennzeichen, und beschriften Sie sie mit dem lokalen Wort: Apartment, Unit, Suite, Floor, Building. Der Abkürzungsstil folgt denselben Konventionstabellen wie die Straßenart, weshalb Einheitlichkeit wichtiger ist als Kürze.
Die Modellierungsfrage lautet, ob die Einheit in das Straßenfeld oder in ein eigenes Feld gehört. Halten Sie sie getrennt. Ein an die Straßenzeile gehängter Einheitszusatz macht die Straße schwerer mit einer Adressliste abgleichbar und unmöglich zuverlässig durchsuchbar, und er geht zuerst verloren, wenn ein Feld abgeschnitten wird. Er erzeugt auch Mehrdeutigkeit in der anderen Richtung: Eine Gebäudenummer und eine Einheitsnummer hintereinander sehen für alles, was von links parst, wie Teil einer längeren Straßenadresse aus.
Für zustellrelevante Testfälle verdienen beide Varianten eine Fixture: eine Adresse ganz ohne Einheit und eine mit einer langen Einheitsangabe. Viele Systeme scheitern an der zweiten stillschweigend.
Was Bundesstaatskürzel und ZIP bedeuten
Die Komponente Bundesstaat ist ein zweibuchstabiges Kürzel aus einer amtlichen Norm, und sie ist kein Freitextfeld. Ein Kürzel zu erfinden, den Staatsnamen dort auszuschreiben, wo ein Code erwartet wird, oder einen Code zu verwenden, der zu einem anderen Ort gehört, erzeugt jedes Mal Daten, die plausibel aussehen und später scheitern. Die größere Familie der Länder- und Unterteilungscodes und der Unterschied zwischen internationaler Norm und lokalen Codelisten sind im Leitfaden zu ISO-Ländercodes und Unterteilungscodes beschrieben.
Die Postleitzahl hat fünf Ziffern und optional eine vierstellige Erweiterung, die den Code auf eine kleinere Zustellgruppe eingrenzt. Beide Formen sind gültig; die Erweiterung ist in der Praxis optional, und Formulare, die sie verlangen, ärgern Nutzer, die ihre eigene nicht kennen. Behandeln Sie das Ganze als Text. Eine Postleitzahl ist ein Identifikator, und die führenden Nullen, die in manchen Landesteilen vorkommen, verschwinden in dem Moment, in dem eine numerische Spalte sie ergreift, wie der Leitfaden zu Postleitzahlformaten nach Land ausführlich erklärt.
Der klassische Konsistenztest verbindet beide. Ein Bundesstaatskürzel, das nicht zu den Postleitzahlbereichen dieses Staates passt, ist einer der häufigsten Erfassungsfehler in US-Adressdaten, und er ist billig zu erkennen.
Gelten für Außengebiete und Militäradressen dieselben Regeln?
Teilweise. Adressen in US-Außengebieten haben dieselbe Grundform, aber eigene staatsäquivalente Codes und eigene Postleitzahlbereiche, sodass eine Prüfliste, die nur aus den fünfzig Bundesstaaten gebaut ist, sie zurückweist, obwohl sie einwandfrei zustellbar sind. Militärpost hat ebenfalls eine eigene Struktur, mit einer Leitwegbezeichnung und einem Code, der in der Inlandspost die Rolle von Ort und Bundesstaat übernimmt.
Die richtige Schlussfolgerung ist nicht, eine längere Liste fest codierter Sonderfälle zu bauen und zu hoffen, dass sie vollständig ist. Sie lautet: Akzeptieren Sie, dass die Menge gültiger Codes größer ist als die vertraute, beziehen Sie die Liste aus einer autoritativen Quelle, statt sie von Hand zu tippen, und lassen Sie die Prüfung so scheitern, dass der Nutzer den Fehler beheben kann.
Für Entwickler: die Bestandteile in der richtigen Reihenfolge prüfen
Prüfen Sie die Bestandteile und nicht die ganze Zeile. Ein einzelner regulärer Ausdruck, der eine gesamte US-Adresszeichenkette validieren soll, ist der häufigste Fehler in diesem Bereich, denn die Variation steckt in der Straßenzeile und die Gewissheit im Bundesstaatskürzel und in der Postleitzahl.
Eine praktikable Reihenfolge: Verlangen Sie ein Land, damit der Regelsatz bekannt ist, prüfen Sie, ob das Bundesstaatskürzel in der amtlichen Liste steht, prüfen Sie, ob die Postleitzahl ihrer Form entspricht, und prüfen Sie dann die Paarung zwischen beiden. Überlassen Sie die Straßenzeile den Längen- und Zeichenprüfungen, und lassen Sie einen Menschen eine Ablehnung übersteuern, denn eine wirklich korrekte Adresse, die ein Prüfer nicht erkennt, darf nicht unbearbeitbar werden.
Zwei Fixtures decken den größten Teil des Risikos ab: eine Adresse, die in jeder Hinsicht gültig ist, und dieselbe Adresse mit einer einzigen absichtlichen Unstimmigkeit zwischen Bundesstaat und Postleitzahl. Dieses Paar macht sofort sichtbar, wenn eine Änderung an der Prüfung versehentlich anfängt, alles zu akzeptieren.
Nächste Schritte
Nehmen Sie eine US-Adresse aus Ihren Staging-Daten und zerlegen Sie sie von Hand in ihre Felder; wenn Sie nicht eindeutig sagen können, welcher Text zur Einheit und welcher zur Straße gehört, verbirgt Ihre Fixture ein Modellierungsproblem. Erzeugen Sie dann einen kleinen Satz US-Beispiele im Adressgenerator und schicken Sie sie durch Ihr Formular, darunter eines mit einer langen Einheitsangabe und eines, dessen Bundesstaat und Postleitzahl absichtlich nicht zusammenpassen. Denken Sie daran, was die bestandenen Beispiele sind: Platzhalterwerte für Softwaretests, keine zustellbare Post und kein Nachweis darüber, wo jemand wohnt.