 |
API Sirene - Documentation des services |
 |
Exemples avancés d'utilisation des facettes imbriquées pour les requêtes multicritères
Facettes imbriquées et facettes sur requêtes
Dénombrement des unités légales suivant leur état administratif et leur catégorie d'entreprise, avec comptage des employeurs :
https://api.insee.fr/entreprises/sirene/V3/siren?facette.champ=etatAdministratifUniteLegale,categorieEntreprise&facette.etatAdministratifUniteLegale.facette=categorieEntreprise&nombre=0&facette.requete=EntrepriseEmployeuse&facette.EntrepriseEmployeuse.q=periode(caractereEmployeurUniteLegale:O)&date=2099-12-31&facette.categorieEntreprise.manquant=true
{
"header": {
"statut": 200,
"message": "OK",
"total": 24399775,
"debut": 0,
"nombre": 0
},
"unitesLegales": [],
"facettes": [
{
"nom": "etatAdministratifUniteLegale",
"comptages": [
{
"valeur": "A",
"nombre": 14640190,
"facettes": [
{
"nom": "categorieEntreprise",
"manquants": 7589121,
"comptages": [
{
"valeur": "PME",
"nombre": 6939614
},
{
"valeur": "ETI",
"nombre": 75411
},
{
"valeur": "GE",
"nombre": 36044
}
]
}
]
},
{
"valeur": "C",
"nombre": 9759585,
"facettes": [
{
"nom": "categorieEntreprise",
"manquants": 8628373,
"comptages": [
{
"valeur": "PME",
"nombre": 1118376
},
{
"valeur": "ETI",
"nombre": 8311
},
{
"valeur": "GE",
"nombre": 4525
}
]
}
]
}
]
},
{
"nom": "EntrepriseEmployeuse",
"total": 4669757
},
{
"nom": "categorieEntreprise",
"manquants": 16217494,
"comptages": [
{
"valeur": "PME",
"nombre": 8057990
},
{
"valeur": "ETI",
"nombre": 83722
},
{
"valeur": "GE",
"nombre": 40569
}
]
}
]
}
Le caractère employeur (EntrepriseEmployeuse) apparaît bien, mais hors des facettes imbriquées. L'affichage des manquants pour la catégorie d'entreprise montre que la donnée n'est présente que pour la moitié des unités légales
Facettes imbriquées et facettes sur intervalle
Dénombrement par année des unités légales dont la date de création est postérieure à 2016, suivant leur état administratif :
https://api.insee.fr/entreprises/sirene/V3/siren?nombre=0&facette.intervalle=dateCreationUniteLegale&facette.dateCreationUniteLegale.demarrage=NOW-5YEAR&facette.dateCreationUniteLegale.fin=NOW&facette.dateCreationUniteLegale.pas=%2B1YEAR&facette.champ=dateCreationUniteLegale,etatAdministratifUniteLegale&facette.etatAdministratifUniteLegale.facette=dateCreationUniteLegale
{
"header": {
"statut": 200,
"message": "OK",
"total": 24820792,
"debut": 0,
"nombre": 0
},
"unitesLegales": [
],
"facettes": [
{
"nom": "etatAdministratifUniteLegale",
"comptages": [
{
"valeur": "A",
"nombre": 14640190,
"facettes": [
{
"nom": "dateCreationUniteLegale",
"comptages": [
{
"valeur": "2017-03-16T14:14:06.937",
"nombre": 575739
},
{
"valeur": "2018-03-16T14:14:06.937",
"nombre": 688936
},
{
"valeur": "2019-03-16T14:14:06.937",
"nombre": 860771
},
{
"valeur": "2020-03-16T14:14:06.937",
"nombre": 965066
},
{
"valeur": "2021-03-16T14:14:06.937",
"nombre": 1055831
}
]
}
]
},
{
"valeur": "C",
"nombre": 10180602,
"facettes": [
{
"nom": "dateCreationUniteLegale",
"comptages": [
{
"valeur": "2017-03-16T14:14:06.937",
"nombre": 196610
},
{
"valeur": "2018-03-16T14:14:06.937",
"nombre": 184419
},
{
"valeur": "2019-03-16T14:14:06.937",
"nombre": 125117
},
{
"valeur": "2020-03-16T14:14:06.937",
"nombre": 89687
},
{
"valeur": "2021-03-16T14:14:06.937",
"nombre": 37533
}
]
}
]
}
]
},
{
"nom": "dateCreationUniteLegale",
"comptages": [
{
"valeur": "2017-03-16T14:14:06.937",
"nombre": 772349
},
{
"valeur": "2018-03-16T14:14:06.937",
"nombre": 873355
},
{
"valeur": "2019-03-16T14:14:06.937",
"nombre": 985888
},
{
"valeur": "2020-03-16T14:14:06.937",
"nombre": 1054753
},
{
"valeur": "2021-03-16T14:14:06.937",
"nombre": 1093364
}
]
}
]
}
Sous-facette
Par défaut, toutes les facettes sont d’abord calculées sur l’ensemble du champ. Pour changer ce comportement et qu’une facette ne soit calculée qu’en tant que sous-facette, il faut la paramétrer ainsi : facette.nomFacette.sousfacette=true.
Exemple sans sousfacette
Dénombrement des établissements selon leur etat administratif et l'appartenance de l'unité légale au champ de l'économie sociale et solidaire :
https://api.insee.fr/entreprises/sirene/V3/siret?facette.champ=etatAdministratifUniteLegale,economieSocialeSolidaireUniteLegale&facette.etatAdministratifUniteLegale.facette=economieSocialeSolidaireUniteLegale&nombre=0
{
"header": {
"statut": 200,
"message": "OK",
"total": 35321739,
"debut": 0,
"nombre": 0
},
"etablissements": [],
"facettes": [
{
"nom": "etatAdministratifUniteLegale",
"comptages": [
{
"valeur": "A",
"nombre": 22584122,
"facettes": [
{
"nom": "economieSocialeSolidaireUniteLegale",
"comptages": [
{
"valeur": "N",
"nombre": 4892827
},
{
"valeur": "O",
"nombre": 1543081
}
]
}
]
},
{
"valeur": "C",
"nombre": 12737617,
"facettes": [
{
"nom": "economieSocialeSolidaireUniteLegale",
"comptages": [
{
"valeur": "N",
"nombre": 238207
},
{
"valeur": "O",
"nombre": 32762
}
]
}
]
}
]
},
{
"nom": "economieSocialeSolidaireUniteLegale",
"comptages": [
{
"valeur": "N",
"nombre": 5131034
},
{
"valeur": "O",
"nombre": 1575843
}
]
}
]
}
Exemple avec sousfacette
Dénombrement des établissements selon leur etat administratif et l'appartenance de l'unité légale au champ de l'économie sociale et solidaire :
https://api.insee.fr/entreprises/sirene/V3/siret?facette.champ=etatAdministratifUniteLegale,economieSocialeSolidaireUniteLegale&facette.etatAdministratifUniteLegale.facette=economieSocialeSolidaireUniteLegale&nombre=0&facette.economieSocialeSolidaireUniteLegale.sousfacette=true
{
"header": {
"statut": 200,
"message": "OK",
"total": 35321739,
"debut": 0,
"nombre": 0
},
"etablissements": [],
"facettes": [
{
"nom": "etatAdministratifUniteLegale",
"comptages": [
{
"valeur": "A",
"nombre": 22584122,
"facettes": [
{
"nom": "economieSocialeSolidaireUniteLegale",
"comptages": [
{
"valeur": "N",
"nombre": 4892827
},
{
"valeur": "O",
"nombre": 1543081
}
]
}
]
},
{
"valeur": "C",
"nombre": 12737617,
"facettes": [
{
"nom": "economieSocialeSolidaireUniteLegale",
"comptages": [
{
"valeur": "N",
"nombre": 238207
},
{
"valeur": "O",
"nombre": 32762
}
]
}
]
}
]
}
]
}
Commentaires