Metadata-Version: 2.1
Name: data-france
Version: 0.11.3
Summary: Paquet agrégeant des données administratives publiques pour en rendre l'utilisation facile.
Home-page: https://github.com/aktiur/data-france
License: GNU-GPL 3.0
Author: Arthur Cheysson
Author-email: arthur@cheysson.fr
Requires-Python: >=3.7
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Dist: django (>=3.1.0,<3.2.0)
Requires-Dist: psycopg2 (>=2.8.0,<2.9.0)
Description-Content-Type: text/x-rst

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

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

* `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

Toutes ces entités (sauf les codes postaux, 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.

Vues
----

Une vue de recherche renvoyant les résultats en JSON est disponible, par défaut
à l'URL `chercher/communes/` (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.


Autres remarques
----------------

**ATTENTION** : Ce paquet ne fonctionne que si votre projet Django utilise
 **PostGIS** car il utilise certaines fonctionnalités propres à PostgreSQL.

