Fonetica di Colonia
Müller, Mueller e Muller ottengono lo stesso codice, 657, e Schmidt e Schmied condividono l'862: le varianti di un cognome tedesco finiscono insieme. Utile per trovare probabili doppioni in registri, elenchi clienti e alberi genealogici. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Testo
- Müller
- Codice
- 657
- Lunghezza
- 3
- Normalizzato
- MULLER
- Numero di lettere
- 6
La fonetica di Colonia, nota in tedesco come Kölner Phonetik, mappa cognomi e nomi di battesimo in una breve stringa di cifre così che le varianti dal suono simile condividano una stessa chiave. I registri civili, i job di deduplicazione CRM e gli strumenti di genealogia la usano quando Müller deve corrispondere a Mueller, o Schneider raggrupparsi con Schnyder, senza un modello fonetico completo. Lei ottiene un campo code stabile e la sequenza di lettere normalizzata per verificare perché due record sono entrati in collisione.
Cosa codifica la fonetica di Colonia e perché i nomi collidono
La fonetica di Colonia è stata progettata per elenchi civili in lingua tedesca, dove la deriva ortografica è comune: dieresi scritte come digrammi, H muta, C dolce contro C dura, e X con due codici. L’algoritmo non pretende accuratezza IPA; mira a una chiave compatta e deterministica che raggruppi nomi che le persone pronunciano in modo simile. Le lettere A, E, I, J, O, U e Y si mappano su zero e poi scompaiono salvo se aprono il codice.
La H viene interamente ignorata. Le consonanti si mappano da uno a otto con regole di contesto: ad esempio P prima di H diventa tre come F; D o T prima di C, S o Z diventa otto come S; e X diventa quarantotto salvo se segue C, K o Q. Dopo il passaggio sulle lettere, le cifre identiche consecutive collassano così che Schmidt e Schmied si riducono entrambi a otto-sei-due, e gli zeri rimanenti vengono rimossi tranne uno zero iniziale.
Ecco perché Müller, Mueller e Muller danno tutti sei-cinque-sette, e perché Mayer, Meier, Maier e Mayr condividono sei-sette. I team di genealogia e master data trattano codici uguali come corrispondenza candidata, non come prova di identità: secondi nomi, cognomi da matrimonio ed errori di trascrizione richiedono ancora revisione umana o controlli secondari. Usi il campo normalized restituito per vedere quali lettere sono sopravvissute alla rimozione di spazi, trattini e cifre prima della codifica.
Cosa può inserire e cosa ottiene
Incolla estremamente lunghi oltre il limite di caratteri pubblicato falliscono pure affinché i worker di edge restino prevedibili. I caratteri non alfabetici non compaiono mai in normalized: punteggiatura, spazi e cifre vengono eliminati prima della codifica. Se non resta alcuna lettera — ad esempio text uguale a 12345 o solo simboli — l’attività fallisce con un messaggio di ingresso vuoto o non alfabetico e chiede almeno una lettera.
Tali fallimenti non vengono fatturati. Non esiste direzione di decodifica: i codici di Colonia sono molti-a-uno e con perdita, quindi la ricerca inversa richiederebbe un dizionario di nomi esterno che Lei mantenga. Esempio: text Müller produce code 657 con normalized MULLER; text Schmidt produce 862; text Fischer produce 387.
Dove la fonetica di Colonia è utile
Le piattaforme di dati clienti usano la fonetica di Colonia nel merge-and-purge in onboarding così che i cognomi tedeschi digitati con e senza dieresi non creino account duplicati. Gli script di migrazione del settore pubblico allegato una colonna di codice cologne accanto a colonne soundex o metaphone quando confrontano estratti cittadini multi-fonte. I moduli didattici che insegnano il matching dei nomi necessitano di un oracolo deterministico che rifiuti l’incolla vuoto invece di restituire una stringa vuota che un valutatore difettoso potrebbe trattare come match-all.
Preferisca questo codificatore quando il corpus è tedesco o centroeuropeo; per lo spelling radiofonico solo in inglese usi uno strumento dell’alfabeto NATO, e per il matching approssimato orientato all’inglese confronti landings soundex o metaphone piuttosto che forzare Colonia su nomi anglo. Mantenga le richieste su nomi singoli o token brevi, memorizzi il codice accanto all’ortografia originale e ricodifichi dopo aver rimosso titoli come Dr o Frau nella propria pipeline se desidera chiavi senza titolo.
Casi d'uso
CRM e deduplicazione clienti
Associ un codice di Colonia a ogni cognome tedesco così che Müller e Mueller si raggruppino prima della revisione umana di possibili account duplicati.
Indicizzazione genealogica e di elenchi civili
Indicizzi righe storiche di persone con Kölner Phonetik così che la ricerca di Schneider mostri anche varianti ortografiche vicine senza un modello di full-text.
Chiavi di match ETL per estratti tedeschi
Aggiunga una colonna cologne deterministica nei job di migrazione accanto ad altre chiavi fonetiche per file cittadini o dipendenti multi-fonte.
Domande frequenti
Che cos’è la fonetica di Colonia (Kölner Phonetik)?
Un algoritmo tedesco di matching dei nomi che mappa una parola in una breve stringa di cifre con regole fisse di lettere, contesto per C, D, T, P e X, poi collassa cifre ripetute e zeri interni.
Perché Müller e Mueller ottengono lo stesso codice?
Le dieresi si ripiegano sulle vocali base (Ü→U), le vocali si mappano su zero e vengono rimosse tranne uno zero iniziale, e i codici consonantici restanti coincidono: entrambi si normalizzano verso MULLER e code 657.
Cosa succede con ingresso vuoto o solo di cifre?
È richiesto almeno un carattere alfabetico (incluse dieresi tedesche o ß); stringhe vuote, solo spazi e non alfabetiche vengono rifiutate e non fatturate.
Posso decodificare un codice di Colonia in un nome?
No. La mappatura è con perdita e molti-a-uno. Questo codificatore produce solo il codice di cifre; la ricerca inversa richiede il Suo dizionario di nomi.
Lo stesso codice di Colonia significa che due schede sono la stessa persona?
No. Un codice uguale indica solo una corrispondenza possibile. Secondi nomi, cognomi da sposata ed errori di trascrizione richiedono ancora un controllo umano o un secondo criterio, come la stessa zona o un anno di nascita simile.
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/cologne-phonetic \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Müller"}'const res = await fetch("https://api.kit.forhosting.com/enc/cologne-phonetic", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "Müller"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/cologne-phonetic",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "Müller"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/cologne-phonetic", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"Müller"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"Müller"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/cologne-phonetic", 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
{
"text": "Müller"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.cologne_phonetic",
"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
Questo codificatore applica le regole classiche di Postel in un Worker puro: maiuscole e ripiegamento delle dieresi, mappatura di ogni lettera con il contesto del vicino, collasso delle cifre identiche consecutive ed eliminazione degli zeri interni. Stringhe vuote e incolla solo di cifre falliscono con invalid_input invece di inventare un successo vuoto.
Contratto di ingresso, campi di risposta e casi invalid_input
Invii in POST un oggetto JSON con la stringa obbligatoria text (alias input, value, name o s). Si applica il trim; soli spazi e campi mancanti falliscono con invalid_input indicando il problema. In caso di successo il corpo ecoa text, restituisce code come stringa di cifre, length come numero di cifre, normalized come sequenza A–Z in maiuscolo dopo il ripiegamento delle dieresi (Ä Ö Ü in A O U, ß in SS), e letter_count per quella sequenza. Abbini l’uguaglianza di code alle proprie soglie (stessa regione postale, anno di nascita simile) per costruire un punteggio di matching; questo endpoint calcola solo la chiave fonetica.
Domande tecniche
Quanto costa il codificatore di fonetica di Colonia?
Lo strumento nel browser è gratuito. Le richieste API usano il saldo prepagato KIT a $0.002 per chiamata riuscita; l’ingresso non valido non viene fatturato.