Skip to main content

data-france

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.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for data-france 1.0.2
File Size Uploaded
data_france-1.0.2.tar.gz 18.0 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for data-france 1.0.2
File Interpreter ABI Platform
data_france-1.0.2-py3-none-any.whl Python 3 none any Details

Total release size: 36.0 MB

Release files / data_france-1.0.2.tar.gz

Download URL data_france-1.0.2.tar.gz
Size 18.0 MB
Tags Source
SHA-256 checksum
How to use checksums
249c3672e2ac0897211e5f3949848f7cdaac7a24fdbb3fc2fde53820765805c7
BLAKE2b-256 checksum
How to use checksums
cecac5900a398c25d898a59ebad34546a36f4cf1d43262756f314ca6b34ba4b2
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-1013-oem

Release files / data_france-1.0.2-py3-none-any.whl

Download URL data_france-1.0.2-py3-none-any.whl
Size 18.0 MB
Tags Python 3
SHA-256 checksum
How to use checksums
5f0c0a321331240d7f6c6f4837740e7a34e887d08cb9f1b2450767faca6d5347
BLAKE2b-256 checksum
How to use checksums
3c064c35978ced09deaed0276ccc267d0bbeb2c51f2b63dbf17c68d5472cd4de
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-1013-oem

Release history Release notifications | RSS feed

This release

1.0.2 This release

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.14.5

2 release files

0.14.4

2 release files

0.14.3

2 release files

0.14.2

2 release files

0.14.1

2 release files

0.14.0

2 release files

0.13.6

2 release files

0.13.5

2 release files

0.13.4

2 release files

0.13.3

2 release files

0.13.2

2 release files

0.13.1

2 release files

0.13.0

2 release files

0.12.2

2 release files

0.11.5

2 release files

0.11.4

2 release files

0.11.3

2 release files

0.11.2

1 release file

0.11.1

1 release file

0.11.0

1 release file

0.10.9

1 release file

0.10.8

1 release file

0.10.7

1 release file

0.10.6

1 release file

0.10.5

1 release file

0.10.4

1 release file

0.10.3

1 release file

0.10.2

1 release file

0.10.1

1 release file

0.10.0

1 release file

0.9.2

1 release file

0.9.1

1 release file

0.9.0

1 release file

0.8.3

1 release file

0.8.2

1 release file

0.8.1

1 release file

0.8.0

1 release file

0.7.0

1 release file

0.6.4

1 release file

0.6.3

1 release file

0.6.2

1 release file

0.6.1

1 release file

0.5

1 release file

0.4

1 release file

0.3

1 release file

0.2

1 release file

0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page