Ein Adressgenerator für die Türkei erzeugt türkische Adressen, die den Postkonventionen des Landes folgen statt einer englischsprachigen Annäherung daran. Die Hierarchie läuft von der Provinz bis hinunter zur Straße, die Postleitzahl hat immer fünf Ziffern, und die Schreibreihenfolge stellt die größte Verwaltungseinheit nach vorn. Genau diese Reihenfolge drehen viele internationale Formulare stillschweigend um, und es fällt niemandem auf.
Dieser Leitfaden erklärt, wie eine türkische Adresse aufgebaut ist, wie die einundachtzig Provinzen mit Postleitzahlen und Telefonvorwahlen zusammenhängen, warum die gepunkteten und ungepunkteten Buchstaben des Türkischen echte Fehler in Adressfeldern verursachen und wofür ein erzeugter Datensatz einstehen kann und wofür nicht. Am Ende sollten Sie beurteilen können, ob eine türkische Adresse in Ihren Testdaten nur plausibel aussieht oder tatsächlich in sich stimmig ist.
Wie ist eine türkische Adresse geordnet?
Eine türkische Adresse wird von der größten Einheit zur kleinsten geschrieben, und der Postdienst erwartet diese Reihenfolge, sobald die Adresse auf einem einzigen Etikett steht. Zuerst kommt die Provinz (İl), dann der Bezirk (İlçe), dann das Viertel (Mahalle) oder das Dorf (Köy), dann die Straße oder der Boulevard (Cadde, Sokak), dann die Hausnummer (Kapı No), dann die Wohnungsnummer innerhalb des Gebäudes (Daire) und schließlich die fünfstellige Postleitzahl (Posta Kodu), gefolgt vom Provinz- oder Bezirksnamen.
Diese Richtung von groß nach klein ist das Gegenteil der Vereinigten Staaten und des Vereinigten Königreichs, wo die Straßenzeile führt und die Verwaltungseinheiten folgen. Die falsche Konvention in das falsche Land zu tragen, ist einer der zuverlässigsten Wege, eine Adresse zu erzeugen, die übersetzt aussieht. Wer eine einzige Adressvorlage für alle Länder baut, schreibt türkische Datensätze fast automatisch in amerikanischer Reihenfolge, weil beide als eine plausible Zeile gerendert werden.
Gebäude und Wohnung sind getrennte Werte und kein zusammengefasstes Einheitenfeld. Eine türkische Adresse unterscheidet die Hausnummer von der Nummer der Wohnung im Gebäude, und beide sind in der kompakten Form meist kleine ganze Zahlen ohne Einheitenwort. Hausnummern können zusätzlich einen Buchstaben tragen, wenn ein Grundstück geteilt wurde, sodass ein auf Ziffern begrenztes Feld einen gültigen Zugang ablehnt. Systeme, die beide Nummern in einem Feld zusammenwerfen, verlieren Informationen, die türkische Zusteller und Gemeinden routinemäßig nutzen.
Ein typischer Datensatz trägt daher mindestens sieben Adressteile, und jedes davon hat eigene Regeln:
- Provinz mit Name und zweistelligem Plaka Kodu
- Bezirk, immer genau einer Provinz zugeordnet
- Viertel oder Dorf, immer genau einem Bezirk zugeordnet
- Straße oder Boulevard mit Namen
- Hausnummer, Ziffern mit optionalem Buchstabenanhang
- Wohnungsnummer, ein- bis dreistellig
- fünfstellige Postleitzahl, passend zum Bezirk
Wer diese Liste in einer Tabelle ablegt, sieht sofort, welche Felder voneinander abhängen und welche unabhängig bleiben. Nur die Straßenbezeichnung und die Hausnummer sind innerhalb der Hierarchie frei; alles andere wird von der Ebene darüber bestimmt.
Was leisten die Ebenen Provinz, Bezirk und Viertel?
Die erste Ebene ist die Provinz, und die Türkei hat einundachtzig davon. Provinzen werden in Formularen häufig über ihren zweistelligen Plaka Kodu abgekürzt statt über den Namen. Eine Testsuite, die nur Provinznamen durchspielt, berührt den numerischen Pfad also nie. Ein gut geformter Datensatz sollte beide Darstellungen je Provinz mitführen, damit beide Feldtypen geprüft werden können.
Unter der Provinz sitzt der Bezirk, und unter dem Bezirk das Viertel oder das Dorf. Das Viertel ist die Ebene, für die die meisten ausländischen Adressmodelle kein Gegenstück haben, weshalb sie in internationalen Formularen am häufigsten fehlt und später auffällt, wenn sich ein türkischer Nutzer beschwert. Postleitzahlen werden in der Türkei feiner als auf Provinzebene vergeben, sodass die Postleitzahl den Ort erheblich eingrenzt, sobald sie mit dem richtigen Bezirk gepaart ist.
Weil die Ebenen streng geschachtelt sind, sind es auch die Konsistenzregeln. Ein Bezirk gehört zu genau einer Provinz, ein Viertel zu genau einem Bezirk, und eine Postleitzahl zu einer kleinen Menge von Vierteln. Jeder Datensatz, in dem Bezirk und Provinz einander widersprechen, ist nicht subtil falsch, sondern unmöglich, und eine Prüfung dieses Paares fängt ihn sofort ab.
Praktisch heißt das: Die Auswahlreihenfolge im Formular muss die Schachtelung nachbilden. Wählen Sie zuerst die Provinz, dann den Bezirk aus der gefilterten Liste, dann das Viertel aus der gefilterten Liste darunter. Jede Ebene ohne Filter der Ebene darüber erzeugt Kombinationen, die es nicht gibt, und die Fehlermeldung landet später bei der Supportabteilung statt beim Entwickler.
Für Testdaten ist die Schachtelung der eigentliche Wert. Eine flache Liste von Provinznamen lässt sich in wenigen Minuten aus dem Gedächtnis nachbauen; eine geschachtelte Struktur mit korrekten Bezirks- und Viertelzuordnungen ist genau das Stück Arbeit, das ein Generator abnimmt. Deshalb ist die Frage nicht, wie viele Provinzen ein Werkzeug aufzählt, sondern ob die unteren Ebenen aus den oberen abgeleitet werden.
Warum müssen Postleitzahl und Provinz zusammenpassen?
Türkische Postleitzahlen haben fünf Ziffern, und die führenden Stellen tragen geografische Bedeutung, die an Provinz und Großregion gebunden ist. Die praktische Folge: Eine zufällig aus dem gesamten fünfstelligen Raum gezogene Postleitzahl zeigt fast immer auf einen Ort, der mit der Provinz im selben Datensatz nichts zu tun hat.
Das ist dieselbe Fehlerklasse, die in jedem Land auftritt, und es lohnt die Wiederholung, weil sie so häufig ist: Ein einzelnes Feld kann perfekt formatiert und trotzdem falsch sein. Fünf Ziffern bleiben fünf Ziffern. Was einen türkischen Datensatz brauchbar macht, ist die Entsprechung der Ziffern zur daneben erfassten Provinz.
Generatoren vermeiden das, indem sie zuerst die Provinz wählen und daraus Bezirk, Viertel und Postleitzahl ableiten, niemals umgekehrt. Wenn Sie ein Werkzeug mit angeblicher Türkei-Abdeckung beurteilen, ist diese Ableitungsrichtung die Stelle, an der Sie ansetzen sollten. Fragen Sie mehrere Datensätze für eine einzige Provinz an und prüfen Sie, ob die Postleitzahlen sinnvoll clustern oder über den gesamten Zahlenraum streuen.
Die Telefonvorwahl folgt demselben Prinzip. Türkische Festnetzvorwahlen bilden Provinzen ab, sodass eine Telefonnummer mit der Vorwahl einer Stadt und einer Adresse in einer anderen Stadt eine Unstimmigkeit ergibt, die eine sorgfältige Testsuite abfangen sollte. Mobilnummern verhalten sich anders, weil sie portierbar sind und keine Region mehr anzeigen. Ein türkischer Testdatensatz darf daher nur die Festnetzbeziehung behaupten. Die Seite Adresse vertieft dieses Verhältnis zwischen Vorwahl und Ort.
Ein Prüfmuster, das sich in der Praxis bewährt hat, sieht vier Schritte vor:
- Provinz wählen und den Plaka Kodu mitführen
- Bezirk aus der geschachtelten Menge dieser Provinz wählen
- Postleitzahl gegen den Bezirk prüfen, nicht isoliert gegen eine globale Liste
- Festnetzvorwahl gegen die Provinz prüfen und Mobilnummern davon ausnehmen
Jede dieser Zeilen ist ein eigener Fehlerpfad. Wenn ein Formular alle vier anbietet, aber nur die Formatlänge kontrolliert, ist die Hälfte der möglichen Fehler bereits nicht mehr prüfbar.
Welche türkischen Buchstaben brechen Adressfelder?
Das Türkische schreibt den Buchstaben i in zwei Formen. Auf der einen Seite stehen das gepunktete große İ und das ungepunktete kleine ı, auf der anderen das ungepunktete große I und das gepunktete kleine i. Beide sind im Alphabet eigenständige Buchstaben und keine stilistischen Varianten eines Zeichens. Eine Groß- oder Kleinschreibung, die das ignoriert, beschädigt einen Städte- oder Straßennamen stillschweigend.
Der Fehler ist leise und deshalb gefährlich. Wird ein türkischer Ortsname mit einer generischen Routine in Großbuchstaben gewandelt, entsteht aus dem gepunkteten kleinen i ein gepunktetes großes İ, das für Wörter mit ungepunktetem Buchstaben schlicht falsch ist. Adressen passen dann nicht mehr zur Referenzliste, obwohl der Nutzer den Namen korrekt eingegeben hat, und der Fehlerbericht behauptet, die Adresse sei ungültig, während die Ursache die Groß- und Kleinschreibung ist. Umgekehrt gilt dasselbe: Das Kleinschreiben eines ungepunkteten großen I ergibt im Türkischen ein ungepunktetes kleines ı und in den meisten anderen Sprachen ein gepunktetes kleines i. Wer die zweite Annahme fest verdrahtet hat, speichert einen Wert, der später nicht mehr zuzuordnen ist.
Die folgende Gegenüberstellung zeigt, was bei naiver Umwandlung passiert:
| Eingabe | Erwartet im Türkischen | Naive Umwandlung | Folge |
|---|---|---|---|
| Istanbul, großgeschrieben | ISTANBUL mit ungepunktetem Großbuchstaben | gepunkteter Großbuchstabe | Abgleich schlägt fehl |
| IŞIK, kleingeschrieben | ışık mit ungepunktetem Kleinbuchstaben | gepunktetes kleines i | Wert passt nie wieder |
| İZMİR, kleingeschrieben | izmir mit gepunktetem kleinen i | ungepunktetes kleines ı | Suchtreffer fehlen |
Auch die Sortierung hat dasselbe Problem aus der anderen Richtung. Die türkische Sortierregel ordnet die gepunkteten und ungepunkteten Buchstaben an anderen Positionen ein als im Englischen. Eine Liste von Provinzen, die mit einer lateinischen oder englischen Kollation sortiert wurde, erscheint einem türkischen Nutzer zufällig durcheinandergewürfelt. Wenn Ihr Adressauswahlfeld serverseitig nach englischer Regel sortiert wird, ist das ein Fehler, den Sie vor allem anderen beheben sollten.
Der Zeichensatz selbst ist ebenfalls breiter als reines ASCII. Türkische Ortsnamen tragen das gepunktete i, das ungepunktete i, das c mit Cedille, das g mit Breve, das o und das u mit Trema sowie das s mit Cedille. Ein Feld, das bei der Eingabe Diakritika entfernt, verwandelt einen Teil davon in Buchstaben, die die Bedeutung des Namens ändern. Eine Normalisierung muss daher entweder verlustfrei umkehrbar oder bewusst zurückhaltend sein.
Für Testfälle lohnt sich ein bewusst gewählter Satz von Namen, der alle fünf Sonderbuchstaben abdeckt und je Fall einmal groß und einmal klein durch die eigene Pipeline läuft. Nur so wird sichtbar, ob die Umwandlung in der eigenen Anwendung stattfindet oder bereits in der Datenbank.
Wie sollten türkische Adressformulare aufgebaut sein?
Modellieren Sie die Adresse als geschachtelte Paare statt als Freitext plus Postleitzahl. Provinz und Plaka Kodu gehören zusammen, der Bezirk gehört zur gewählten Provinz, das Viertel gehört zum gewählten Bezirk, und die Postleitzahl wird gegen den Bezirk geprüft statt isoliert. Jede Ebene sollte durch die Ebene darüber gefiltert werden, was die meisten ungültigen Kombinationen verhindert, bevor sie eingetippt werden.
Geben Sie Hausnummer und Wohnungsnummer eigene Felder und eigene Längengrenzen. Türkische Hausnummern können einen Buchstabenanhang tragen, und Wohnungsnummern reichen in großen Blöcken bis in den dreistelligen Bereich. Ein Feld mit einem einzigen Zeichen scheitert also an gewöhnlichen Eingaben. Erlauben Sie die Postleitzahl mit und ohne trennendes Leerzeichen, und normalisieren Sie sie nach dem Speichern, statt sie an der Tür abzuweisen.
Wenn Sie zusätzlich ein internationales Formular anbieten, nehmen Sie das Viertel auch dann auf, wenn Ihre übrigen Länder es nicht verwenden. Ein Feld für fünfzig Länder optional zu lassen und für die Türkei erforderlich zu machen, kostet wenig im Schema und spart viel im Support. Ein Testdatensatz sollte mindestens einen türkischen Fall mit Viertel und einen ohne enthalten, damit beide Pfade durchlaufen werden.
Achten Sie außerdem auf die Grenzen der Freitextzeile. Die kompakte Schreibweise einer türkischen Adresse kann lang werden, weil Viertel, Straße und beide Nummern in einer Zeile stehen. Ein Eingabefeld mit einer Begrenzung, die für amerikanische Adressen bemessen wurde, schneidet genau dort ab, wo die türkische Adresse ihre zusätzlichen Ebenen entfaltet. Prüfen Sie die Grenze mit einem Datensatz, der ein langes Viertel und einen langen Straßennamen kombiniert.
Entspricht eine erzeugte türkische Adresse einem realen Ort?
Nein. Eine erzeugte türkische Adresse hat die korrekte Hierarchie, die korrekte Feldreihenfolge und eine zur Provinz passende Postleitzahl, also alles, was ein Formular, ein Parser oder eine Routingregel braucht, um durchlaufen zu werden. Sie bezeichnet kein reales Gebäude, sie ist auf niemanden registriert, und kein Zusteller könnte dorthin liefern.
Der bekannte Vorbehalt gilt in der Türkei mit einer zusätzlichen Wendung, weil die Zwischenebenen zahlreich sind und eine plausible Kombination von Hand recht leicht zusammengesetzt werden kann. Der Unterschied zwischen einem handgebauten und einem erzeugten Datensatz ist nicht das Aussehen der Felder, sondern die Tiefe der Beziehungen dahinter. Ein Generator leitet die unteren Ebenen aus den oberen ab; wer von Hand zusammensetzt, rät jede Ebene einzeln.
Öffentliches Referenzmaterial zu den türkischen Verwaltungsgliederungen wird vom nationalen Statistikamt gepflegt, und dessen veröffentlichte Listen sind die Art von Quelle, auf die ein gepflegter Datensatz zurückführbar sein sollte. Zu wissen, woher die Werte stammen, macht es möglich, sie später ohne Raten zu erneuern. Es macht zugleich den Unterschied zwischen einem Generator und einer Tabelle sichtbar: Eine Tabelle altert still, während ein Datensatz mit benannter Quelle gegen diese Quelle geprüft werden kann.
Für die Arbeit an Testdaten folgt daraus eine einfache Regel. Behandeln Sie jede erzeugte türkische Adresse als strukturell treues, aber inhaltlich erfundenes Beispiel. Sie ist gut genug, um Feldreihenfolge, Schachtelung, Zeichensatz und Längen Grenzen zu prüfen, und sie ist ungeeignet für alles, was eine echte Zustellung oder einen echten Personenbezug voraussetzt.
Was ist vor der Nutzung eines türkischen Datensatzes zu prüfen?
Prüfen Sie zuerst die Anzahl der Provinzen, denn ein Datensatz, dem Provinzen fehlen, hat auch an anderer Stelle Lücken. Prüfen Sie dann, ob Bezirke geschachtelt und nicht global hinterlegt sind und ob der Datensatz neben dem Provinznamen einen Plaka Kodu führt. Prüfen Sie anschließend die Zeichenbehandlung: Erzeugen Sie eine Provinz, deren Name einen ungepunkteten Buchstaben enthält, wandeln Sie den Datensatz in Ihrem eigenen Code in Großbuchstaben und stellen Sie fest, ob er das übersteht.
Prüfen Sie zuletzt die Reproduzierbarkeit. Derselbe Schlüssel und dasselbe Land sollten bei jedem Aufruf denselben Datensatz liefern, weil eine Adresse, die bei jedem Aufruf wechselt, nicht in einer Zusicherung verwendet werden kann. Ein Generator, der seine Ausgabe pro Anfrage neu mischt, taugt für eine manuelle Vorführung und ist für einen Regressionstest unbrauchbar; sichtbar wird der Unterschied erst, sobald die Ausgabe geprüft wird.
Die folgende Liste lässt sich als Abnahmeprüfung für einen Datensatz verwenden:
- alle einundachtzig Provinzen vorhanden, jeweils mit Name und Plaka Kodu
- Bezirke ausschließlich innerhalb ihrer Provinz auffindbar
- Viertel ausschließlich innerhalb ihres Bezirks auffindbar
- Postleitzahlen fünfstellig und passend zur Provinz geclustert
- Hausnummern mit optionalem Buchstabenanhang akzeptiert
- Zeichensatz mit allen fünf Sonderbuchstaben verlustfrei durch die eigene Pipeline geführt
- identische Eingabe liefert identische Ausgabe
Die Länderübersicht zur Türkei beschreibt, wie die Länderdaten organisiert sind, und die Prüfwerkzeuge eignen sich, um Formatregeln und Prüfziffern gegen eigene Beispieldaten zu testen. Der Adressgenerator ist die Stelle, an der Datensätze für die Türkei und die übrigen unterstützten Länder erzeugt und exportiert werden.
Jeder so erzeugte Datensatz ist synthetisch. Feldreihenfolge, Hierarchie und Beziehungen halten die veröffentlichten Formate ein, aber die Datensätze entsprechen keiner realen Person, keinem realen Grundstück und keiner realen Postzustellung. Sie dürfen nicht verwendet werden, um sich als jemand auszugeben, echte Post zu empfangen, eine Adresse nachzuweisen oder eine Identitäts- oder Aufenthaltsprüfung zu bestehen.