# 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

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

```bash
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)