ForHosting KIT · Ferramentas para dev

Fonética de Colônia

Müller, Mueller e Muller recebem o mesmo código, 657, e Schmidt e Schmied compartilham o 862, então as variantes de um sobrenome alemão ficam juntas. Serve para achar possíveis duplicatas em registros, listas de clientes e árvores genealógicas. Grátis no seu navegador.

  • Grátis
  • Funciona no seu navegador
  • Sem cadastro
  • Seus dados não saem do seu aparelho
Use pelo WebAPIE-mailTelegramApp em breve
Se você digitar
Texto
Müller
Você obtém
Código
657
Comprimento
3
Normalizado
MULLER
Contagem de letras
6

A fonética de Colônia, conhecida em alemão como Kölner Phonetik, mapeia sobrenomes e prenomes para uma cadeia curta de dígitos para que variantes com som parecido compartilhem a mesma chave. Registros civis, tarefas de deduplicação em CRM e ferramentas de genealogia usam isso quando Müller deve corresponder a Mueller, ou Schneider agrupar-se com Schnyder, sem um modelo fonético completo. Você obtém um campo code estável e a sequência de letras normalizada para auditar por que dois registros colidiram.

O que a fonética de Colônia codifica e por que os nomes colidem

A fonética de Colônia foi projetada para listas civis em língua alemã, onde a deriva ortográfica é comum: trema escrito como dígrafos, H mudo, C suave versus C duro, e X com dois códigos. O algoritmo não reivindica precisão IPA; busca uma chave compacta e determinística que agrupe nomes que as pessoas pronunciam de modo semelhante. As letras A, E, I, J, O, U e Y mapeiam para zero e depois desaparecem salvo se abrirem o código.

O H é ignorado por completo. Consoantes mapeiam de um a oito com regras de contexto — por exemplo, P antes de H vira três como F; D ou T antes de C, S ou Z vira oito como S; e X vira quarenta e oito salvo se seguir C, K ou Q. Após o passo das letras, dígitos idênticos consecutivos colapsam de modo que Schmidt e Schmied ambos reduzem a oito-seis-dois, e os zeros restantes são removidos exceto um zero inicial.

Por isso Müller, Mueller e Muller rendem todos seis-cinco-sete, e Mayer, Meier, Maier e Mayr compartilham seis-sete. Equipes de genealogia e dados mestres tratam códigos iguais como correspondência candidata, não prova de identidade: nomes do meio, sobrenomes de casamento e erros de transcrição ainda exigem revisão humana ou checagens secundárias. Use o campo normalized devolvido para ver quais letras sobreviveram à remoção de espaços, hífens e dígitos antes da codificação.

O que você pode digitar e o que recebe

Colagens extremamente longas acima do limite de caracteres publicado também falham para que workers de borda permaneçam previsíveis. Caracteres não alfabéticos nunca aparecem em normalized: pontuação, espaços e dígitos são removidos antes da codificação. Se nenhuma letra restar — por exemplo text igual a 12345 ou só símbolos — a tarefa falha com mensagem de entrada vazia ou não alfabética e pede ao menos uma letra.

Essas falhas não são faturadas. Não há direção de decodificação: códigos de Colônia são muitos-para-um e com perda, então a busca reversa exigiria um dicionário de nomes externo que você mantenha. Exemplo: text Müller gera code 657 com normalized MULLER; text Schmidt gera 862; text Fischer gera 387.

Onde a fonética de Colônia ajuda na prática

Plataformas de dados de clientes usam a fonética de Colônia no merge-and-purge do onboarding para que sobrenomes alemães digitados com e sem trema não criem contas duplicadas. Scripts de migração do setor público anexam uma coluna de código cologne ao lado de colunas soundex ou metaphone ao comparar extratos cidadãos de várias fontes. Módulos de sala de aula que ensinam correspondência de nomes precisam de um oráculo determinístico que rejeite colagem vazia em vez de devolver string vazia que um avaliador defeituoso poderia tratar como correspondência total.

Prefira este codificador quando o corpus for alemão ou da Europa Central; para soletração radiofônica só em inglês use uma ferramenta do alfabeto OTAN, e para correspondência aproximada orientada ao inglês compare landings soundex ou metaphone em vez de forçar Colônia em nomes anglo. Mantenha pedidos em nomes únicos ou tokens curtos, armazene o código ao lado da grafia original e recodifique após limpar títulos como Dr ou Frau no seu próprio pipeline se quiser chaves sem título.

CRM e deduplicação de clientes

Anexe um código de Colônia a cada sobrenome alemão para que Müller e Mueller se agrupem antes da revisão humana de possíveis contas duplicadas.

Indexação genealógica e de listas civis

Indexe linhas históricas de pessoas com Kölner Phonetik para que a busca por Schneider também traga variantes ortográficas próximas sem um modelo de texto completo.

Chaves de match ETL para extratos alemães

Adicione uma coluna cologne determinística em jobs de migração ao lado de outras chaves fonéticas para arquivos cidadãos ou de funcionários de várias fontes.

O que é a fonética de Colônia (Kölner Phonetik)?

Um algoritmo alemão de correspondência de nomes que mapeia uma palavra para uma cadeia curta de dígitos com regras fixas de letras, contexto para C, D, T, P e X, e depois colapsa dígitos repetidos e zeros interiores.

Por que Müller e Mueller recebem o mesmo código?

O trema dobra para vogais base (Ü→U), vogais mapeiam para zero e são removidas exceto um zero inicial, e os códigos de consoantes restantes coincidem — ambos normalizam para MULLER e code 657.

O que acontece com entrada vazia ou só de dígitos?

É necessário ao menos um caractere alfabético (incluindo trema alemão ou ß); cadeias vazias, só espaços e não alfabéticas são rejeitadas e não faturadas.

Posso decodificar um código de Colônia de volta a um nome?

Não. O mapeamento é com perda e muitos-para-um. Este codificador só produz o código de dígitos; a busca reversa precisa do seu próprio dicionário de nomes.

O mesmo código de Colônia significa que dois registros são a mesma pessoa?

Não. Um código igual só indica uma possível correspondência. Nomes do meio, sobrenomes de casada e erros de transcrição ainda pedem uma revisão humana ou um segundo critério, como a mesma região ou um ano de nascimento parecido.

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.

POSThttps://api.kit.forhosting.com/enc/cologne-phonetic

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/enc/cologne-phonetic \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Müller"}'
{
  "text": "Müller"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.cologne_phonetic",
  "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.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Este codificador aplica as regras clássicas de Postel em um Worker puro: converte para maiúsculas e dobra trema, mapeia cada letra com o contexto do vizinho, colapsa dígitos idênticos consecutivos e remove zeros interiores. Cadeias vazias e colagem só de dígitos falham com invalid_input em vez de inventar um sucesso oco.

Contrato de entrada, campos de resposta e casos invalid_input

Envie por POST um objeto JSON com a string obrigatória text (aliases input, value, name ou s). Aplica-se trim; espaços puros e campos ausentes falham com invalid_input nomeando o problema. Em sucesso o corpo ecoa text, devolve code como cadeia de dígitos, length como número de dígitos, normalized como a sequência A–Z em maiúsculas após dobrar trema (Ä Ö Ü para A O U, ß para SS), e letter_count para essa sequência. Combine igualdade de code com seus próprios limiares (mesma região postal, ano de nascimento semelhante) ao montar uma pontuação de correspondência; este endpoint só calcula a chave fonética.

Quanto custa o codificador de fonética de Colônia?

A ferramenta do navegador é gratuita. Solicitações API usam saldo pré-pago KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é faturada.

Ver a documentação completa do KIT →