GiePlaces/README.md

GiePlaces

Application web statique de cartographie administrative orientée gendarmerie.

Hiérarchie des vues

• France : découpage en 13 régions de gendarmerie.
• Région de gendarmerie : découpage en groupements (départements).
• Groupement : découpage en communes.
• Outre-mer : territoires dédiés (considérés comme vues de type groupement pour l'affichage des communes et unités).

Fonctionnalités principales

• rendu cartographique sur canvas (survol, sélection, zoom, déplacement),
• recherche unifiée par nom/code/territoire sur régions, groupements, communes et unités,
• colorisation des communes par unité territorialement compétente,
• communes en zone police nationale conservées en gris,
• marqueurs d'unités (gendarmerie et police nationale), clic ouvrant une modale détaillée,
• surbrillance cohérente des entités multi-parties,
• routage par hash avec navigation arrière/avant navigateur,

Particularité Polynésie française

• pour des raisons de lisibilité/performance, seules les communes de Tahiti et Moorea sont affichées sur la carte,
• les autres communes restent disponibles dans la recherche et les filtres,
• un disclaimer indique les zones masquées et donne accès à leur détail.

Prérequis

• python3 (aucune dépendance Python externe nécessaire),
• accès Internet pour régénérer les données.

Génération des données

python3 scripts/build_communes_data.py

Fichiers produits :

• data/territories.json : métadonnées des territoires (navigation, labels, type d'entité),
• data/territories/*.json : géométries et données associées par territoire,
• data/communes-index.json : index de recherche (communes, régions, groupements, unités, zones masquées).

Lancement local

python3 -m http.server 8008

Puis ouvrir http://127.0.0.1:8008.

Routage (URL)

• #/territoire/france
• #/territoire/<territoireKey>
• #/territoire/<territoireKey>/entite/<code>
• #/territoire/<territoireKey>/unite/<serviceKey>

Structure du projet

• index.html : structure des panneaux, modales et zones de rendu,
• styles.css : thème visuel,
• script.js : rendu carte, interactions, recherche, modales, routage,
• scripts/build_communes_data.py : pipeline de collecte/enrichissement/génération.

Sources de données

• API Geo : https://geo.api.gouv.fr/
• Géométries administratives simplifiées : https://github.com/gregoiredavid/france-geojson
• Compétences territoriales : https://www.data.gouv.fr/api/1/datasets/r/c53cd4d4-4623-4772-9b8c-bc72a9cdf4c2
• Unités gendarmerie : https://www.data.gouv.fr/api/1/datasets/r/17320fe6-a896-4686-93e6-502be2ad23f2
• Annuaire Service-Public : https://api-lannuaire.service-public.gouv.fr/

Auteur

• Benjamin GOUTFER (MDC)