wiki:Territoria

Version 14 (modified by http://emmanuel.raviart.myopenid.com/, 9 years ago) (diff)

Correction de syntaxe wiki

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 :

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 y figurent :

[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

Plus d'informations

Pour plus d'informations, vous pouvez consulter et/ou participer à la liste de diffusion Infos-Pratiques.