Soundex-Encoder
Robert und Rupert ergeben denselben Code, R163: Der erste Buchstabe bleibt, die folgenden Konsonantenlaute werden zu drei Ziffern, und kurze Codes werden mit Nullen aufgefüllt, sodass ähnlich klingende Namen zusammenfallen. Kostenlos in Ihrem Browser.
- Kostenlos
- Läuft in Ihrem Browser
- Ohne Anmeldung
- Ihre Daten bleiben auf Ihrem Gerät
Im Browser ausführen – kostenlos
Rechenbeispiel
- Name
- Robert
- Code
- R163
- Normalisiert
- ROBERT
- Länge
- 6
Der amerikanische Soundex ist der klassische phonetische Index der US-Volkszählung und der Genealogie, der einen Personen- oder Familiennamen in einen vierstelligen Code verwandelt: den beibehaltenen ersten Buchstaben plus drei Ziffern für Konsonanten-Lautgruppen. Namen, die gleich klingen, aber anders geschrieben werden—Robert und Rupert, Smith und Smythe—teilen oft denselben Soundex-Code; deshalb nutzen Archivare, Familiengeschichtler und Record-Linkage-Skripte ihn weiterhin als erste Clustering-Schlüssel. Dieser Soundex-Encoder akzeptiert eine nicht leere Namenszeichenkette, normalisiert lateinische Buchstaben, wendet die Standard-Zifferntabelle und die Nachbarschaftsregeln an und liefert den Code samt der normalisierten Buchstabenform.
Wie der amerikanische Soundex einen Code aus Buchstabe plus drei Ziffern bildet
Soundex beginnt damit, den Namen in Großbuchstaben zu setzen und nur lateinische Buchstaben von A bis Z zu behalten; Ziffern, Leerzeichen, Bindestriche und Satzzeichen werden vor dem Codieren entfernt, sodass ein Formularfeld mit Extra-Leerzeichen weiter funktioniert. Der erste Buchstabe dieser normalisierten Zeichenkette bleibt erhalten und wird zum führenden Zeichen des Codes.
Jeder spätere Buchstabe wird entweder einer Ziffer zugeordnet oder verworfen: B, F, P und V werden zu 1; C, G, J, K, Q, S, X und Z zu 2; D und T zu 3; L zu 4; M und N zu 5; R zu 6. Die Vokale A, E, I, O, U und der Buchstabe Y erzeugen keine Ziffer. H und W erzeugen ebenfalls keine Ziffer, unterbrechen aber im Gegensatz zu Vokalen keinen Lauf desselben Zifferncodes—so werden Ashcraft und Ashcroft beide zu A261, nachdem die S/C-Gruppe über H zusammengefasst wurde.
Benachbarte Buchstaben mit derselben Ziffer tragen nur einmal bei, weshalb Jackson zu J250 wird und nicht zu einer längeren Kette von Zweien. Nach höchstens drei gesammelten Ziffern werden fehlende Stellen mit Nullen aufgefüllt, sodass jedes erfolgreiche Ergebnis genau vier Zeichen hat.
Anwendungsfälle
Nachnamen-Gruppierung in Genealogie und Zensus
Gruppieren Sie Familiennamen, die gleich klingen, aber in historischen Akten unterschiedlich geschrieben wurden, durch Vergleich vierstelliger amerikanischer Soundex-Codes.
Fuzzy-Vorabgleich von Namen im CRM
Bündeln Sie ähnlich klingende Kundennachnamen zur menschlichen Prüfung, ohne bei jedem Formularabsenden einen vollen Entity-Resolution-Stack zu installieren.
Häufige Fragen
Warum teilen Robert und Rupert denselben Code?
Soundex mappt ähnliche Konsonanten auf dieselben Ziffern und behält nur den ersten Buchstaben plus drei Ziffern, sodass ähnlich klingende Namen absichtlich für Fuzzy-Matching kollidieren.
Ist Soundex dasselbe wie Metaphone oder NATO-Phonetisch?
Nein. Dieses Werkzeug implementiert nur amerikanischen Soundex (Buchstabe plus drei Ziffern). Metaphone, Double Metaphone und NATO-Buchstabiertafeln sind andere Algorithmen und Landings.
Wie kodiere ich einen Namen mit Soundex?
Geben Sie den Namen ein, etwa Jackson. Das Werkzeug behält das J, ordnet den folgenden Konsonanten Ziffern zu, fasst gleiche Nachbarziffern zusammen und füllt mit Nullen auf vier Zeichen auf. Das Ergebnis ist J250.
Warum trennen H und W Buchstaben nicht wie Vokale?
Im amerikanischen Soundex sorgt ein Vokal zwischen zwei Konsonanten derselben Gruppe dafür, dass beide zählen, H und W tun das nicht. Deshalb wird Ashcraft zu A261: S und C teilen sich eine Ziffer und zählen mit nur einem H dazwischen einmal.
Warum hat der Soundex-Code immer vier Zeichen?
Weil das Verfahren den ersten Buchstaben und höchstens drei Ziffern behält. Ergibt der Name weniger, werden die Stellen mit Nullen aufgefüllt, ergibt er mehr, fällt der Rest weg. So lassen sich alle Codes in gleicher Länge vergleichen.
Verwandte Tools
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem Stack
curl -X POST https://api.kit.forhosting.com/enc/soundex \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Robert"}'const res = await fetch("https://api.kit.forhosting.com/enc/soundex", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"name": "Robert"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/soundex",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"name": "Robert"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/soundex", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"name":"Robert"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"name":"Robert"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/soundex", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"name": "Robert"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.soundex",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |
Technische Hinweise
Leere Eingabe, fehlender Name oder eine Zeichenkette ohne A–Z-Buchstaben schlägt mit invalid_input fehl, damit Aufrufer leere Formulare markieren können statt einen Code zu erfinden. Der kostenlose Browser-Pfad und die vorausbezahlte API teilen dieselbe reine Parse-Logik, sodass Unterrichtsdemos und Produktionspipelines bei Robert und Rupert nie auseinanderlaufen.
Wie der amerikanische Soundex einen Code aus Buchstabe plus drei Ziffern bildet
Weil der Pfad reine Zeichenarithmetik ohne Netz und ohne Uhr ist, liefern identische Namen stets dasselbe JSON für Continuous-Integration-Goldens.
Eingabevertrag, Leer-Flags, Antwortform und typische Fehler
Behandeln Sie Soundex weder als Verschlüsselung noch als eindeutigen Personenbezeichner: Viele unverwandte Nachnamen kollidieren absichtlich, und diese Kollision ist der Vorteil des Fuzzy-Matchings, kein Fehler. Bevorzugen Sie diese Landing, wenn die Suchabsicht Soundex-Encoder, amerikanischer Soundex oder phonetischer Namenscode ist; NATO-Buchstabiertafel, Metaphone und allgemeine Chiffre-Tools bedienen andere Absichten und bleiben auf eigenen Seiten. Akzentbuchstaben außerhalb reinem A–Z werden mit anderen Nicht-Buchstaben entfernt; liefern Sie daher eine ASCII-normalisierte Form, wenn Quelldaten Diakritika nutzen und diese Buchstaben mitwirken sollen. Senden Sie einen JSON-Body mit dem Pflicht-String-Feld name auf den Personen- oder Familiennamen, den Sie codieren möchten. Die Aliase text, input, value und s werden akzeptiert, wenn Clients ältere Formularnamen oder gemeinsame Text-Widgets wiederverwenden. Fehlendes name, kein String-Wert, leere Zeichenkette, nur Leerzeichen oder eine Zeichenkette ohne lateinische Buchstaben lösen invalid_input aus und werden auf der vorausbezahlten API nicht berechnet—das ist der vom Produkt versprochene Leer-Eingabe-Pfad, ausgedrückt als harter Validierungsfehler statt als Erfolgsbody mit leerem Code. Bei Erfolg enthält die Antwort code (den vierstelligen Soundex-Wert), method gleich american_soundex, damit nachgelagerte Router ohne Form-Raten verzweigen können, name mit der Originalzeichenkette, normalized mit der tatsächlich codierten Großbuchstaben-A–Z-Sequenz, empty immer false bei Erfolg und length gleich der ursprünglichen Zeichenzahl vor dem Filtern.
Wo eine Soundex-API Nutzen stiftet und wie die Preisgestaltung funktioniert
Genealogen und Lokalgeschichtsprojekte nutzen einen Soundex-Encoder, um Nachnamen aus Volkszählungen und Passagierlisten mit inkonsistenter Schreibweise zu gruppieren. CRM- und Kundensupport-Werkzeuge können ähnlich klingende Nachnamen vor einer menschlichen Prüfung bündeln, ohne eine volle Fuzzy-Such-Engine aufzusetzen. Unterrichtsdemos historischer Indexieralgorithmen brauchen ein deterministisches Orakel, das Lernende im Browser aufrufen können, während die Lehrkraft die Zifferntabelle an die Tafel schreibt. Datenbereinigungs-Notebooks können Soundex als Feature-Spalte neben Kleinbuchstaben und Metaphone ausgeben, wenn Entity-Resolution-Merkmale gebaut werden. Nutzen Sie das kostenlose Browser-Tool für Einzelprüfungen und Unterricht; nutzen Sie die vorausbezahlte KIT-API, wenn ein Backend, eine Serverless-Funktion oder ein SDK einen stabilen Vertrag unter Guthaben zu $0.002 pro erfolgreichem Item braucht. Validierungsfehler belasten den Prepaid-Saldo nach Ablehnung durch die Engine nicht. Halten Sie Payloads bei gewöhnlichen Namenslängen, die zu einem Worker-Isolate-Item-Aufruf passen: dieses Werkzeug dient Namen und kurzen Labels, nicht Multi-Megabyte-Dokumenten. Kombinieren Sie es mit anderen Text-Utilities nur, wenn ein späterer Schritt ein anderes phonetisches oder Chiffre-Schema braucht; belassen Sie den amerikanischen Soundex auf der eigenen Landing, damit die SEO-Absicht scharf bleibt und der Leitfaden ehrlich bleibt, was der vierstellige Code leisten kann und was nicht.
Integrationsbeispiele
Phonetische-Index-Demos im Unterricht
Zeigen Sie Lernenden, dass Robert und Rupert R163 teilen, während leere Formulare klar scheitern—mit demselben kostenlosen Browser-Pfad wie die API.
Technische Fragen
Wie codiere ich einen Namen mit amerikanischem Soundex?
Senden Sie JSON mit einem nicht leeren name-Feld (zum Beispiel name: "Robert"). Das code-Feld der Antwort enthält den vierstelligen Soundex-Wert (R163 für Robert).
Was passiert, wenn der Name leer ist?
Die Anfrage scheitert mit invalid_input. Fehlende, leere oder buchstabenlose Eingabe wird als leer markiert und auf der vorausbezahlten API nicht berechnet.
Ist der Soundex-Encoder kostenlos?
Das Browser-Tool läuft kostenlos auf Ihrem Gerät. API-Aufrufe nutzen vorausbezahltes KIT-Guthaben zu $0.002 pro erfolgreichem Item; Validierungsfehler werden nicht berechnet.