Documentación · API de verificación

Ajuste del motor de coincidencias

Qué parámetros modifican el resultado de una coincidencia, qué hace cada método de puntuación, dónde se queda corto el motor y qué datos de entrada ayudan más.

La búsqueda de coincidencias se realiza en dos etapas: primero se reúnen candidatos de la colección según las palabras del nombre y el número IMO, y luego se puntúa cada uno. Tres parámetros de la solicitud modifican el resultado.

Parámetros

algorithm

El método de puntuación. standard (el predeterminado) pondera el nombre junto con la fecha de nacimiento, el país, el número IMO y el tipo de entidad. name-only puntúa solo el nombre; las demás características se siguen informando, pero no modifican la puntuación. best se acepta y significa el valor predeterminado actual. Para listar los métodos, sus características y el valor predeterminado, use:

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

La puntuación a partir de la cual match pasa a ser verdadero, de 0 a 1. El valor predeterminado es 0.75. Los resultados por debajo del umbral también se devuelven (hasta limit), de modo que pueda ver las coincidencias cercanas; solo cambia el indicador. Auméntelo para reducir las alertas con nombres comunes; redúzcalo si prefiere revisar más casos.

limit

Resultados por consulta, de 1 a 50, con 5 como valor predeterminado. El registro de cada registro se devuelve por separado, por lo que una misma parte incluida en varios registros puede ocupar varias posiciones; aumente limit si desea ver más allá de ellas.

Recomendado: deje algorithm en su valor predeterminado, comience con el umbral predeterminado y modifíquelo solo después de revisar una muestra de sus propios resultados.

Métodos de puntuación

standard alinea cada palabra de su nombre con la palabra más cercana del nombre o de los alias del registro (similitud de Jaro-Winkler), da más peso a las palabras más largas y resta valor a las palabras del registro que usted no mencionó. Luego suma o resta puntos según la fecha de nacimiento, el país, el número IMO y el tipo de entidad. name-only utiliza únicamente la alineación del nombre; úselo para listas en las que los demás datos no son confiables, y espere más alertas. Los efectos exactos y las constantes se encuentran en Algoritmos de coincidencia.

Pesos de las características

El efecto de cada característica es fijo para cada método; las solicitudes no pueden modificarlo. Si necesita un comportamiento distinto, elija el método, ajuste el umbral o procese posteriormente el features de cada resultado con sus propias reglas.

Limitaciones

  • Sin transliteración. Los nombres en escritura cirílica, árabe o china se comparan tal como están escritos. Los registros suelen incluir alias en escritura latina; envíe ambas escrituras cuando las tenga.
  • Sin coincidencia fonética. Las variantes ortográficas solo se detectan cuando son muy cercanas letra por letra.
  • Sin conocimiento de apodos ni del orden de los nombres. Las palabras del nombre se alinean en cualquier orden, pero "Bill" no coincide con "William".
  • Las formas jurídicas de las empresas cuentan como palabras. "Example Trading LLC" frente a "Example Trading Limited" pierde un poco de puntuación por la palabra distinta.
  • Identificadores. Solo se comparan los números IMO; los números de registro, los números fiscales y los LEI todavía no se puntúan.
  • Nombres cortos. Una consulta de una sola palabra frente a un nombre más largo recibe una puntuación menor, por lo que los mononombres y los nombres de empresa cortos necesitan otros datos para alcanzar el umbral.

Selección de los datos de entrada

  • Use el esquema más específico que conozca.
  • Envíe todos los nombres y alias que tenga, en todas las escrituras.
  • Envíe la fecha de nacimiento con la precisión de que disponga; incluso un año ayuda.
  • Envíe la nacionalidad, la residencia o el país de registro como códigos ISO.
  • En el caso de embarcaciones, envíe siempre el número IMO.
  • Reduzca los candidatos con los filtros de colección, topics y registro, en lugar de solo aumentar el umbral.

Lecturas adicionales

Última actualización 2026-10-03