De structuur van een Amerikaans adres lijkt van buiten eenvoudig: een nummer, een straat, een plaats, een staatafkorting en een postcode. Die eenvoud is de reden waarom zoveel formulieren het slecht doen — de delen die vast lijken te liggen zijn juist de delen die regels dragen, en de delen die variëren zijn degene waarvoor niemand ruimte laat.
Dit artikel ontleedt de structuur veld voor veld, behandelt het unitnummer en de postcode-uitbreiding, en legt uit waarom militaire en territoriale adressen buiten het patroon vallen dat de meeste ontwikkelaars verwachten.
De delen van een Amerikaans adres
Een binnenlands postadres is opgebouwd uit een kleine set componenten, meestal over drie of vier regels gerangschikt.
| Component | Wat het bevat | Opmerkingen |
|---|---|---|
| Straatregel | Huisnummer, straatnaam, straattype, richting | Het straattype maakt deel uit van de naam, niet decoratie |
| Unitregel | Appartement, suite, verdieping, gebouw | Optioneel, en conventioneel op een eigen regel |
| Plaats, staat, postcode | Plaats of stad, tweeletterige staatscode, ZIP-code | De staatscode is gestandaardiseerd; verzin er geen |
| Land | Alleen op internationale post | Weggelaten binnen het land |
De straatregel zelf heeft een interne volgorde die het kennen waard is: een richtingsvoorvoegsel, de straatnaam, het straattype, en een richtingsachtervoegsel waar dat bestaat. Het huisnummer gaat voorop. Die ordening is een conventie van het land, niet universeel, en daarom verschijnt hetzelfde gebouw in andere landen met het nummer aan het eind, zoals de gids over het internationale adresformaat uiteenzet.
Huisnummers, straattypen en richtingen
Het huisnummer is een leidend geheel getal, en het is werkelijk een getal in de zin dat oneven en even zijden ertoe doen voor bezorging — maar het is geen hoeveelheid, en het als zodanig behandelen levert zijn eigen klasse bugs op. Er bestaan reeksen, er bestaan alfanumerieke achtervoegsels, en één straat kan nummers dragen die niet aaneengesloten zijn wanneer hij gemeentegrenzen kruist.
Straattypen zijn woorden als street, avenue, road, boulevard, drive, lane of court, en ze volgen normaal de naam. Richtingselementen zoals noord, zuid, oost en west kunnen vóór de naam, na het type, of op beide plaatsen voorkomen. Voluit geschreven en afgekort heeft hetzelfde adres verschillende correcte spellingen, en precies daarom onderhouden postoperatoren afkortingstabellen en zou een formulier moeten normaliseren in plaats van één specifieke weergave te eisen.
Voor testdata is het nuttige gevolg dat de straatregel het veld is dat het waarschijnlijkst de verwachte lengte overschrijdt, omdat hij een richtingsvoorvoegsel, een naam van meerdere woorden, een straattype en soms een unitkwalificatie in één tekenreeks ophoopt.
Hoe schrijf je een appartement- of suitenummer?
Zet het op een eigen regel, of na de straatregel gescheiden door een duidelijke markering, en label het met het lokale woord: appartement, unit, suite, verdieping, gebouw. De afkortingsstijl volgt dezelfde conventietabellen als het straattype, dus consistentie is belangrijker dan beknoptheid.
De modelleervraag is of de unit in het straatveld of in een eigen veld hoort. Houd het apart. Een unitdetail dat aan de straatregel wordt toegevoegd, maakt de straat moeilijker te matchen tegen welke adreslijst dan ook en onmogelijk om betrouwbaar te doorzoeken, en het is het eerste dat verloren gaat wanneer een veld wordt afgekapt. Het creëert ook dubbelzinnigheid in de andere richting: een gebouw- en een unitnummer die achter elkaar worden geschreven, lijken voor alles wat van links parseert op onderdeel van een langer straatadres.
Voor bezorgrelevante testgevallen verdienen beide varianten een fixture: een adres zonder enige unit, en een met een lang unitdetail. Veel systemen falen stilzwijgend op de tweede.
Wat de staatafkorting en ZIP-code betekenen
De staatcomponent is een tweeletterige afkorting uit een officiële standaard, en het is geen vrij tekstveld. Een afkorting verzinnen, de staatsnaam voluit spellen waar een code wordt verwacht, of een code gebruiken die bij een andere plaats hoort, levert allemaal gegevens op die plausibel lijken en later falen. De bredere familie van land- en onderindelingscodes, en het verschil tussen de internationale standaard en lokale codelijsten, wordt behandeld in de gids over ISO-land- en onderindelingscodes.
De postcode bestaat uit vijf cijfers, optioneel gevolgd door een uitbreiding van vier cijfers die de code vernauwt tot een kleinere bezorggroep. Beide vormen zijn geldig; de uitbreiding is in de praktijk optioneel, en formulieren die haar eisen irriteren gebruikers die de hunne niet kennen. Behandel het geheel als tekst. Een postcode is een identificatie, en de voorloopnullen die sommige delen van het land gebruiken verdwijnen zodra een numerieke kolom er vat op krijgt, zoals de gids over postcodeformaten per land uitvoerig uitlegt.
De klassieke consistentietest koppelt de twee. Een staatafkorting die niet overeenkomt met het bereik aan postcodes voor die staat is een van de meest voorkomende invoerfouten in Amerikaanse adresgegevens, en ze is goedkoop op te sporen.
Volgen territoriale en militaire adressen dezelfde regels?
Gedeeltelijk. Adressen in Amerikaanse territoria gebruiken dezelfde algemene vorm maar met hun eigen staat-equivalente codes en hun eigen postcodebereiken, dus een validatielijst die alleen uit de vijftig staten is opgebouwd, wijst ze af hoewel ze volkomen bezorgbaar zijn. Militaire post heeft ook zijn eigen structuur, met een routeringsaanduiding en een code die de rol van plaats en staat in binnenlandse post speelt.
De juiste conclusie is niet om een langere lijst met hardgecodeerde speciale gevallen te bouwen en te hopen dat die compleet is. Het is om te accepteren dat de set geldige codes groter is dan de bekende, om de lijst uit een gezaghebbende referentie te halen in plaats van hem met de hand te typen, en om validatie te laten falen op een manier die de gebruiker kan corrigeren.
Voor ontwikkelaars: de delen in de juiste volgorde valideren
Controleer de delen, niet de hele regel. Een enkele reguliere expressie die een volledige Amerikaanse adresreeks probeert te valideren is de meest voorkomende fout op dit gebied, omdat de variatie in de straatregel zit en de zekerheid in de staatscode en de postcode.
Een praktische volgorde: eis een land zodat de regelset bekend is, controleer of de staatscode in de officiële lijst voorkomt, controleer of de postcode aan zijn vorm voldoet, en controleer dan de koppeling tussen beide. Laat de straatregel aan lengte- en tekencontroles over, en laat een mens een afwijzing overschrijven, want een werkelijk correct adres dat een controleur niet herkent mag niet onbewerkbaar zijn.
Twee fixtures dekken het meeste risico: één adres dat in elk opzicht geldig is, en hetzelfde adres met één opzettelijke inconsistentie tussen staat en postcode. Dat paar maakt het overduidelijk wanneer een validatiewijziging per ongeluk alles begint te accepteren.
Volgende stappen
Neem één Amerikaans adres uit je staging-gegevens en splits het met de hand in zijn velden; als je niet ondubbelzinnig kunt zeggen welke tekst bij de unit hoort en welke bij de straat, verbergen je fixtures een modelleerprobleem. Produceer daarna een kleine set Amerikaanse voorbeelden in de adresgenerator en voer ze door je formulier, inclusief één met een lang unitdetail en één waarvan staat en postcode opzettelijk van elkaar afwijken. Onthoud wat de slagende voorbeelden zijn: plaatsvervangende waarden voor softwaretesten, geen bezorgbare post en geen bewijs van waar iemand woont.