Algorithmes de correspondance

Les méthodes de pointage à la base de chaque résultat de correspondance, avec l’effet de chaque caractéristique et les constantes de la comparaison des noms.

Chaque résultat de correspondance explique son score caractéristique par caractéristique. Cette page présente les méthodes de pointage offertes par l’API de correspondance, l’effet de chaque caractéristique sur le score et les constantes qui sous-tendent la comparaison des noms, afin qu’un réviseur puisse reproduire n’importe quelle décision. Les mêmes renseignements sont accessibles en JSON à l’adresse /api/algorithms.

Comment un score est établi

Chaque mot du nom recherché est comparé à chaque mot non utilisé du nom ou de l’alias d’une fiche, au moyen de la similarité de Jaro-Winkler, après suppression des accents et de la ponctuation. Chaque mot recherché retient son meilleur partenaire.
Le score du nom est la moyenne pondérée des scores des mots (les mots plus longs ont plus de poids), réduite pour les mots de la fiche que la requête ne mentionne pas et pour les requêtes d’un seul mot comparées à des noms plus longs. Le meilleur score parmi les noms et alias de la fiche est conservé.
Pour la méthode standard, la date de naissance, le pays, le numéro IMO et le type d’entité s’ajoutent ensuite au score du nom ou en sont soustraits.
Le résultat est maintenu entre 0 et 1. match est vrai lorsque le score atteint ou dépasse le seuil de la requête (0.75 par défaut).

Standard `standard` Par défaut

Alignement des noms mot à mot (Jaro-Winkler), puis ajustement selon la date de naissance, la nationalité ou le pays, le numéro IMO et le type d’entité.

Caractéristique	Effet sur le score	Description
`name_match`	score de base	Meilleur alignement du nom recherché avec le nom de la fiche ou l’un de ses alias. Les orthographes proches comptent avec un facteur de réduction; les mots de la fiche que la requête ne mentionne pas font baisser le score.
`dob_match`	+0.10 correspondance · 0 même année · −0.25 différente	Date de naissance, comparée selon la précision fournie par la fiche (année, mois ou jour).
`country_match`	+0.05 correspondance · −0.10 différent	Nationalité, pays, territoire ou pavillon, sous forme de codes ISO 3166 à deux lettres.
`identifier_match`	au moins 0.98 correspondance · −0.30 différent	Numéro IMO à sept chiffres (navires).
`type_mismatch`	−0.20	La fiche correspond à un type d’entité différent de celui du schéma de la requête.

Nom seulement `name-only`

L’alignement des noms seul. La date de naissance, le pays, le numéro IMO et le type d’entité sont signalés comme caractéristiques, mais ne modifient pas le score.

Caractéristique	Effet sur le score	Description
`name_match`	score entier	Meilleur alignement du nom recherché avec le nom de la fiche ou l’un de ses alias.

Constantes de comparaison des noms

Les deux méthodes partagent ces constantes.

Constante	Valeur	Signification
`close_spelling`	`0.92`	Une paire de mots dont la similarité de Jaro-Winkler atteint ou dépasse cette valeur compte pleinement.
`fuzzy_floor`	`0.8`	Une paire de mots située entre cette valeur et 0.92 compte pour 85 % de sa similarité; en dessous, le mot est considéré comme introuvable.
`fuzzy_discount`	`0.85`	Multiplicateur appliqué aux paires de mots proches, mais pas quasi identiques.
`extra_word_penalty`	`0.1`	Réduction pour chaque mot de la fiche que la requête ne mentionne pas, jusqu’au plafond ci-dessous.
`extra_word_cap`	`0.3`	Réduction totale maximale pour les mots supplémentaires de la fiche.
`single_word_factor`	`0.75`	Multiplicateur lorsqu’une requête d’un seul mot est comparée à un nom plus long.
`word_weight`	`max(1, length / 4)`	Les mots plus longs de la requête ont plus de poids dans le score du nom.
`threshold`	`0.75`	Score par défaut à partir duquel match est vrai. Modifiez-le pour chaque requête avec ?threshold=.

Choisir une méthode

Utilisez standard sauf si vous avez une raison de faire autrement : cette méthode exploite tout ce que vous envoyez. Utilisez name-only pour voir jusqu’où le nom seul porte un résultat, ou pour les sources dont les dates de naissance et les pays sont peu fiables. Définissez-la pour chaque requête avec ?algorithm=; consultez Réglage du moteur de correspondance.

À préciser : si nous publierons le code du moteur de correspondance ou un jeu de test de paires de noms évaluées, aux fins d’une évaluation indépendante.

Dernière mise à jour : 2026-10-03