Codificador Soundex
Robert e Rupert dão o mesmo código, R163: a primeira letra fica, os sons de consoante seguintes viram três dígitos e códigos curtos são completados com zeros, então nomes de som parecido caem no mesmo código. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Nome
- Robert
- Código
- R163
- Normalizado
- ROBERT
- Comprimento
- 6
O Soundex americano é o índice fonético clássico do censo dos EUA e da genealogia que transforma um nome pessoal ou de família em um código de quatro caracteres: a primeira letra mantida mais três dígitos que representam grupos de sons consonantais. Nomes que soam iguais mas se escrevem de forma diferente—Robert e Rupert, Smith e Smythe—muitas vezes compartilham o mesmo código Soundex, por isso arquivistas, historiadores de família e scripts de ligação de registros ainda o usam como primeira chave de agrupamento. Este codificador Soundex aceita uma string de nome não vazia, normaliza letras latinas, aplica o mapa de dígitos padrão e as regras de adjacência, e devolve o código com a forma normalizada usada na codificação.
Como o Soundex americano monta um código de letra mais três dígitos
O Soundex começa convertendo o nome para maiúsculas e mantendo apenas letras latinas de A a Z; dígitos, espaços, hífens e pontuação são removidos antes da codificação, de modo que um campo de formulário com espaços extras ainda funciona. A primeira letra dessa string normalizada é mantida como está e vira o caractere inicial do código.
Cada letra seguinte é mapeada para um dígito ou descartada: B, F, P e V mapeiam para 1; C, G, J, K, Q, S, X e Z para 2; D e T para 3; L para 4; M e N para 5; R para 6. As vogais A, E, I, O, U e a letra Y não geram dígito.
H e W também não geram dígito, mas diferentemente das vogais não interrompem uma sequência do mesmo código numérico—assim Ashcraft e Ashcroft ambas se tornam A261 ao colapsar o grupo S/C através do H. Letras adjacentes que compartilham o mesmo dígito contribuem só uma vez, por isso Jackson se torna J250 em vez de uma string mais longa de dois. Depois de reunir no máximo três dígitos, as posições que faltam são preenchidas com zeros para que todo resultado bem-sucedido tenha exatamente quatro caracteres.
Para que serve o Soundex em genealogia e cadastros
Genealogistas e projetos de história local usam um codificador Soundex para agrupar sobrenomes de censos e listas de passageiros registrados com ortografia inconsistente. Ferramentas de CRM e de suporte ao cliente podem agrupar sobrenomes parecidos antes de uma revisão humana sem montar um motor completo de busca difusa. Demos de sala de aula de algoritmos de indexação histórica precisam de um oráculo determinístico que os alunos possam chamar no navegador enquanto o professor mostra a tabela de dígitos no quadro.
Notebooks de limpeza de dados podem emitir Soundex como uma coluna de features ao lado de minúsculas e Metaphone ao construir atributos de resolução de entidades. Falhas de validação nunca consomem saldo após a rejeição do motor. Combine com outras utilidades de texto só quando um passo posterior precisar de outro esquema fonético ou de cifra; mantenha o Soundex americano na própria landing para que a intenção SEO continue nítida e o guia seja honesto sobre o que o código de quatro caracteres pode e não pode fazer.
Casos de uso
Agrupamento de sobrenomes em genealogia e censos
Agrupe nomes de família que soam iguais mas foram escritos de forma diferente em registros históricos comparando códigos Soundex americano de quatro caracteres.
Pré-pareamento difuso de nomes em CRM
Agrupe sobrenomes de clientes parecidos para revisão humana sem instalar um stack completo de resolução de entidades em cada envio de formulário.
Perguntas frequentes
Como codifico um nome com Soundex americano?
O campo code da resposta contém o valor Soundex de quatro caracteres (R163 para Robert).
Por que Robert e Rupert compartilham o mesmo código?
O Soundex mapeia consoantes semelhantes aos mesmos dígitos e mantém apenas a primeira letra mais três dígitos, de modo que nomes que soam iguais frequentemente colidem de propósito para pareamento difuso.
O codificador Soundex é grátis?
A ferramenta do navegador roda grátis no seu dispositivo.
Soundex é o mesmo que Metaphone ou o fonético OTAN?
Não. Esta ferramenta implementa apenas Soundex americano (letra mais três dígitos). Metaphone, Double Metaphone e alfabetos de soletração OTAN são algoritmos e landings diferentes.
Por que H e W não separam letras como as vogais?
No Soundex americano, uma vogal entre duas consoantes do mesmo grupo faz as duas contarem, mas H e W não. Por isso Ashcraft vira A261: o S e o C têm o mesmo dígito e, com só um H entre eles, contam uma vez.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
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)Exemplo de requisição
{
"name": "Robert"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.soundex",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Entrada vazia, nome ausente ou string sem letras A–Z falha com invalid_input para que quem chama possa marcar formulários em branco em vez de inventar um código. O caminho gratuito no navegador e a API pré-paga compartilham a mesma lógica parse pura, de modo que demos escolares e pipelines de produção nunca discordam entre Robert e Rupert.
Como o Soundex americano monta um código de letra mais três dígitos
Como o caminho é aritmética pura de caracteres sem rede e sem relógio, nomes idênticos sempre produzem o mesmo JSON para goldens de integração contínua.
Contrato de entrada, marcas de vazio, formato da resposta e erros comuns
Não trate Soundex como criptografia nem como identificador único de pessoa: muitos sobrenomes não relacionados colidem de propósito, e essa colisão é a vantagem do pareamento difuso, não um defeito. Prefira esta landing quando a intenção de busca for codificador soundex, Soundex americano ou código fonético de nomes; a soletração fonética OTAN, Metaphone e ferramentas de cifra gerais respondem a intenções diferentes e ficam em páginas separadas. Letras acentuadas fora da A–Z pura são removidas com as demais não letras, então forneça uma forma normalizada em ASCII se os dados de origem usam diacríticos e você precisa que essas letras participem. Envie um corpo JSON com o campo de string obrigatório name definido com o nome de pessoa ou família que deseja codificar. Os aliases text, input, value e s são aceitos quando clientes reutilizam nomes de formulário antigos ou widgets de texto compartilhados. Name ausente, valor que não é string, string de comprimento zero, apenas espaços ou string sem letras latinas elevam invalid_input e não são cobrados na API pré-paga—é o caminho de marca de entrada vazia que o produto promete, expresso como erro rígido de validação e não como corpo de sucesso com código em branco. No sucesso a resposta inclui code (o valor Soundex de quatro caracteres), method igual a american_soundex para que roteadores posteriores possam ramificar sem cheirar formatos, name ecoando a string original, normalized com a sequência A–Z em maiúsculas realmente codificada, empty sempre false no sucesso, e length igual à contagem original de caracteres antes do filtrado.
Onde uma API Soundex agrega valor e como funciona o preço
Use a ferramenta gratuita no navegador para checagens pontuais e ensino; use a API KIT pré-paga quando um backend, função serverless ou SDK precisar de um contrato estável com saldo a US$ 0,002 por item bem-sucedido. Mantenha os payloads em comprimentos de nome ordinários adequados a uma chamada de item em Worker isolate: esta ferramenta é para nomes e rótulos curtos, não para documentos de vários megabytes.
Casos de integração
Demos de índice fonético em sala de aula
Mostre aos alunos que Robert e Rupert compartilham R163 enquanto formulários vazios falham de forma clara, usando o mesmo caminho gratuito do navegador que a API.
Perguntas técnicas
O que acontece se o nome estiver vazio?
A solicitação falha com invalid_input. Entrada ausente, em branco ou sem letras é marcada como vazia e não é cobrada na API pré-paga.