Documentation · API de vérification

Réglage du moteur de correspondance

Quels paramètres modifient un résultat de correspondance, ce que fait chaque méthode de calcul du score, les limites du moteur et les données d’entrée les plus utiles.

La correspondance se déroule en deux étapes : des candidats sont réunis à partir de la collection selon les mots du nom et le numéro IMO, puis chacun reçoit un score. Trois paramètres de requête influencent le résultat.

Paramètres

algorithm

La méthode de calcul du score. standard (valeur par défaut) pondère le nom en fonction de la date de naissance, du pays, du numéro IMO et du type d’entité. name-only évalue le nom seul; les autres caractéristiques sont toujours signalées, mais elles ne modifient pas le score. best est accepté et désigne la valeur par défaut actuelle. Pour lister les méthodes, leurs caractéristiques et la valeur par défaut, utilisez :

curl "https://api.crownintelligence.net/api/algorithms"
import requests

info = requests.get("https://api.crownintelligence.net/api/algorithms", timeout=30).json()
print("default:", info["default"], "threshold:", info["threshold"])
for a in info["algorithms"]:
    print(a["name"], "-", a["description"])

threshold

Le score à partir duquel match devient vrai, de 0 à 1. La valeur par défaut est 0.75. Les résultats sous le seuil sont tout de même renvoyés (jusqu’à limit), ce qui vous permet de voir les correspondances partielles; seul l’indicateur change. Augmentez-le pour réduire les alertes sur les noms courants; abaissez-le si vous préférez examiner davantage de résultats.

limit

Nombre de résultats par requête, de 1 à 50, 5 par défaut. La fiche de chaque registre est renvoyée séparément; une même partie inscrite à plusieurs registres peut donc occuper plusieurs places. Augmentez limit si vous souhaitez voir au-delà.

Recommandation : laissez algorithm à sa valeur par défaut, commencez avec le seuil par défaut et ne modifiez le seuil qu’après avoir examiné un échantillon de vos propres résultats.

Méthodes de calcul du score

standard associe chaque mot de votre nom au mot le plus proche du nom ou des alias de la fiche (similarité de Jaro-Winkler), accorde plus de poids aux mots plus longs et pénalise les mots de la fiche que vous n’avez pas mentionnés. Elle ajoute ou retranche ensuite des points selon la date de naissance, le pays, le numéro IMO et le type d’entité. name-only utilise uniquement l’alignement des noms; employez-la pour les listes dont les autres renseignements ne sont pas fiables, et attendez-vous à davantage d’alertes. Les effets exacts et les constantes sont présentés à la page Algorithmes de correspondance.

Poids des caractéristiques

L’effet de chaque caractéristique est fixe pour chaque méthode; les requêtes ne peuvent pas le modifier. Si vous avez besoin d’un comportement différent, choisissez la méthode, ajustez le seuil ou traitez a posteriori le champ features de chaque résultat avec vos propres règles.

Limites

  • Aucune translittération. Les noms en alphabet cyrillique, arabe ou chinois sont comparés tels qu’ils sont écrits. Les fiches comportent souvent des alias en alphabet latin; transmettez les deux écritures lorsque vous les avez.
  • Aucune correspondance phonétique. Les variantes orthographiques ne sont détectées que si elles sont très proches lettre par lettre.
  • Aucune connaissance des diminutifs ni de l’ordre des noms. Les mots du nom sont alignés dans n’importe quel ordre, mais « Bill » ne correspond pas à « William ».
  • Les formes juridiques des sociétés comptent comme des mots. « Example Trading LLC » comparé à « Example Trading Limited » perd un peu en raison du mot différent.
  • Identifiants. Seuls les numéros IMO sont comparés; les numéros d’enregistrement, les numéros fiscaux et les LEI ne sont pas encore pris en compte dans le score.
  • Noms courts. Une requête d’un seul mot comparée à un nom plus long reçoit un score réduit; les mononymes et les noms de sociétés courts nécessitent donc d’autres renseignements pour atteindre le seuil.

Sélection de vos données d’entrée

  • Utilisez le schéma le plus précis que vous connaissez.
  • Transmettez tous les noms et alias que vous détenez, dans toutes les écritures.
  • Transmettez la date de naissance avec la précision dont vous disposez; une année est déjà utile.
  • Transmettez la nationalité, la résidence ou le pays d’enregistrement sous forme de codes ISO.
  • Pour les navires, transmettez toujours le numéro IMO.
  • Réduisez le nombre de candidats à l’aide de la collection et des filtres topics et de registre plutôt qu’en augmentant le seuil seulement.

Pour en savoir plus

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