 |
API Sirene - Documentation des services |
 |
Utilisation des facettes pour les requêtes multicritères
Facettes imbriquées
Les facettes imbriquées permettent d’effectuer des comptages à l’intérieur des facettes déjà créées.
La syntaxe est la suivante :
a) indiquer l'ensemble des champs demandés
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.
Tous les types de facettes (champ, requête et intervalle) peuvent être imbriquées les uns dans les autres.
La profondeur des facettes a été limitée à 5.facette.champ=liste des variables séparées par des virgules, sans espace
b) indiquer la façon dont les champs sont imbriqués
facette.nomFacette.facette=nomFacette2
facette.nomFacette2.facette=nomFacette3
...
Exemples avec une profondeur de 2 : comparaison des deux imbrications possibles
Sens 1 : dénombrement des établissements suivant leur état administratif et celui de l'unité légale à laquelle ils se rattachent :
https://api.insee.fr/api-sirene/3.11/siret?facette.champ=etatAdministratifUniteLegale,etatAdministratifEtablissement&facette.etatAdministratifUniteLegale.facette=etatAdministratifEtablissement&nombre=0
{
"header": {
"statut": 200,
"message": "OK",
"total": 35321739,
"debut": 0,
"nombre": 0
},
"etablissements": [],
"facettes": [
{
"nom": "etatAdministratifUniteLegale",
"comptages": [
{
"valeur": "A",
"nombre": 22584122,
"facettes": [
{
"nom": "etatAdministratifEtablissement",
"comptages": [
{
"valeur": "A",
"nombre": 14354644
},
{
"valeur": "F",
"nombre": 8229478
}
]
}
]
},
{
"valeur": "C",
"nombre": 12737617,
"facettes": [
{
"nom": "etatAdministratifEtablissement",
"comptages": [
{
"valeur": "F",
"nombre": 12737596
},
{
"valeur": "A",
"nombre": 21
}
]
}
]
}
]
},
{
"nom": "etatAdministratifEtablissement",
"comptages": [
{
"valeur": "F",
"nombre": 20967074
},
{
"valeur": "A",
"nombre": 14354665
}
]
}
]
}
Sens 2 : dénombrement des établissements suivant l'état administratif de l'unité légale à laquelle ils se rattachent et le leur :
https://api.insee.fr/api-sirene/3.11/siret?facette.champ=etatAdministratifUniteLegale,etatAdministratifEtablissement&facette.etatAdministratifEtablissement.facette=etatAdministratifUniteLegale&nombre=0
{
"header": {
"statut": 200,
"message": "OK",
"total": 35321739,
"debut": 0,
"nombre": 0
},
"etablissements": [],
"facettes": [
{
"nom": "etatAdministratifUniteLegale",
"comptages": [
{
"valeur": "A",
"nombre": 22584122
},
{
"valeur": "C",
"nombre": 12737617
}
]
},
{
"nom": "etatAdministratifEtablissement",
"comptages": [
{
"valeur": "F",
"nombre": 20967074,
"facettes": [
{
"nom": "etatAdministratifUniteLegale",
"comptages": [
{
"valeur": "C",
"nombre": 12737596
},
{
"valeur": "A",
"nombre": 8229478
}
]
}
]
},
{
"valeur": "A",
"nombre": 14354665,
"facettes": [
{
"nom": "etatAdministratifUniteLegale",
"comptages": [
{
"valeur": "A",
"nombre": 14354644
},
{
"valeur": "C",
"nombre": 21
}
]
}
]
}
]
}
]
}
Exemple avec une profondeur de 3
Dénombrement des établissements selon l'etat administratif de l'unité légale à laquelle ils se rattachent, l'appartenance de celle-ci au champ de l'économie sociale et solidaire et à celui des employeurs :
https://api.insee.fr/api-sirene/3.11/siret?facette.champ=economieSocialeSolidaireUniteLegale,etatAdministratifUniteLegale,caractereEmployeurUniteLegale&facette.etatAdministratifUniteLegale.facette=economieSocialeSolidaireUniteLegale&facette.economieSocialeSolidaireUniteLegale.facette=caractereEmployeurUniteLegale&nombre=0
{
"header": {
"statut": 200,
"message": "OK",
"total": 35321739,
"debut": 0,
"nombre": 0
},
"etablissements": [],
"facettes": [
{
"nom": "economieSocialeSolidaireUniteLegale",
"comptages": [
{
"valeur": "N",
"nombre": 5131034,
"facettes": [
{
"nom": "caractereEmployeurUniteLegale",
"comptages": [
{
"valeur": "N",
"nombre": 2681274
},
{
"valeur": "O",
"nombre": 2449758
}
]
}
]
},
{
"valeur": "O",
"nombre": 1575843,
"facettes": [
{
"nom": "caractereEmployeurUniteLegale",
"comptages": [
{
"valeur": "N",
"nombre": 1084601
},
{
"valeur": "O",
"nombre": 491242
}
]
}
]
}
]
},
{
"nom": "etatAdministratifUniteLegale",
"comptages": [
{
"valeur": "A",
"nombre": 22584122,
"facettes": [
{
"nom": "economieSocialeSolidaireUniteLegale",
"comptages": [
{
"valeur": "N",
"nombre": 4892827,
"facettes": [
{
"nom": "caractereEmployeurUniteLegale",
"comptages": [
{
"valeur": "N",
"nombre": 2522426
},
{
"valeur": "O",
"nombre": 2370399
}
]
}
]
},
{
"valeur": "O",
"nombre": 1543081,
"facettes": [
{
"nom": "caractereEmployeurUniteLegale",
"comptages": [
{
"valeur": "N",
"nombre": 1068051
},
{
"valeur": "O",
"nombre": 475030
}
]
}
]
}
]
}
]
},
{
"valeur": "C",
"nombre": 12737617,
"facettes": [
{
"nom": "economieSocialeSolidaireUniteLegale",
"comptages": [
{
"valeur": "N",
"nombre": 238207,
"facettes": [
{
"nom": "caractereEmployeurUniteLegale",
"comptages": [
{
"valeur": "N",
"nombre": 158848
},
{
"valeur": "O",
"nombre": 79359
}
]
}
]
},
{
"valeur": "O",
"nombre": 32762,
"facettes": [
{
"nom": "caractereEmployeurUniteLegale",
"comptages": [
{
"valeur": "N",
"nombre": 16550
},
{
"valeur": "O",
"nombre": 16212
}
]
}
]
}
]
}
]
}
]
},
{
"nom": "caractereEmployeurUniteLegale",
"comptages": [
{
"valeur": "N",
"nombre": 28623795
},
{
"valeur": "O",
"nombre": 6697782
}
]
}
]
}
Autres exemples
Facettes imbriquées et facettes sur requêtes, facettes imbriquées et facettes sur intervalles...
Disponibles sur cette page.
Commentaires
Rappel : les facettes ne sont pas disponibles en csv. Les facettes imbriquées ne sont pas disponibles sur la console.
Pour en savoir plus