Codificatore Soundex
Robert e Rupert danno lo stesso codice, R163: la prima lettera resta, i suoni consonantici successivi diventano tre cifre e i codici corti si completano con zeri, così nomi dal suono simile finiscono sullo stesso codice. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Nome
- Robert
- Codice
- R163
- Normalizzato
- ROBERT
- Lunghezza
- 6
Il Soundex americano è l'indice fonetico classico del censimento statunitense e della genealogia che trasforma un nome personale o di famiglia in un codice di quattro caratteri: la prima lettera conservata più tre cifre che rappresentano gruppi di suoni consonantici. Nomi che suonano uguali ma si scrivono in modo diverso—Robert e Rupert, Smith e Smythe—spesso condividono lo stesso codice Soundex, ed è per questo che archivisti, storici di famiglia e script di collegamento dei record lo usano ancora come prima chiave di raggruppamento. Questo codificatore Soundex accetta una stringa di nome non vuota, normalizza le lettere latine, applica la mappa di cifre standard e le regole di adiacenza, e restituisce il codice con la forma normalizzata usata per la codifica.
Come il Soundex americano costruisce un codice lettera più tre cifre
Il Soundex inizia convertendo il nome in maiuscolo e conservando solo le lettere latine dalla A alla Z; cifre, spazi, trattini e punteggiatura vengono rimossi prima della codifica, così un campo di modulo con spazi in più funziona ancora. La prima lettera di quella stringa normalizzata viene mantenuta così com'è e diventa il carattere iniziale del codice.
Ogni lettera successiva viene mappata a una cifra o scartata: B, F, P e V mappano a 1; C, G, J, K, Q, S, X e Z a 2; D e T a 3; L a 4; M e N a 5; R a 6. Le vocali A, E, I, O, U e la lettera Y non producono cifre.
Anche H e W non producono cifre, ma a differenza delle vocali non interrompono una sequenza dello stesso codice numerico—così Ashcraft e Ashcroft diventano entrambe A261 dopo il collasso del gruppo S/C attraverso la H. Le lettere adiacenti che condividono la stessa cifra contribuiscono una sola volta, ed è per questo che Jackson diventa J250 anziché una stringa più lunga di due. Dopo aver raccolto al massimo tre cifre, i posti mancanti vengono riempiti con zeri affinché ogni risultato di successo abbia esattamente quattro caratteri.
A cosa serve il Soundex in genealogia e archivi
Genealogisti e progetti di storia locale usano un codificatore Soundex per raggruppare cognomi di censimenti e liste passeggeri registrati con ortografia inconsistente. Gli strumenti CRM e di supporto clienti possono raggruppare cognomi simili prima di una revisione umana senza montare un motore completo di ricerca fuzzy. Le demo in aula di algoritmi di indicizzazione storica necessitano di un oracolo deterministico che gli studenti possano chiamare dal browser mentre l'insegnante mostra la tabella delle cifre sulla lavagna.
I notebook di pulizia dati possono emettere Soundex come colonna di feature accanto a minuscole e Metaphone nella costruzione di attributi di entity resolution. I fallimenti di validazione non consumano mai il saldo dopo il rifiuto del motore.
Casi d'uso
Raggruppamento cognomi in genealogia e censimenti
Raggruppi nomi di famiglia che suonano uguali ma furono scritti diversamente nei registri storici confrontando codici Soundex americano a quattro caratteri.
Pre-abbinamento fuzzy di nomi in CRM
Raggruppi cognomi clienti simili per revisione umana senza installare uno stack completo di entity resolution a ogni invio di modulo.
Domande frequenti
Come codifico un nome con il Soundex americano?
Il campo code della risposta contiene il valore Soundex a quattro caratteri (R163 per Robert).
Perché Robert e Rupert condividono lo stesso codice?
Il Soundex mappa consonanti simili alle stesse cifre e conserva solo la prima lettera più tre cifre, così nomi che suonano uguali spesso collidono di proposito per l'abbinamento fuzzy.
Il codificatore Soundex è gratis?
Lo strumento browser gira gratis sul Suo dispositivo.
Il Soundex è uguale a Metaphone o al fonetico NATO?
No. Questo strumento implementa solo il Soundex americano (lettera più tre cifre). Metaphone, Double Metaphone e gli alfabeti di spelling NATO sono algoritmi e landing distinti.
Perché il codice Soundex ha sempre quattro caratteri?
Perché il metodo conserva la prima lettera e al massimo tre cifre. Se il nome ne produce meno, i posti mancanti si riempiono di zeri; se ne produce di più, il resto viene scartato. Così tutti i codici si confrontano alla stessa lunghezza.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo 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)Esempio di richiesta
{
"name": "Robert"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.soundex",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Un input vuoto, un nome assente o una stringa senza lettere A–Z fallisce con invalid_input così chi chiama può segnalare i moduli vuoti invece di inventare un codice. Il percorso gratuito del browser e l'API prepagata condividono la stessa logica parse pura, così demo scolastiche e pipeline di produzione non divergono mai tra Robert e Rupert.
Contratto di input, flag di vuoto, forma della risposta e errori comuni
Non tratti il Soundex come cifratura né come identificatore univoco di persona: molti cognomi non correlati collidono di proposito, e quella collisione è il vantaggio dell'abbinamento fuzzy, non un difetto. Preferisca questa landing quando l'intento di ricerca è codificatore soundex, Soundex americano o codice fonetico di nomi; l'alfabeto fonetico NATO, Metaphone e gli strumenti di cifra generali rispondono a intenti diversi e restano su pagine separate. Le lettere accentate fuori dalla pura A–Z vengono rimosse con le altre non lettere, quindi fornisca una forma normalizzata ASCII se i dati sorgente usano diacritici e ha bisogno che quelle lettere partecipino. Invii un corpo JSON con il campo stringa obbligatorio name impostato sul nome di persona o famiglia da codificare. Name assente, valore non stringa, stringa di lunghezza zero, solo spazi o stringa senza lettere latine sollevano invalid_input e non vengono addebitati sull'API prepagata—è il percorso di flag di input vuoto promesso dal prodotto, espresso come errore di validazione rigido anziché come corpo di successo con codice vuoto. In caso di successo la risposta include code (il valore Soundex a quattro caratteri), method uguale a american_soundex così i router a valle possono ramificare senza indovinare le forme, name che ripete la stringa originale, normalized con la sequenza A–Z in maiuscolo effettivamente codificata, empty sempre false in successo, e length uguale al conteggio caratteri originale prima del filtraggio.
Dove un'API Soundex crea valore e come funziona il prezzo
Usi lo strumento gratuito nel browser per controlli occasionali e per l'insegnamento; usi l'API KIT prepagata quando un backend, una funzione serverless o un SDK necessita di un contratto stabile con saldo a $0.002 per elemento riuscito. Mantenga payload di lunghezza di nome ordinaria adatti a una chiamata item in un Worker isolate: questo strumento serve a nomi ed etichette brevi, non a documenti multi-megabyte. Lo abbini ad altre utilità di testo solo quando un passo successivo richiede un altro schema fonetico o di cifra; mantenga il Soundex americano sulla propria landing così l'intento SEO resta nitido e la guida resta onesta su ciò che il codice a quattro caratteri può e non può fare.
Casi di integrazione
Demo di indice fonetico in aula
Mostri agli studenti che Robert e Rupert condividono R163 mentre i moduli vuoti falliscono in modo chiaro, usando lo stesso percorso gratuito del browser dell'API.
Domande tecniche
Cosa succede se il nome è vuoto?
La richiesta fallisce con invalid_input. Un input assente, vuoto o senza lettere è segnalato come vuoto e non viene addebitato sull'API prepagata.