Un ensemble de données administratives et géographiques pour la France. Elle double comme application Django pour permettre l’intégration aisée de ces données.
Installer le paquet
Installez ce paquet avec pip:
pip install data-france
Importer les données
Pour importer les données, appliquez les migrations et utilisez la commande de management:
./manage.py update_data_france
Modèles
Circonscriptions administratives et collectivités locales
L’application django comporte les modèles suivants :
Commune
Inclut les communes délégués / communes associées / arrondissements PLM / secteurs électoraux PLM
Les différents types d’entités sont différenciés par le champ type
EPCI
Il s’agit des EPCI à fiscalité propre : CA, CC, CU et métropoles
N’inclut pas encore les EPT du Grand Paris
Canton
N’inclut pas encore les géométries
Departement et Region pour les départements et régions comme circonscriptions administratives de l’État
CollectiviteDepartementale et CollectiviteRegionale pour les départements et régions comme collectivités territoriales :
La métropole de Lyon (aux compétences départementales) est référencée comme une collectivité départementale ;
les collectivités territoriales uniques (par exemple l’Assemblée de Corse) sont référencées comme des collectivités régionales (cela inclut, de façon contre-intuitive, le département de Mayotte) ;
À noter que comme le conseil de Paris est déjà référencé comme une Commune, il n’est pas référencé de nouveau comme collectivité départementale.
Les codes postaux
Circonscriptions législatives
Cisconscriptions consulaires
Toutes ces entités (sauf les codes postaux, les cantons, les circonscriptions consulaires, et les collectivités régionales, dont la géométrie est systématiquement celle de la région correspondante) viennent avec une géometrie et les articles + charnière.
Élu·es
Les fichiers suivants du répertoire national des élus sont importés et disponibles sous forme de modèle Django :
Les élus municipaux
Les députés
Vues JSON
Recherche de communes
Une vue de recherche renvoyant les résultats en JSON est disponible, à l’URL chercher/communes/ si vous importez data_france.urls (en utilisant le paramètre GET q). Il est possible d’obtenir les résultats au format geojson en ajoutant le paramètre GET geojson à une valeur non vide.
Recherche de circonscriptions consulaires
Une vue de recherche des circonscriptions consulaires, à l’adresse circonscriptions-consulaires/chercher/, en utilisant le paramètre q.
Des vues d’affichage par code
Des vues existent pour afficher une des entités suivantes en la référençant par son code INSEE usuel :
Les communes, communes/par-code/
Les epci, epci/par-code/
Il faut utiliser les codes SIREN
Les départements, departements/par-code/
Les régions, regions/par-code/
Les codes postaux, code-postal/par-code/
Les collectivités de niveau départemental, collectivite-departementale/par-code/
Le code du département considéré comme une collectivité départementale plutôt que comme une circonscription administrative de l’État est généralement <code dep>D.
Les collectivités de niveau régional, collectivite-regionale/par-code/
Généralement
Autres remarques
ATTENTION : Ce paquet ne fonctionne que si votre projet Django utilise PostGIS car il utilise certaines fonctionnalités propres à PostgreSQL.
Dev
Data france peut être lancé localement avec Lando https://www.lando.dev via lando start, cette commande va lancer 2 conteneurs un conteneur pour le projet et un deuxieme pour la base de données postgresql.
Il faut ensuite lancer des migrations : lando manage migrate Pour lancer les téléchargement des fichiers en open data : lando poetry run doit build ` Pour importer les données dans postgresql `lando manage update_data_france
Pour créer un superutilisateur : lando manage createsuperuser
Build le paquet
Installer le projet poetry install Télécharger les sources et build le projet : poetry run doit build Monter de version avant de publier : poetry version patch/minor/major - https://python-poetry.org/docs/cli#version Build le package : poetry build Publier le package sur Python Package Index : poetry publish
Release files for data-france 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| data_france-1.0.1.tar.gz | 18.0 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| data_france-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 36.1 MB
Release files / data_france-1.0.1.tar.gz
| Download URL | data_france-1.0.1.tar.gz |
|---|---|
| Size | 18.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0cbf43415b61467fa23da9b712ed6a8743ab4a6e5c92f9768b663a5125cae0e4
|
|
BLAKE2b-256 checksum How to use checksums |
b2780ff4fd46e01358dfc83aa00f87f344f65f6f3346ce0b239ba3828b8d0632
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.14.4 Linux/7.0.0-1011-oem
|
Release files / data_france-1.0.1-py3-none-any.whl
| Download URL | data_france-1.0.1-py3-none-any.whl |
|---|---|
| Size | 18.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c9d42027240b79a371c8dc9514c116008e902f44a1438d4b0ed6725f5593bbdc
|
|
BLAKE2b-256 checksum How to use checksums |
ba8ce4ce8365ec85192c6a6526936eb901b74f068fb5ff4172e37cc499c51dd4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.14.4 Linux/7.0.0-1011-oem
|
