InseeDonneesLocalesConnector
Nécessite la version 2021.1 de FME ou plus récente.
Ce Transformer extrait des informations sur le recensement de population de l’API DonneesLocales - V0.1 de l'Institut National de la Statistique et des Études Économiques (INSEE). Cette API donne accès aux données localisées à la commune diffusées sur le site de l’INSEE.
La recherche s’effectue à partir d’une source, d’un croisement de variables et d’un code géographique (code INSEE d'une commune). Cependant tous les croisements ne sont pas possibles sur toutes les zones géographiques pour garantir une interprétation de qualité.
InseeDonneesLocalesConnector gère les limites d'utilisation de l'API (30 requêtes max. par minute) et peut donc être exploité pour des traitements intensifs. Cependant l’INSEE se réserve le droit de changer cette limite en cas de nécessité.
Aperçu du Transformer InseeDonneesLocalesConnector
Important
Il est nécessaire de disposer d'une double clef d'accès au service DonneesLocales - V0.1 de l'INSEE (clef + secret). La procédure est gratuite, elle est décrite dans Procédure pour obtenir une clef d'accès aux services de l'INSEE
Paramètres
Paramètres du Transformer InseeDonneesLocalesConnector
- Clef INSEE
- Type
Chaîne de caractères
- Obligatoire
Oui
- Défaut
Vide
- Description
Clef du consommateur de l'API INSEE.
- Code secret INSEE
- Type
Mot de passe
- Obligatoire
Oui
- Défaut
Vide
- Description
Code secret du consommateur de l'API INSEE.
- Code INSEE de la commune
- Type
Nombre
- Longueur
5 chiffres
- Obligatoire
Oui
- Défaut
Vide
- Description
Numéro INSEE de la commune.
- Jeu de données
- Type
Choix éditable
- Obligatoire
Oui
- Sensible à la casse
Oui
- Défaut
Recensement 2019 Millesime 2022 (GEO2022RP2019)
- Description
Nom du jeu de données dans lequel aller chercher l’information.
- Croisement
- Type
Choix éditable
- Obligatoire
Oui
- Sensible à la casse
Oui
- Défaut
Population par sexe et âge en 7 tranches (SEXE-AGE15_15_90)
- Description
Nom du croisement s’appliquant à la recherche.
Attributs en sortie
Le Transformer dispose de quatre sorties : Metadata, Data, Initiator et Rejected.
Metadata
La sortie Metadata comprend les codes des variables de croisement, leurs libellés ainsi que des listes FME composées des éléments permettant de lire les résultats des croisements.
Sortie Metadata du Transformer InseeDonneesLocalesConnector
Liste des attributs :
Nom attribut Transformer |
Description de l'attribut |
|---|---|
meta.variable |
Code de la variable de croisement |
meta.libelle |
Libellé de la variable de croisement |
meta.modality{}.code |
Attribut de liste des codes des résultats possibles |
meta.modality{}.variable |
Attribut de liste des variables des résultats possibles |
meta.modality{}.libelle |
Attribut de liste des libellés des variables des résultats possibles |
Data
La sortie Data comprend les résultats des croisements.
Sortie Data du Transformer InseeDonneesLocalesConnector
Liste des attributs :
Nom attribut Transformer |
Description de l'attribut |
|---|---|
request.jeu_donnees |
Code du jeu de données |
request.croisement |
Code du croisement |
request.codgeo |
Code de la commune |
mesure |
Type de mesure appliquée |
value |
Résultats du croisement (Nombre) |
variable1.name.code |
Code de la première variable de croisement |
variable1.name.libelle |
Description du code |
variable1.value.code |
Valeur de la première variable de croisement |
variable1.value.libelle |
Description de la valeur |
variable2.name.code |
Code de la deuxième variable de croisement |
variable2.name.libelle |
Description du code |
variable2.value.code |
Valeur de la deuxième variable de croisement |
variable2.value.libelle |
Description de la valeur |
Initiator
La sortie Initiator résume chaque requête avec le nombre de résultats trouvés pour chacune d'entre elles et les données en entrée.
Sortie Initiator du Transformer InseeDonneesLocalesConnector
Liste des attributs :
Nom attribut Transformer |
Description de l'attribut |
|---|---|
request.jeu_donnees |
Code du jeu de données |
request.croisement |
Code du croisement |
request.codgeo |
Code de la commune |
request.nbResult |
Nombre de résultats en sortie pour chaque entrée |
Rejected
La sortie Rejected résume une requête en erreur avec le code de l'erreur et le log.
Sortie Rejected du Transformer InseeDonneesLocalesConnector
Liste des attributs :
Nom attribut Transformer |
Description de l'attribut |
|---|---|
request.jeu_donnees |
Code du jeu de données |
request.croisement |
Code du croisement |
request.codgeo |
Code de la commune |
request.status |
Statut de la requête |
request.error |
Message d’erreur |
Exemple
Dans cet exemple l'utilisateur cherche la population par sexes et âges sur plusieurs communes. La sortie Metadata liste deux variables de croisement dans cet exemple : sexe et âge. Sur chacun des croisements un attribut de liste résume les différentes valeurs que peut prendre la variable de croisement avec un code, un libellé et une description pour chaque valeur. Par exemple ici le code de la variable SEXE peut prendre trois valeurs : 1 (pour les hommes), 2 (pour les femmes) et ENS (pour les deux).
C'est cette liste qui permet de déchiffrer le résultat du croisement disponible dans la sortie Data.
Résultats de la sortie Metadata
Attribut de liste comprenant les valeurs d'une variable de croisement
La sortie Data résume les résultats du croisement demandé.
On peut lire sur la première ligne qu'il y a une population de 39893 habitants pour l'ensemble des hommes et des femmes (variable1) sur l'ensemble des tranches d'âge (variable2).
Sur la cinquième ligne il y a une population de 3099.768843 habitants pour les hommes (variable1) âgés de 0 à 14 ans (variable2).
Résultats de la sortie Data