Algoritmos de coincidencia

Los métodos de puntuación detrás de cada resultado de coincidencia, con el efecto de cada característica y las constantes de la comparación de nombres.

Cada resultado de coincidencia explica su puntuación característica por característica. Esta página enumera los métodos de puntuación que ofrece la API de coincidencias, lo que hace cada característica con la puntuación y las constantes que sustentan la comparación de nombres, de modo que un revisor pueda reproducir cualquier decisión. La misma información está disponible en formato JSON en /api/algorithms.

Cómo se construye una puntuación

Cada palabra del nombre consultado se compara con cada palabra no utilizada del nombre o alias de un registro, mediante la similitud de Jaro-Winkler, una vez eliminados los acentos y los signos de puntuación. Cada palabra de la consulta toma a su mejor pareja.
La puntuación del nombre es el promedio ponderado de las puntuaciones de las palabras (las palabras más largas pesan más), con una reducción por las palabras del registro que la consulta no mencionó y por las consultas de una sola palabra frente a nombres más largos. Se conserva la mejor puntuación entre los nombres y alias del registro.
En el método estándar, la fecha de nacimiento, el país, el número IMO y el tipo de entidad suman o restan puntos a la puntuación del nombre.
El resultado se mantiene entre 0 y 1. match es verdadero cuando la puntuación es igual o superior al umbral de la solicitud (0.75 por defecto).

Estándar `standard` Predeterminado

Alineación del nombre palabra por palabra (Jaro-Winkler), ajustada después según la fecha de nacimiento, la nacionalidad o el país, el número IMO y el tipo de entidad.

Característica	Efecto en la puntuación	Descripción
`name_match`	puntuación base	Mejor alineación del nombre consultado con el nombre del registro o con cualquier alias. Las grafías cercanas cuentan con un descuento; las palabras del registro que la consulta no menciona reducen la puntuación.
`dob_match`	+0.10 coincide · 0 mismo año · −0.25 difiere	Fecha de nacimiento, comparada con la precisión que da el registro (año, mes o día).
`country_match`	+0.05 coincide · −0.10 difiere	Nacionalidad, país, jurisdicción o bandera, como códigos de dos letras ISO 3166.
`identifier_match`	al menos 0.98 coincide · −0.30 difiere	Número IMO de siete dígitos (embarcaciones).
`type_mismatch`	−0.20	El registro es de un tipo de entidad distinto del esquema de la consulta.

Solo nombre `name-only`

Únicamente la alineación del nombre. La fecha de nacimiento, el país, el número IMO y el tipo de entidad se informan como características, pero no modifican la puntuación.

Característica	Efecto en la puntuación	Descripción
`name_match`	puntuación completa	Mejor alineación del nombre consultado con el nombre del registro o con cualquier alias.

Constantes de comparación de nombres

Ambos métodos comparten estas constantes.

Constante	Valor	Significado
`close_spelling`	`0.92`	Un par de palabras con una similitud de Jaro-Winkler igual o superior a este valor cuenta con su valor completo.
`fuzzy_floor`	`0.8`	Un par de palabras entre este valor y 0.92 cuenta con el 85% de su similitud; por debajo de este valor, la palabra se considera no encontrada.
`fuzzy_discount`	`0.85`	Multiplicador aplicado a los pares de palabras cercanos pero no casi exactos.
`extra_word_penalty`	`0.1`	Reducción por cada palabra del registro que la consulta no menciona, hasta el límite indicado a continuación.
`extra_word_cap`	`0.3`	Mayor reducción total por palabras adicionales del registro.
`single_word_factor`	`0.75`	Multiplicador cuando una consulta de una sola palabra se compara con un nombre más largo.
`word_weight`	`max(1, length / 4)`	Las palabras más largas de la consulta pesan más en la puntuación del nombre.
`threshold`	`0.75`	Puntuación predeterminada a partir de la cual match es verdadero. Se puede cambiar en cada solicitud con ?threshold=.

Cómo elegir un método

Use standard a menos que tenga un motivo para no hacerlo: aprovecha todo lo que usted envía. Use name-only para ver hasta dónde llega el nombre por sí solo en un resultado, o para fuentes en las que las fechas de nacimiento y los países no son confiables. Configúrelo en cada solicitud con ?algorithm=; consulte Ajuste del motor de coincidencias.

Por confirmar: Si publicaremos el código del motor de coincidencias o un conjunto de prueba de pares de nombres evaluados para una evaluación independiente.

Última actualización 2026-10-03