Codificador Refined Soundex
Robert vira R9196: a primeira letra fica, cada som de consoante vira um dígito de uma tabela mais fina e nada é cortado em quatro caracteres, então sobrenomes longos mantêm o final. Útil para achar nomes parecidos. 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
- R9196
- Normalizado
- ROBERT
- Comprimento
- 6
O Refined Soundex é uma variante de indexação fonética feita para correspondência de nomes mais fina e agrupamento no estilo de corretor ortográfico do que o Soundex americano clássico. Mantém a primeira letra do nome, mapeia cada letra por uma tabela refinada de consoantes 0–9, colapsa apenas dígitos idênticos adjacentes e—de forma crítica—nunca trunca o resultado a quatro caracteres. Esse código de comprimento total retém dígitos discriminativos em sobrenomes longos, de modo que Washington, Ashcraft e Pfister guardam mais sinal do que uma chave de letra mais três dígitos. Este codificador refined soundex aceita uma string de nome não vazia, remove o que não for letra, aplica o mapa refinado em inglês americano usado por bibliotecas de referência como Apache Commons Codec e devolve o código com a forma normalizada de fato codificada.
Como o Refined Soundex monta um código fonético de comprimento total
O Refined Soundex começa convertendo o nome para maiúsculas e mantendo apenas as letras latinas de A a Z. Dígitos, espaços, hífens, apóstrofos e pontuação são removidos para que um campo de formulário com espaços a mais ainda codifique de forma limpa. A primeira letra dessa string normalizada é emitida como caractere inicial do código.
Em seguida cada letra—incluindo a primeira—é mapeada pela tabela refinada de dígitos: B e P mapeiam para 1; F e V para 2; C, K e S para 3; G e J para 4; Q, X e Z para 5; D e T para 6; L para 7; M e N para 8; R para 9.
As vogais A, E, I, O, U e as letras Y, H e W mapeiam para 0 e não acrescentam dígito, mas atualizam a memória do mapeamento anterior para que uma sequência do mesmo dígito se quebre quando um zero intervém. Letras adjacentes que compartilham o mesmo dígito não zero contribuem apenas uma vez. Diferente do Soundex americano clássico, não há preenchimento até quatro nem truncamento rígido: cada dígito codificado restante permanece no resultado.
Onde um código Refined Soundex completo ajuda
Cadernos de resolução de entidades usam refined soundex como chave de bloqueio quando o Soundex clássico de quatro caracteres colide de forma agressiva demais em sobrenomes comuns e voce quer códigos mais longos sem migrar para Metaphone. Protótipos de corretor e de digitação antecipada podem agrupar sobrenomes quase iguais por prefixos refinados compartilhados e ainda distinguir caudas mais longas que o Soundex americano teria truncado. Ferramentas de CRM e de suporte ao cliente podem pré-agrupar nomes parecidos para revisão humana sem montar um motor completo de busca fuzzy.
Demos de sala de aula de algoritmos fonéticos históricos e de biblioteca precisam de um oráculo determinístico que os alunos possam chamar do navegador enquanto o professor contrasta o mapa refinado com a tabela clássica do censo no quadro. Projetos de genealogia que já conhecem Soundex podem acrescentar uma segunda coluna de códigos refinados quando grafias de listas de passageiros e censos divergem após o terceiro dígito. 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 refined soundex em sua própria landing para que a intenção SEO continue nítida e o guia seja honesto sobre o que um código refinado de comprimento total pode e não pode fazer.
Casos de uso
Bloqueio de sobrenomes mais fino que o Soundex clássico
Agrupe nomes de família parecidos com um código refinado de comprimento total quando o Soundex americano de letra mais três dígitos colide com frequência demais em sobrenomes comuns.
Pré-correspondência fuzzy de nomes em CRM
Agrupe sobrenomes de clientes para revisão humana usando grupos de dígitos refinados sem instalar um stack completo de resolução de entidades em cada envio de formulário.
Demos de sala de aula de índices fonéticos
Mostre aos alunos que Robert e Rupert compartilham R9196 enquanto formulários vazios falham com clareza, e contraste códigos refinados de comprimento total com o Soundex clássico de quatro caracteres.
Perguntas frequentes
Como codificar um nome com Refined Soundex?
O campo code da resposta contém o valor Refined Soundex completo (R9196 para Robert).
Como o Refined Soundex difere do Soundex americano clássico?
O Refined Soundex usa um mapa de dígitos consonantais mais fino e mantém cada letra codificada em vez de preencher ou truncar a uma letra mais três dígitos. O Soundex clássico vive em outra landing e capacidade.
O codificador Refined Soundex é gratuito?
A ferramenta do navegador roda grátis no seu dispositivo.
Refined Soundex é o mesmo que NYSIIS ou Metaphone?
Não. Esta ferramenta implementa apenas Refined Soundex (primeira letra mais a sequência completa de dígitos refinados). NYSIIS, Metaphone, Double Metaphone e alfabetos de soletração OTAN são algoritmos e landings diferentes.
O que acontece com acentos, espaços e hífens no nome?
Tudo o que não é letra simples de A a Z sai antes da codificação, incluindo espaços, hífens, apóstrofos e dígitos. Letras acentuadas também são removidas, então escreva o nome sem acento se quiser que elas contem.
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/refined-soundex \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Robert"}'const res = await fetch("https://api.kit.forhosting.com/enc/refined-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/refined-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/refined-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/refined-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.refined_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, campo name ausente ou string sem letras latinas A–Z falha com invalid_input para marcar formulários em branco em vez de inventar um código. O caminho gratuito do navegador e a API pré-paga compartilham a mesma lógica parse pura, de modo que demos, testes e pipelines de produção sempre concordam entre Robert e Rupert.
Como o Refined Soundex monta um código fonético de comprimento total
Como o caminho é aritmética pura de caracteres sem rede e sem relógio, nomes idênticos sempre geram o mesmo JSON para goldens de integração contínua e execuções multi-região no edge.
Contrato de entrada, marcas de vazio, forma da resposta e erros comuns
Não confunda esta landing com o Soundex americano clássico: aquela ferramenta preenche e trunca a uma letra mais três dígitos e usa agrupamento de dígitos mais grosseiro; o Refined Soundex usa um mapa consonantal particionado (por exemplo B/P versus F/V, e C/K/S versus G/J versus Q/X/Z) e mantém cada letra codificada para discriminação mais fina. Prefira esta página quando a intenção de busca for codificador refined soundex, código refined soundex ou índice fonético de nomes de comprimento total; soundex clássico, NYSIIS, soletração OTAN e ferramentas gerais de cifra respondem a intenções diferentes e permanecem 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 seus dados de origem usam diacríticos e voce precisa que essas letras participem do código. Envie um corpo JSON com o campo string obrigatório name definido para 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 duro de validação e não como corpo de sucesso com código em branco. No sucesso a resposta inclui code (o valor Refined Soundex completo), method igual a refined_soundex para que roteadores posteriores possam ramificar sem adivinhar formas, name ecoando a string original, normalized com a sequência A–Z em maiúsculas de fato codificada, empty sempre false no sucesso, e length igual à contagem original de caracteres antes da remoção.
Onde uma API Refined Soundex gera 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, uma função serverless ou um SDK precisar de contrato estável sob 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 um Worker isolate: esta ferramenta é para nomes e rótulos curtos, não para documentos de vários megabytes.
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.