API Sirene - Documentation des services
retour au sommaire
Requêtes multicritères : la variable score
Le score est une variable calculée par Solr, qui matérialise l’importance selon Solr du document renvoyé compte tenu de la requête. Pour API Sirene, un document est soit une unité légale avec toutes ses périodes soit un établissement avec toutes ses périodes. Solr calcule ce score de la manière suivante (principalement) :
• La fréquence à laquelle apparaît un terme dans un document. À partir d’une requête, plus le terme demandé apparaît dans un document, plus son score est élevé.Il est possible d’afficher le score attribué grâce au paramètre champs.
• La fréquence inverse de document : plus le terme est rare dans l’ensemble des documents, plus le document le contenant aura un score élevé.
• « Facteur de coordination » : s’il y a plusieurs termes dans une requête, plus il y a de termes qui apparaissent plus le score est élevé.
• Longueur de champ : plus le champ est petit, plus le score sera élevé si on y trouve un terme.
La syntaxe est la suivante : champs : score, {liste des variables désirées dans la sortie}Exemple
Recherche de l'unité légale dont la dénomination est la plus proche de Airbus :
https://api.insee.fr/entreprises/sirene/V3.11/siren?q=periode(denominationUniteLegale:airbus)&champs=score,siren,denominationUniteLegale&nombre=5&date=2099-12-31{ "header": { "statut": 200, "message": "OK", "total": 136, "debut": 0, "nombre": 5 }, "unitesLegales": [ { "score": 16.602072, "siren": "303242887", "periodesUniteLegale": [ { "dateFin": null, "dateDebut": "1985-12-25", "denominationUniteLegale": "AIRBUS" } ] }, { "score": 16.195581, "siren": "383474814", "periodesUniteLegale": [ { "dateFin": null, "dateDebut": "2017-12-31", "denominationUniteLegale": "AIRBUS" }, { "dateFin": "2017-12-30", "dateDebut": "2017-07-01", "denominationUniteLegale": "AIRBUS" }, { "dateFin": "2017-06-30", "dateDebut": "2010-12-31", "denominationUniteLegale": "AIRBUS" }, { "dateFin": "2010-12-30", "dateDebut": "2010-04-23", "denominationUniteLegale": "AIRBUS" }, { "dateFin": "2010-04-22", "dateDebut": "2009-12-07", "denominationUniteLegale": "AIRBUS SAS" }, { "dateFin": "2009-12-06", "dateDebut": "2008-12-31", "denominationUniteLegale": "AIRBUS SAS" }, { "dateFin": "2008-12-30", "dateDebut": "2008-01-01", "denominationUniteLegale": "AIRBUS SAS" }, { "dateFin": "2007-12-31", "dateDebut": "2006-03-01", "denominationUniteLegale": "AIRBUS SAS" }, { "dateFin": "2006-02-28", "dateDebut": "2003-12-25", "denominationUniteLegale": "AIRBUS" }, { "dateFin": "2003-12-24", "dateDebut": "2002-12-25", "denominationUniteLegale": "AIRBUS" }, { "dateFin": "2002-12-24", "dateDebut": "2001-12-25", "denominationUniteLegale": "AIRBUS" }, { "dateFin": "2001-12-24", "dateDebut": "2001-01-01", "denominationUniteLegale": "AIRBUS" }, { "dateFin": "2000-12-31", "dateDebut": "2000-01-01", "denominationUniteLegale": "EADS AIRBUS" }, { "dateFin": "1999-12-31", "dateDebut": "1999-12-25", "denominationUniteLegale": "AIRBUS INTEGRATED COMPANY" }, { "dateFin": "1999-12-24", "dateDebut": "1991-10-18", "denominationUniteLegale": "AIRBUS INTEGRATED COMPANY" } ] }, { "score": 16.186237, "siren": "302609607", "periodesUniteLegale": [ { "dateFin": null, "dateDebut": "2004-12-25", "denominationUniteLegale": "AIRBUS" }, { "dateFin": "2004-12-24", "dateDebut": "2004-04-26", "denominationUniteLegale": "AIRBUS" }, { "dateFin": "2004-04-25", "dateDebut": "2004-01-01", "denominationUniteLegale": "AIRBUS" }, { "dateFin": "2003-12-31", "dateDebut": "2003-12-31", "denominationUniteLegale": "AIRBUS SNC" }, { "dateFin": "2003-12-30", "dateDebut": "2001-12-25", "denominationUniteLegale": "AIRBUS" }, { "dateFin": "2001-12-24", "dateDebut": "2000-12-25", "denominationUniteLegale": "AIRBUS" }, { "dateFin": "2000-12-24", "dateDebut": "1980-01-01", "denominationUniteLegale": "AIRBUS" }, { "dateFin": "1979-12-31", "dateDebut": "1900-01-01", "denominationUniteLegale": "AIRBUS" } ] }, { "score": 14.099013, "siren": "331139980", "periodesUniteLegale": [ { "dateFin": null, "dateDebut": "2007-11-20", "denominationUniteLegale": "AIRBUS PRODUCTION" }, { "dateFin": "2007-11-19", "dateDebut": "1998-12-25", "denominationUniteLegale": "AIRBUS PRODUCTION" }, { "dateFin": "1998-12-24", "dateDebut": "1991-12-25", "denominationUniteLegale": "AIRBUS PRODUCTION" }, { "dateFin": "1991-12-24", "dateDebut": "1984-10-01", "denominationUniteLegale": "AIRBUS PRODUCTION" } ] }, { "score": 14.099013, "siren": "381734805", "periodesUniteLegale": [ { "dateFin": null, "dateDebut": "2007-06-29", "denominationUniteLegale": "AIRBUS PARTICIPATIONS" }, { "dateFin": "2007-06-28", "dateDebut": "2002-01-01", "denominationUniteLegale": "AIRBUS PARTICIPATIONS" }, { "dateFin": "2001-12-31", "dateDebut": "1991-12-25", "denominationUniteLegale": "AI PARTICIPATIONS" }, { "dateFin": "1991-12-24", "dateDebut": "1991-04-25", "denominationUniteLegale": "AI PARTICIPATIONS" } ] } ] }Commentaires
La variable score n'est pas affichée en csv.
La variable score est disponible sur la console. Pour en savoir plus
Haut de page