Version 12 (modified by http://emmanuel.raviart.myopenid.com/, 12 years ago) (diff) |
---|
Territoria
Territoria est à la fois :
- une base de données hiérarchique des territoires, construite à partir de différentes sources publiques.
- un ensemble d'outils permettant de mettre à jour, exporter et manipuler cette base de données
Actuellement la base Territoria contient les collectivités territoriales suivantes :
- régions
- départements
- arrondissements départementaux
- cantons
- pays (de France)
- intercommunalités (ie EPCI)
- communes
- arrondissements communaux
- communes rattachées
ainsi que diverses informations sur les communes :
- code postal
- population
- aire urbaine
- périmètre de transports urbains
- littoral
- massif montagneux
Objectifs
Territoria est surtout conçue comme un composant destiné à être intégré dans d'autres applications (Cosmetic, Metanol, etc).
La structure de la base Territoria est suffisamment générique pour pouvoir être étendue à d'autres pays que la France ou à d'autres informations sur les territoires.
Territoria est en développement depuis le 25 décembre 2008.
Licence et copyright
L'application Territoria est un logiciel libre sous licence GNU Affero General Public License version 3 ou supérieure.
La base de données Territoria est sous licence GNU Free Documentation License version 1.3 ou supérieure.
Copyright © 2008, 2009 Easter-eggs & Emmanuel Raviart
Technique
Territoria utilise les outils suivants :
- langage de programmation Python
- mapper objet-relationnel SQLAlchemy
Territoria a été testée sur les base de données : PostgreSQL et SQLite.
Téléchargement
Téléchargement de l'application
Il n'existe pas encore de version stable de Territora, mais vous pouvez récupérer les sources de la version en cours de développement :
- soit en utilisant git d'une des deux manières suivantes :
- git clone git://git.infos-pratiques.org/git/territoria.git
- git clone http://git.infos-pratiques.org/territoria.git
- soit en naviguant dans l'interface web du dépôt git
- soit en récupérant une archive ("snapshot") de la version actuelle depuis cette même interface web.
Téléchargement de la base de données
Vous pouvez récupérer un dump SQL de la base de données généré à partir de SQLite :
- soit en utilisant git d'une des deux manières suivantes :
- git clone git://git.infos-pratiques.org/git/territoria-database-sqlite.git
- git clone http://git.infos-pratiques.org/territoria-database-sqlite.git
- soit en naviguant dans l'interface web du dépôt git
- soit en récupérant une archive ("snapshot") de la version actuelle depuis cette même interface web.
Téléchargement des données permettant la constitution initiale de la base de données
Ces données se présentent sous formes de fichiers textes (CSV) provenant de différentes sources (cf ci-dessous).
Ces fichiers peuvent-être utilisés pour le remplissage initial de la base de données, lorsqu'on souhaite la reconstruire à partir de zéro.
Vous pouvez les récupérer :
- soit en utilisant git d'une des deux manières suivantes :
- git clone git://git.infos-pratiques.org/git/territoria-source-data.git
- git clone http://git.infos-pratiques.org/territoria-source-data.git
- soit en naviguant dans l'interface web du dépôt git
- soit en récupérant une archive ("snapshot") de la version actuelle depuis cette même interface web.
Installation et configuration
Installation et configuration de l'application
git clone git://git.infos-pratiques.org/git/territoria.git cd territoria sudo python setup.py install cd ..
Modifier le fichier de configuration development.ini en fonction de votre choix de base de données. Pour utiliser SQLite, s'assurer que les lignes suivantes :
[Territoria] sqlalchemy.url = sqlite:///chemin/de/la/future/base/territoria.db
Note : Dans la dernière ligne ci-dessus, "sqlite:" doit être suivi de 3 "/" si le chemin vers le fichier est relatif ou de 4 "/" s'il est absolu.
Création et initialisation de la base de données
La base de données des territoires peut être créée :
- soit à partir d'un dump existant (c'est la méthode recommandée),
- soit en important l'ensemble des fichiers sources ayant servi à la constituer.
Ces 2 méthodes sont détaillées ci-dessous.
Création de la base à partir d'un dump existant
Téléchargement du dump SQL de la base de données territoria-database-sqlite dans le répertoire ${TERRITORIA_DUMP} :
git clone git://git.infos-pratiques.org/git/territoria-database-sqlite cd territoria-database-sqlite export TERRITORIA_DUMP=`pwd` cd ..
Création de la base de données SQLite à partir du dump SQL.
cd territoria sqlite3 -init ${TERRITORIA_DUMP}/territoria.sql development.db .quit
Création de la base en important l'ensemble des fichiers sources ayant servi à la constituer
Téléchargement des données territoria-source-data dans le répertoire ${TERRITORIA_SOURCE_DATA} :
git clone git://git.infos-pratiques.org/git/territoria-source-data cd territoria-source-data export TERRITORIA_SOURCE_DATA=`pwd` cd ..
Création de la base de données :
cd territoria territoria/scripts/create_database.py development.ini
Initialisation des territoires de base :
territoria/scripts/init_database.py development.ini
Importation des données territoriales provenant de l'INSEE (communes, cantons, arrondissements, départements et régions) :
territoria/scripts/import_insee_code_officiel_geographique.py development.ini ${TERRITORIA_SOURCE_DATA}/insee/code-officiel-geographique/
Importation des données de l'INSEE sur la population des communes :
territoria/scripts/import_insee_population.py development.ini ${TERRITORIA_SOURCE_DATA}/insee/population-et-logements-par-commune/
Importation des données territoriales provenant de l'Observatoire des territoires (aires urbaines, intercommunalités, communes littorales, communes de massifs montagneux, pays, parcs naturels régionaux et périmètres de transports urbains) :
territoria/scripts/import_observatoire_des_territoires_aires_urbaines.py development.ini ${TERRITORIA_SOURCE_DATA}/observatoire-des-territoires/data_aire_urbaine.csv territoria/scripts/import_observatoire_des_territoires_epci.py development.ini ${TERRITORIA_SOURCE_DATA}/observatoire-des-territoires/data_epci.csv territoria/scripts/import_observatoire_des_territoires_littoraux.py development.ini ${TERRITORIA_SOURCE_DATA}/observatoire-des-territoires/data_loi_littoral.csv territoria/scripts/import_observatoire_des_territoires_massifs.py development.ini ${TERRITORIA_SOURCE_DATA}/observatoire-des-territoires/data_perimetre_massif.csv territoria/scripts/import_observatoire_des_territoires_pays.py development.ini ${TERRITORIA_SOURCE_DATA}/observatoire-des-territoires/data_pays.csv territoria/scripts/import_observatoire_des_territoires_parcs_naturels_regionaux.py development.ini ${TERRITORIA_SOURCE_DATA}/observatoire-des-territoires/data_pnr.csv territoria/scripts/import_observatoire_des_territoires_perimetres_transports_urbains.py development.ini ${TERRITORIA_SOURCE_DATA}/observatoire-des-territoires/data_ptu.csv
Importation du fichier des codes postaux provenant de Jérôme Galichon :
territoria/scripts/import_galichon_codes_postaux.py development.ini ${TERRITORIA_SOURCE_DATA}/galichon/codes-postaux/insee.csv
Sources de données sur les territoires
- Code officiel géographique de l'INSEE
- Zonages de l'Observatoire des territoires
- Codes postaux de Jérôme Galichon
Plus d'informations
Pour plus d'informations, vous pouvez consulter et/ou participer à la liste de diffusion Infos-Pratiques.