Encodeur Soundex
Robert et Rupert donnent le même code, R163 : la première lettre reste, les sons de consonnes suivants deviennent trois chiffres et les codes courts sont complétés par des zéros, si bien que des noms proches à l'oreille se retrouvent ensemble. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Nom
- Robert
- Code
- R163
- Normalisé
- ROBERT
- Longueur
- 6
Le Soundex américain est l'index phonétique classique du recensement américain et de la généalogie qui transforme un nom personnel ou de famille en un code de quatre caractères : la première lettre conservée plus trois chiffres qui représentent des groupes de sons consonantiques. Des noms qui se prononcent de même mais s'écrivent différemment—Robert et Rupert, Smith et Smythe—partagent souvent le même code Soundex, c'est pourquoi archivistes, historiens de famille et scripts de rapprochement de dossiers l'utilisent encore comme première clé de regroupement. Cet encodeur Soundex accepte une chaîne de nom non vide, normalise les lettres latines, applique la table de chiffres standard et les règles d'adjacence, et renvoie le code avec la forme normalisée utilisée pour le codage.
Comment le Soundex américain construit un code lettre plus trois chiffres
Le Soundex commence par passer le nom en majuscules et ne conserver que les lettres latines de A à Z ; chiffres, espaces, tirets et ponctuation sont retirés avant le codage, de sorte qu'un champ de formulaire avec des espaces en trop fonctionne encore. La première lettre de cette chaîne normalisée est conservée telle quelle et devient le caractère initial du code.
Chaque lettre suivante est soit mappée vers un chiffre, soit écartée : B, F, P et V donnent 1 ; C, G, J, K, Q, S, X et Z donnent 2 ; D et T donnent 3 ; L donne 4 ; M et N donnent 5 ; R donne 6. Les voyelles A, E, I, O, U et la lettre Y ne produisent aucun chiffre.
H et W n'en produisent pas non plus, mais contrairement aux voyelles ils ne rompent pas une série du même code numérique—ainsi Ashcraft et Ashcroft deviennent toutes deux A261 après fusion du groupe S/C à travers le H. Les lettres adjacentes qui partagent le même chiffre ne contribuent qu'une fois, c'est pourquoi Jackson devient J250 plutôt qu'une longue suite de deux. Après avoir recueilli au plus trois chiffres, les places manquantes sont complétées par des zéros afin que chaque résultat réussi tienne exactement quatre caractères.
À quoi sert le Soundex en généalogie
Les généalogistes et les projets d'histoire locale utilisent un encodeur Soundex pour regrouper des noms de recensement et de listes de passagers enregistrés avec une orthographe inconsistante. Les outils CRM et de support client peuvent regrouper des noms de famille ressemblants avant une revue humaine sans déployer un moteur complet de recherche floue. Les démonstrations en classe d'algorithmes d'indexation historique ont besoin d'un oracle déterministe que les élèves peuvent appeler depuis le navigateur pendant que l'enseignant montre la table des chiffres au tableau.
Les notebooks de nettoyage de données peuvent émettre le Soundex comme une colonne de caractéristiques à côté des minuscules et de Metaphone lors de la construction de features de résolution d'entités. Les échecs de validation ne consomment jamais le solde après le rejet du moteur.
Associez-le à d'autres utilitaires texte seulement lorsqu'une étape ultérieure exige un autre schéma phonétique ou de chiffrement ; gardez le Soundex américain sur sa propre landing pour que l'intention SEO reste nette et que le guide reste honnête sur ce que le code à quatre caractères peut et ne peut pas faire.
Cas d’usage
Regroupement de noms en généalogie et recensements
Regroupez des noms de famille qui se prononcent de même mais s'écrivaient différemment dans les archives historiques en comparant des codes Soundex américain à quatre caractères.
Pré-correspondance floue de noms en CRM
Regroupez des noms de clients ressemblants pour une revue humaine sans installer une pile complète de résolution d'entités à chaque envoi de formulaire.
Questions fréquentes
Comment encoder un nom avec le Soundex américain ?
Le champ code de la réponse contient la valeur Soundex à quatre caractères (R163 pour Robert).
Pourquoi Robert et Rupert partagent-ils le même code ?
Le Soundex mappe des consonnes similaires vers les mêmes chiffres et ne conserve que la première lettre plus trois chiffres, de sorte que des noms qui sonnent de même entrent souvent en collision volontairement pour la correspondance floue.
Le Soundex est-il la même chose que Metaphone ou le phonétique OTAN ?
Non. Cet outil n'implémente que le Soundex américain (lettre plus trois chiffres). Metaphone, Double Metaphone et les alphabets d'épellation OTAN sont des algorithmes et des landings distincts.
Pourquoi H et W ne séparent-ils pas les lettres comme les voyelles ?
En Soundex américain, une voyelle entre deux consonnes du même groupe fait compter les deux, mais pas H ni W. C'est pourquoi Ashcraft devient A261 : le S et le C partagent un chiffre et, séparés seulement par un H, ne comptent qu'une fois.
Pourquoi le code Soundex a-t-il toujours quatre caractères ?
Parce que la méthode garde la première lettre et au plus trois chiffres. Si le nom en donne moins, les places manquantes sont complétées par des zéros ; s'il en donne plus, le reste est ignoré. Tous les codes se comparent ainsi à longueur égale.
Outils associés
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre 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)Exemple de requête
{
"name": "Robert"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.soundex",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |
Notes techniques
Une entrée vide, un nom manquant ou une chaîne sans lettres A–Z échoue avec invalid_input afin que les appelants puissent signaler les formulaires vides au lieu d'inventer un code. Le chemin gratuit du navigateur et l'API prépayée partagent la même logique parse pure, de sorte que démonstrations scolaires et pipelines de production ne divergent jamais entre Robert et Rupert.
Comment le Soundex américain construit un code lettre plus trois chiffres
Comme le chemin est une arithmétique pure de caractères sans réseau ni horloge, des noms identiques produisent toujours le même JSON pour les goldens d'intégration continue.
Contrat d'entrée, drapeaux de vide, forme de réponse et erreurs courantes
Ne traitez pas le Soundex comme un chiffrement ni comme un identifiant unique de personne : de nombreux noms de famille non liés entrent en collision volontairement, et cette collision est l'avantage de la correspondance floue, non un défaut. Préférez cette landing lorsque l'intention de recherche est encodeur soundex, Soundex américain ou code phonétique de nom ; l'épellation phonétique OTAN, Metaphone et les outils de chiffrement généraux répondent à d'autres intentions et restent sur des pages distinctes. Les lettres accentuées hors de la pure A–Z sont retirées avec les autres non-lettres ; fournissez donc une forme normalisée ASCII si vos données source portent des diacritiques et que vous avez besoin que ces lettres participent. Envoyez un corps JSON avec le champ chaîne obligatoire name égal au nom de personne ou de famille à encoder. Les alias text, input, value et s sont acceptés lorsque les clients réutilisent d'anciens noms de formulaire ou des widgets texte partagés. Un name manquant, une valeur non chaîne, une chaîne de longueur nulle, du seul blanc ou une chaîne sans lettres latines lèvent invalid_input et ne sont pas facturés sur l'API prépayée—c'est le chemin de drapeau d'entrée vide promis par le produit, exprimé comme erreur de validation dure plutôt qu'un corps de succès avec code vide. En cas de succès la réponse inclut code (la valeur Soundex à quatre caractères), method égal à american_soundex pour que les routeurs en aval puissent brancher sans deviner les formes, name qui reprend la chaîne d'origine, normalized avec la séquence A–Z en majuscules réellement codée, empty toujours false en succès, et length égal au nombre de caractères d'origine avant filtrage.
Où une API Soundex apporte de la valeur et comment fonctionne le tarif
Utilisez l'outil gratuit dans le navigateur pour des contrôles ponctuels et l'enseignement ; utilisez l'API KIT prépayée lorsqu'un backend, une fonction serverless ou un SDK a besoin d'un contrat stable sous solde à $0.002 par élément réussi. Gardez des charges de longueur de nom ordinaires adaptées à un appel d'item dans un Worker isolate : cet outil sert aux noms et étiquettes courtes, pas aux documents multi-mégaoctets.
Cas d'intégration
Démonstrations d'index phonétique en classe
Montrez aux élèves que Robert et Rupert partagent R163 tandis que les formulaires vides échouent clairement, avec le même chemin gratuit du navigateur que l'API.
Questions techniques
Que se passe-t-il si le nom est vide ?
La requête échoue avec invalid_input. Une entrée manquante, blanche ou sans lettres est signalée comme vide et n'est pas facturée sur l'API prépayée.
L'encodeur Soundex est-il gratuit ?
L'outil navigateur s'exécute gratuitement sur votre appareil. Les appels API utilisent le solde KIT prépayé à $0.002 par élément réussi ; les échecs de validation ne sont pas facturés.