@leximpact/territoires
v1.0.1
Published
Various APIs for French territories: communes autocompleter, etc
Downloads
6
Readme
LexImpact Territoires
Diverses API pour les territoires français : autocomplétion des communes, etc
Installation
git clone https://git.leximpact.dev/leximpact/territoires.git
cd territoires/
npm install
Mise à jour des données sur les territoires
Base officielle des codes postaux
cf https://www.data.gouv.fr/fr/datasets/base-officielle-des-codes-postaux/
mkdir -p data
wget https://datanova.laposte.fr/data-fair/api/v1/datasets/laposte-hexasmal/metadata-attachments/base-officielle-codes-postaux.csv -O data/laposte_hexasmal.csv
npx tsx src/scripts/import_laposte_hexasmal.ts
Code officiel géographique
- Code officiel géographique au 1er janvier 2022
- Code officiel géographique au 1er janvier 2023
- Code officiel géographique au 1er janvier 2024
Fichier des communes
# wget "https://www.insee.fr/fr/statistiques/fichier/6051727/commune_2022.csv" -O data/commune.csv
# wget "https://www.insee.fr/fr/statistiques/fichier/6800675/v_commune_2023.csv" -O data/commune.csv
wget "https://www.insee.fr/fr/statistiques/fichier/7766585/v_commune_2024.csv" -O data/commune.csv
npx tsx src/scripts/import_code_officiel_geographique_commune.ts
Fichier des communes des collectivités d'outre-mer
# wget "https://www.insee.fr/fr/statistiques/fichier/6051727/com_comer_2022.csv" -O data/com_comer.csv
# wget "https://www.insee.fr/fr/statistiques/fichier/6800675/v_commune_comer_2023.csv" -O data/com_comer.csv
wget "https://www.insee.fr/fr/statistiques/fichier/7766585/v_commune_comer_2024.csv" -O data/com_comer.csv
npx tsx src/scripts/import_code_officiel_geographique_com_comer.ts
Fichier des évènements sur les communes
# wget "https://www.insee.fr/fr/statistiques/fichier/6051727/mvtcommune_2022.csv" -O data/mvtcommune.csv
# wget "https://www.insee.fr/fr/statistiques/fichier/6800675/v_mvtcommune_2023.csv" -O data/mvtcommune.csv
wget "https://www.insee.fr/fr/statistiques/fichier/7766585/v_mvt_commune_2024.csv" -O data/mvtcommune.csv
npx tsx src/scripts/import_code_officiel_geographique_mvtcommune.ts
Fichier des départements
# wget "https://www.insee.fr/fr/statistiques/fichier/6051727/departement_2022.csv" -O data/departement.csv
# wget "https://www.insee.fr/fr/statistiques/fichier/6800675/v_departement_2023.csv" -O data/departement.csv
wget "https://www.insee.fr/fr/statistiques/fichier/7766585/v_departement_2024.csv" -O data/departement.csv
npx tsx src/scripts/import_code_officiel_geographique_departement.ts
Fichier des collectivités d'outre-mer
# wget "https://www.insee.fr/fr/statistiques/fichier/6051727/comer_2022.csv" -O data/comer.csv
# wget "https://www.insee.fr/fr/statistiques/fichier/6800675/v_comer_2023.csv" -O data/comer.csv
wget "https://www.insee.fr/fr/statistiques/fichier/7766585/v_comer_2024.csv" -O data/comer.csv
npx tsx src/scripts/import_code_officiel_geographique_comer.ts
Fichier des intercommunalités (établissements publics de coopération intercommunale, EPCI)
cf https://www.insee.fr/fr/information/2510634
cd data/
# wget "https://www.insee.fr/fr/statistiques/fichier/2510634/Intercommunalite_Metropole_au_01-01-2022.zip"
# unzip Intercommunalite_Metropole_au_01-01-2022.zip
# rm Intercommunalite_Metropole_au_01-01-2022.zip
# mv Intercommunalite_Metropole_au_01-01-2022.xlsx epci.xlsx
# wget "https://www.insee.fr/fr/statistiques/fichier/2510634/Intercommunalite_Metropole_au_01-01-2023.zip"
# unzip Intercommunalite_Metropole_au_01-01-2023.zip
# rm Intercommunalite_Metropole_au_01-01-2023.zip
# mv Intercommunalite_Metropole_au_01-01-2023.xlsx epci.xlsx
wget "https://www.insee.fr/fr/statistiques/fichier/2510634/epci_au_01-01-2024.zip"
unzip epci_au_01-01-2024.zip
rm epci_au_01-01-2024.zip
mv EPCI_au_01-01-2024.xlsx epci.xlsx
cd ../
npx tsx src/scripts/import_epci.ts
Circonscriptions législatives
Fichier Insee des circonscriptions législatives
cf https://www.insee.fr/fr/statistiques/6436476
Note : il manque dans le fichier les collectivités d'outre-mer (COM) et Mayotte (les autres départements et régions d'outre-mer (DROM) sont présents).
wget "https://www.insee.fr/fr/statistiques/fichier/6436476/circo_composition.xlsx" -O data/circo_composition.xlsx
npx tsx src/scripts/import_insee_circonscriptions_legislatives.ts
Fichier des circonscriptions législatives provenant du Ministère de l'intérieur.
cf https://www.data.gouv.fr/fr/datasets/circonscriptions-legislatives-table-de-correspondance-des-communes-et-des-cantons-pour-les-elections-legislatives-de-2012-et-sa-mise-a-jour-pour-les-elections-legislatives-2017/
Le fichier intéressant est Table_de_correspondance_circo_legislatives2017-1.xlsx
.
Note : Les codes des communes de ce fichier sont plus complexes à utiliser que le fichier de l'Insee ci-dessus. Il n'est donc utilisé que pour les collectivités d'outre-mer + Mayotte et complète celui de l'Insee.
wget "https://www.data.gouv.fr/fr/datasets/r/4d0b70e1-7757-43cc-882b-5c3b04fe38b4" -O data/circonscriptions_legislatives.xlsx
npx tsx src/scripts/import_ministere_interieur_circonscriptions_legislatives_collectivites_outre-mer.ts
Fichiers des députés
cd data/
git clone https://git.en-root.org/tricoteuses/data/assemblee-nettoye/AMO30_tous_acteurs_tous_mandats_tous_organes_historique_nettoye.git
cd ../
npx tsx src/scripts/import_deputes.ts
Critères de répartition des dotations aux collectivités de la Direction générale des collectivités locales
Ces fichiers des critères de répartition des dotations aux collectivités contient un découpage territorial, mis à jour fin Mars, début Avril, plus à jour que le code officiel géographique de l'Insee.
cf :
- http://www.dotations-dgcl.interieur.gouv.fr/consultation/criteres_repartition.php
- https://www.dotations-dgcl.interieur.gouv.fr/consultation/dotations_en_ligne.php
# Critères de répartition des dotations communales :
# wget "http://www.dotations-dgcl.interieur.gouv.fr/consultation/criteres_repartition_csv.php?annee=2022&ct=com" -O data/criteres_repartition_communes.xls
# wget "http://www.dotations-dgcl.interieur.gouv.fr/consultation/criteres_repartition_csv.php?annee=2023&ct=com" -O data/criteres_repartition_communes.xls
wget "http://www.dotations-dgcl.interieur.gouv.fr/consultation/criteres_repartition_csv.php?annee=2024&ct=com" -O data/criteres_repartition_communes.xls
npx tsx src/scripts/import_dgcl_criteres_repartition_communes.ts
# Critères de répartition des dotations communales :
# wget "http://www.dotations-dgcl.interieur.gouv.fr/consultation/criteres_repartition_csv.php?annee=2022&ct=dep" -O data/criteres_repartition_departements.xls
wget "http://www.dotations-dgcl.interieur.gouv.fr/consultation/criteres_repartition_csv.php?annee=2023&ct=dep" -O data/criteres_repartition_departements.xls
wget "http://www.dotations-dgcl.interieur.gouv.fr/consultation/criteres_repartition_csv.php?annee=2024&ct=dep" -O data/criteres_repartition_departements.xls
npx tsx src/scripts/import_dgcl_criteres_repartition_departements.ts
Autocomplétions
Autocomplétions des communes
npx tsx src/scripts/generate_communes_autocompletions.ts
Commune with INSEE code 18131 present in file La Poste hexasmal but missing from INSEE.
Commune with INSEE code 27058 present in file La Poste hexasmal but missing from INSEE.
Commune with INSEE code 27058 present in file La Poste hexasmal but missing from INSEE.
Commune with INSEE code 27058 present in file La Poste hexasmal but missing from INSEE.
Commune with INSEE code 95282 present in file La Poste hexasmal but missing from INSEE.
Autocomplétions des départements
npx tsx src/scripts/generate_departements_autocompletions.ts
Autocomplétions des intercommunalités (EPCI)
npx tsx src/scripts/generate_epci_autocompletions.ts
Autocomplétions des circonscriptions législatives
npx tsx src/scripts/generate_circonscriptions_legislatives_autocompletions.ts
Autocomplétions des communes DGCL
npx tsx src/scripts/generate_communes_dgcl_autocompletions.ts
Autocomplétions des départements DGCL
npx tsx src/scripts/generate_departements_dgcl_autocompletions.ts
Autocomplétions des intercommunalités (EPCI) DGCL
npx tsx src/scripts/generate_epci_dgcl_autocompletions.ts
Lancement du serveur
En développement
npm run dev
En production
npm run build
Utilisation
Recherche d'une commune par autocomplétion
wget --header "Accept: application/json" "http://localhost:2999/communes/autocomplete?q=saint%20python"
wget --header "Accept: application/json" "http://localhost:2999/communes/autocomplete?q=st%20python"
wget --header "Accept: application/json" "http://localhost:2999/communes/autocomplete?q=75007%20Paris"
wget --header "Accept: application/json" "http://localhost:2999/communes/autocomplete?q=Paris%207"
wget --header "Accept: application/json" "http://localhost:2999/communes/autocomplete?field=commune&q=Paris%207"
Plus d'exemples se trouvent dans les tests.