# Données : du SSP Cloud au jeu embarqué

::::summary{title="En bref" audience="Data scientists, développeurs, toute personne qui veut vérifier un chiffre." reading="5 min" updated="11 novembre 2026"}

Le chemin des données, du SSP Cloud au téléphone : sources, transformations, contenu du jeu embarqué et reconstruction.

:::details[Données utilisées]
Fichiers du SSP Cloud, bases croisées du portail, API publiques (calendrier scolaire, jours fériés, IGN, OpenStreetMap, Open-Meteo, Wikidata), export ouvert DATAtourisme.
:::

::::

<ARetenir illustration="/matching/illustrations/sortie-point-de-vue.svg" titre="Ce qu'il faut retenir">
- **2 872 entrées** du catalogue, réunies en **2 563 lieux** : un lac et ses plages ne font qu'un lieu.
- **260 profils d'affluence** : 254 tirés des écocompteurs de l'Isère (265 234 jours de comptage) et 6 profils moyens.
- **2 245 expériences** (restaurants, activités sur l'eau, points de vue…) et **129 alternatives** conseillées par les offices.
- Tout est calculé **une fois, sur un ordinateur**, puis embarqué : le téléphone ne demande en direct que la météo et les photos.
</ARetenir>

## Le flux, en quatre étapes

<Etapes etapes={[
  { titre: "Sources", texte: "748 fichiers du SSP Cloud, bases du portail, API publiques, DATAtourisme", icone: "database" },
  { titre: "Script", texte: "build.py relie, nettoie, agrège et vérifie, sans rien écrire dans data/", icone: "cog" },
  { titre: "Jeu embarqué", texte: "cinq fichiers JSON versionnés dans packages/data/generated/", icone: "package" },
  { titre: "Téléphone", texte: "index léger tout de suite, le reste à la demande, hors ligne ensuite", illustration: "/plutotla/v1-accueil.png" },
]} />

:::howto{caption="Source : packages/data/scripts/build.py, packages/data/src/ · jeu version 5086974512cc"}
Le script tourne sur l'ordinateur d'un développeur, pas sur le téléphone ni sur Vercel. L'application lit d'abord l'index léger, puis charge le jeu, les services et la climatologie quand elle en a besoin.
:::

<details>
<summary>Le schéma complet du flux (sources, transformations, fichiers)</summary>

```mermaid
flowchart LR
  accTitle: Flux des données, du SSP Cloud au jeu embarqué
  accDescr: Les fichiers bruts du SSP Cloud et les bases croisées du portail, plus des API publiques, entrent dans le script build.py. Il produit les sites regroupés en lieux, les profils, les expériences, les alternatives conseillées, le calendrier et les sources, réunis dans jeu.json. L'export ouvert de DATAtourisme, réduit à 1 133 lieux, et les photos de Wikidata et Wikimedia Commons donnent fiches.json, qui ajoute à chaque site son type de sortie, sa photo et ses horaires. Le paquet data valide le tout avec zod et l'application le charge.
  subgraph SSP["SSP Cloud : data/ (lecture seule)"]
    ECO["Écocompteurs : comptages 2021-2026"]
    DT["DataTourisme.xlsx"]
    SF["Sites sur-fréquentés.xlsx"]
    AP["Apidae : 3 fichiers xlsx"]
    BD["BD TOPO (gpkg)"]
    ENS["ENS_equipements.gpkg"]
    PD["PDESI (geojson)"]
    CO["Fond communes (gpkg)"]
  end
  subgraph POR["Portail : docs/public/"]
    CAT["tables/sites-isere.json"]
    CPT["dataviz/base/compteurs*.json"]
    P1["dataviz/p1 : couples, pôles"]
    P2["dataviz/p2/calendrier.json"]
  end
  subgraph API["API publiques, en cache"]
    EDU["Calendrier scolaire"]
    FER["Jours fériés"]
    IGN["Altimétrie IGN"]
    OSM["OpenStreetMap (Overpass, 30 tuiles)"]
    WIK["Wikidata P18 et Wikimedia Commons"]
  end
  DTN["DATAtourisme : export national ouvert (hors du dépôt)"]
  MET["Météo : données 1986-2024 (SSP Cloud)"]
  CAT --> SITES["sites, lieux, noms, compteurs"]
  CPT --> SITES
  P1 --> SITES
  BD --> SITES
  ENS --> SITES
  CO --> SITES
  ECO --> PROF["profils d'affluence"]
  SITES --> PROF
  DT --> EXP["expériences"]
  BD --> EXP
  PD --> EXP
  AP --> EXP
  CO --> EXP
  IGN --> EXP
  SF --> ALT["alternatives conseillées"]
  P1 --> ALT
  P2 --> CAL["calendrier"]
  EDU --> CAL
  FER --> CAL
  CAL --> PROF
  SITES --> J[("jeu.json")]
  PROF --> J
  EXP --> J
  ALT --> J
  CAL --> J
  J --> IDX[("index.json : index léger")]
  OSM --> SRV[("services.json")]
  BD --> SRV
  AP --> SRV
  MET --> CLI[("climat.json : 48 stations")]
  DTN --> DTC["cache/datatourisme.json : 1 133 lieux"]
  DTC --> FIC[("fiches.json : type de sortie, photo, horaires")]
  WIK --> FIC
  SITES --> FIC
  FIC --> Z2
  IDX --> Z["@flux/data/leger : chargerIndex() tout de suite"]
  J --> Z2["prechargerJeu(), chargerJeuComplet() à la demande"]
  SRV --> Z2
  CLI --> Z2
  Z --> APPL["@flux/app"]
  Z2 --> APPL
```

:::howto{caption="Source : packages/data/scripts/build.py"}
À gauche les entrées, au centre les transformations, à droite les cinq fichiers produits. Le calendrier sert deux fois : il est copié dans le jeu, et il sert à calculer le coefficient « vacances » des profils.
:::

</details>

## Ce que contient le jeu

| Fichier | Taille | Contenu | Chargé |
| --- | ---: | --- | --- |
| `jeu.json` | 1,75 Mo (281 Ko compressé) | sites et lieux, profils, expériences, alternatives conseillées, calendrier | en arrière-plan, au démarrage |
| `details.json` | 68 Ko (10 Ko compressé) | sources de chaque site, provenance et précision de chaque expérience (libellés écrits une fois) | avec le jeu |
| `index.json` | 237 Ko (69 Ko compressé) | 11 champs par site, pour la recherche | tout de suite |
| `fiches.json` | 198 Ko (27 Ko compressé) | type de sortie, photo libre, horaires | avec le jeu |
| `services.json` | 156 Ko | toilettes, bancs, ombre, eau, jeux, accès en fauteuil, chiens à 300 m | à la demande |
| `climat.json` | 16 Ko | normales mensuelles de 48 stations Météo-France | à la demande |

:::howto{caption="Source : packages/data/generated/ · version 5086974512cc"}
Une ligne par fichier produit par le script, tous dans `packages/data/generated/` et versionnés. La météo du jour n'est dans aucun fichier : l'application la demande à Open-Meteo.
:::

| Partie du jeu | Nombre | D'où |
| --- | ---: | --- |
| Sites | 2 872 entrées, 2 563 lieux | catalogue du portail, enrichi des compteurs proches, des lieux et des zonages |
| Profils d'affluence | 260 | 254 profils de compteurs et 6 profils moyens |
| Expériences | 2 245 | DataTourisme, BD TOPO, PDESI, Apidae |
| Alternatives conseillées | 129 couples | Isère Attractivité (71), couples déclarés du portail P1 (58) |
| Vacances scolaires | 19 périodes | zone A, fin 2024 à fin 2027 |
| Jours fériés | 33 jours | 2025 à 2027 |
| Sources citées | 31 | chaque fichier utilisé et son usage |

:::howto{caption="Source : packages/data/generated/jeu.json, version 5086974512cc"}
Un nombre par partie du contrat `JeuDeDonnees`. Expériences : restaurant 1 274, randonnée 251, point de vue 224, musée 144, coucher de soleil 134, famille 118, baignade 86, sur l'eau 14.
:::

## D'où vient chaque partie

| Partie | Sources principales | Ce que fait le script |
| --- | --- | --- |
| Sites et compteurs | catalogue du portail, 420 compteurs de passages | rattache à chaque site jusqu'à 3 compteurs à moins de 2 km, avec une confiance |
| Lieux | catalogue, BD TOPO, ENS, pôles du portail P1 | réunit les entrées d'un même endroit (règles R0 à R4) |
| Noms lisibles | catalogue | corrige 402 noms (« PPO_Voreppe » devient « Parcours d'orientation de Voreppe ») |
| Profils d'affluence | écocompteurs de l'Isère, 2021-2026 | un profil par mois, jour de la semaine, heure et vacances, en base 100 |
| Expériences | DataTourisme, BD TOPO, PDESI, Apidae, altimétrie IGN | 8 types ; coucher du soleil vérifié sur le relief |
| Espaces fragiles | ENS, BD TOPO (réserves, Natura 2000) | 481 sites marqués fragiles |
| Alternatives conseillées | `Sites sur-fréquentés.xlsx`, portail P1 | couples déclarés seulement, jamais déduits |
| Calendrier | portail P2, calendrier scolaire, jours fériés | vacances de la zone A et fériés |
| Services | OpenStreetMap, BD TOPO, labels et fiches Apidae | relevé à 300 m de chaque site placé au point |
| Climatologie | `Météo/données météo 1986-2024.csv` | 48 stations, une ligne par mois |
| Fiches des lieux | Wikidata et Wikimedia Commons, DATAtourisme | type de sortie, photo libre avec crédit, horaires |

:::howto{caption="Source : packages/data/scripts/build.py et fiches.py"}
Une ligne par partie, dans l'ordre du script. Le détail de chaque ligne est replié ci-dessous.
:::

<details>
<summary>Sites et compteurs</summary>

**Entrées** : `docs/public/tables/sites-isere.json` (catalogue du portail), `docs/public/dataviz/base/compteurs.json` (420 compteurs de passages, Eco-Compteur Isère et ENS), `docs/public/dataviz/base/compteurs-sites.json` (liens compteur ↔ site vérifiés par le portail). Voir les [bases croisées](/dataviz/donnees-croisees).

**Transformation** (`construire_sites`) :

1. Chaque ligne du catalogue devient un `Site`. Son `id` est le nom d'origine en minuscules sans accents, suivi du <Terme mot="code INSEE" ancre="code-insee" /> : `le-lac-de-paladru-38082`. Les `id` ne changent pas : les signalements déjà saisis restent valables.
2. Les textes sont réparés (DataTourisme a des accents abîmés : « Bà¢timent » devient « Bâtiment »).
3. Pour chaque site, on cherche les <Terme mot="écocompteurs" ancre="ecocompteur" /> à moins de 2 km et on leur donne une **confiance** : `meme-site` (vérifié par le portail, ou mot distinctif commun, « Bois d'Amour ») ; `meme-sentier` (vérifié par le portail) ; `proximite` (à moins de 1 km, sans lien de nom, indicatif). Au-delà de 1 km, un compteur sans lien de nom est ignoré. 3 compteurs par site au plus.
4. On recopie les accès (`arretsTc` : arrêts à moins de 500 m, <Terme mot="GTFS" /> ; `parkings` : parkings à moins de 500 m, <Terme mot="BD TOPO" />), le score de données (0 à 10), les listes d'origine et la fiche du portail.

**Résultat** : 911 sites ont au moins un compteur à proximité ; 1 683 liens (224 `meme-site`, 15 `meme-sentier`, 1 444 `proximite`). 134 sites ont un profil « mesuré ». Le catalogue du portail place 331 sites au centre de leur commune (327 en Isère) ; le jeu en replace 48 au point (Wikidata ou vérification à la main) : 283 gardent une position approchée.

Limite : le rapprochement par nom laisse quelques liens `meme-site` discutables (« Sautet bas », à 1,9 km de la plage du lac du Sautet).

</details>

<details>
<summary>Lieux : un endroit, plusieurs entrées</summary>

Le catalogue décrit souvent **le même endroit plusieurs fois** : pour le lac de Paladru, « Charavines Plage », à 100 m, était proposée comme alternative ; le Lauvitel existait en 7 entrées. Chaque site reçoit donc un champ `lieuId` : l'identifiant de l'entrée qui représente son lieu. **Résultat** : 2 567 lieux pour 2 872 entrées ; 184 lieux réunissent 489 entrées.

| Règle | Deux entrées sont le même lieu si… |
| --- | --- |
| R0 | le portail les range dans le même groupe de sites sur-fréquentés (« pôle » de la page [P1](/dataviz/p1-reorienter-les-flux), vérifié à la main) |
| R1 | même nom une fois retirés les articles et les mots comme « lac du », « plage de », « fort de », à moins de 3 km. Un nom qui n'est qu'un nom de commune ne réunit que deux entrées du même type à moins de 300 m |
| R2 | elles touchent le même lac ou la même retenue de la BD TOPO (couche `plan_d_eau`) : plage, base de loisirs, base nautique ou lac à moins de 300 m |
| R3 | même sentier ou même ENS, à moins de 1,5 km, et un nom propre commun |
| R4 | elles partent du **même point**, et l'une est un itinéraire qui porte le nom de l'autre (33 regroupements) |
| Jamais | un site et l'alternative que l'office conseille à sa place ; deux lacs différents |

:::howto{caption="Source : build.py (construire_lieux)"}
De la règle la plus sûre (R0) à la plus large. R4 évite de réunir les 23 monuments de Vienne placés au même point par la base Mérimée.
:::

- **Alias de plans d'eau** : le « Lac Bleu » est le lac de Paladru, mais seulement dans les 4 communes au bord du lac (`ALIAS_PLANS_D_EAU`).
- **L'entrée qui représente le lieu** est choisie d'abord par sa nature (un lac ou un monument, puis un autre endroit, un sentier en dernier), puis par le score de données, la sur-fréquentation, une position exacte. Pour Paladru : `le-lac-de-paladru-38082`. L'application affiche toujours le nom de l'entrée choisie par le visiteur.
- **Cas vérifiés à la main** (et écrits dans les tests) : le [lac de Paladru](/sites/lac-de-paladru) (plages, base nautique, marais de la Véronnière, base d'aviron du Lac Bleu ; le musée reste à part) ; Voreppe (circuit historique et parcours d'orientation) ; le Lauvitel (7 entrées) ; Laffrey (la plage de la Bergogne reste à part, conseillée comme alternative) ; la [Bastille](/sites/bastille-grenoble) (escalade et téléphérique à part) ; Les 2 Alpes.
- `jeu.json` n'écrit `lieuId` que s'il diffère de l'`id` ; le chargement le complète. `FLUX_LIEUX=<chemin.json>` écrit les lieux à plusieurs entrées, pour une vérification à la main.

Limites : quelques doublons échappent aux règles (le Muséum de Grenoble apparaît aussi comme « Muséum d'histoire naturelle »). Gardés exprès, et discutables : le pôle « Lacs du Taillefer » réunit deux lacs ; le pôle de Monteynard réunit la plage de Mayres-Savel et les passerelles de Treffort. « Les Écuries du Lac Bleu », à 1,5 km du lac, restent un lieu à part.

</details>

<details>
<summary>Noms lisibles</summary>

Une règle générale, vérifiée à chaque construction, change 402 noms : « PPO_Voreppe » devient « Parcours d'orientation de Voreppe » ; le préfixe « ENS » est retiré ; les noms en capitales reprennent une casse normale (les sigles courts comme VTT-FFC restent) ; les noms des monuments historiques sont remis dans l'ordre (« Résidence 2000 (cité) ») ; les guillemets droits deviennent « » ; un nom fait d'un seul mot générique reçoit sa commune (« Golf (Huez) »). Aucune entrée n'est retirée, et `id` vient toujours du nom d'origine.

</details>

<details>
<summary>Profils d'affluence</summary>

C'est la transformation la plus importante : elle permet de dire « dimanche d'août vers 15 h : environ 10 fois l'heure moyenne ».

**Entrées** : `Fréquentation/eco-compteur-Isère/comptages/` du SSP Cloud (voir [Écocompteurs de l'Isère](/donnees-ssp/frequentation/eco-compteur-isere)) : `historique_2021_2024.csv` et `comptages_journalier_2025_2026.csv` (comptages journaliers : mois, jour de la semaine, vacances), `comptages_horaire_2025_2026.csv` (comptages horaires, lus avec <Terme mot="DuckDB" /> : profil par heure).

```mermaid
flowchart TD
  accTitle: Construction d'un profil d'affluence à partir d'un compteur
  accDescr: Pour chaque compteur, on choisit le mode compté, on retire les jours à zéro, on écrête les jours extrêmes, puis on estime par itérations les facteurs mois, jour de la semaine et vacances. On interpole les mois peu mesurés et on ajoute le profil horaire. On garde le profil s'il est relié à un site. On fait aussi des profils génériques par catégorie.
  A["Comptages journaliers d'un compteur"] --> B{"Mode : piétons ? sinon vélos ? sinon tous"}
  B --> C["Retirer les jours à 0 : panne probable"]
  C --> D["Base 100 = jour moyen des années complètes"]
  D --> E["Écrêter au 99e centile"]
  E --> F["5 itérations : mois, jour de la semaine, vacances"]
  F --> G["Mois avec moins de 8 jours : interpolés"]
  G --> H["Heures : comptages horaires, base 100 = heure moyenne"]
  H --> I{"Relié à un site ?"}
  I -->|"oui"| K["profil compteur:ID"]
  I -->|"non"| X["écarté"]
  K --> M["Moyennes : générique Isère et une par catégorie"]
```

:::howto{caption="Source : build.py (construire_profils, profil_journalier, profil_horaire)"}
De haut en bas, pour un compteur. La dernière case réunit les compteurs piétons en profils génériques.
:::

- **Mode compté** : les piétons s'il y en a, sinon les vélos, sinon tous ; le libellé le dit (« Compteur « Bois d'Amour » (piétons, 2021-2026) »).
- **Nettoyage** : jours à 0 retirés ; au moins 90 jours et 6 mois différents ; jours au-delà de 20 fois la moyenne retirés, puis écrêtage au 99e <Terme mot="centile" />.
- **Modèle multiplicatif**, le même que celui de `@flux/core` : `jour = mois × jour de la semaine × vacances`. Le coefficient vacances ne s'applique qu'un jour de semaine de vacances scolaires (zone A) ou férié.
- **Coefficient vacances** : estimé seulement dans les mois qui mélangent au moins 3 jours de vacances et 3 jours de classe, tiré vers 1,38 (moyenne des écocompteurs piétons, page [P2](/dataviz/p2-anticiper-les-pics)) quand il y a peu de jours : `v = (n × v_mesuré + 20 × 1,38) / (n + 20)`.
- **Normalisation** : la journée moyenne d'une année type (2025) vaut 100. **Heures** : 100 = heure moyenne ; un compteur qui met tout à minuit reçoit le profil horaire générique.
- **Profils génériques** : `generique` (tous les compteurs piétons de l'Isère) et `generique:<catégorie>` (au moins 3 compteurs reliés à des sites de la catégorie, sinon copie du profil Isère).

**Résultat** : 254 profils de compteurs reliés à un site (265 234 jours de comptage) et 6 génériques. Les profils courts ou extrêmes sont corrigés au moment du calcul, dans `@flux/core` (voir [Estimation de l'affluence](/matching/estimation-de-l-affluence)).

Exemple réel, profil `generique:nature-et-paysages` (<Terme mot="base 100" ancre="indice-base-100" />) :

| | J | F | M | A | M | J | J | A | S | O | N | D |
| --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: |
| Mois | 60 | 77 | 82 | 100 | 120 | 118 | 107 | 110 | 103 | 91 | 73 | 56 |

| | Lun | Mar | Mer | Jeu | Ven | Sam | Dim |
| --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: |
| Jour | 78 | 82 | 81 | 86 | 80 | 134 | 158 |

:::howto{caption="Source : Fréquentation/eco-compteur-Isère/comptages/ · moyenne des compteurs piétons proches de sites « Nature et paysages » (déduit)"}
120 en mai veut dire 1,2 fois un mois moyen ; 158 le dimanche, 1,58 fois un jour moyen. Heures (0 h à 23 h) : 6, 10, 14, 4, 5, 5, 12, 32, 67, 128, 220, 236, 206, 203, 266, **283** (15 h), 235, 173, 122, 86, 42, 23, 13, 10 ; vacances : 145.
:::

Limites : les compteurs ne mesurent que des marcheurs ; le profil `generique:neige` culmine en été et le dit (« des marcheurs, pas des skieurs »). Les 3 compteurs des Espaces naturels sensibles n'ont pas de profil : leurs fichiers bruts ne sont pas lus.

</details>

<details>
<summary>Expériences</summary>

| Source (SSP Cloud) | Ce qu'on en tire | Type |
| --- | --- | --- |
| `Sites et équipements/Données France DataTourisme.xlsx`, « Données restaurants » | restaurants, cafés, glaciers | `restaurant` |
| idem, « Données sites de loisir » | plages et piscines ; parcs de loisirs, fermes pédagogiques, mini-golfs | `baignade`, `famille` |
| idem, « Données sites culturels » | musées, centres d'interprétation ; parcs et jardins | `musee`, `famille` |
| idem, « Données brutes » | itinéraires pédestres | `randonnee` |
| idem, plusieurs feuilles | location de matériel nautique, bateaux promenade, bases nautiques | `pedalo` (« Sur l'eau ») |
| `Fonds de carte/BDTOPO/…gpkg`, couche `zone_d_activite_ou_d_interet` | points de vue, baignades surveillées, bases nautiques, musées, parcs, sentiers | plusieurs types |
| `Rando/plan-départemental-des-espaces-sites-et-itinéraires.geojson` (<Terme mot="PDESI" />) | trail et raquettes, au départ du tracé | `randonnee` |
| `Activités/*.xlsx` (<Terme mot="Apidae" />, 3 fichiers) | pédalo, canoë-kayak, paddle, bateau promenade, base nautique, ouverts à tous | `pedalo` (« Sur l'eau ») |

:::howto{caption="Source : build.py (construire_experiences)"}
Une ligne par source. Les fichiers sont décrits dans [DataTourisme](/donnees-ssp/sites-et-equipements/donnees-france-datatourisme), [Activités](/donnees-ssp/activites) et [BD TOPO](/donnees-ssp/fonds-de-carte/bdtopo).
:::

- **Règles communes** : un point hors Isère ou sans nom est écarté ; deux expériences de même type et même nom à moins de 400 m sont un doublon ; le détail fait 160 caractères au plus.
- **« Sur l'eau »** : 14 activités ouvertes à tous (bases nautiques, canoë-kayak, le bateau La Mira, location de bateaux électriques, paddle à Chamrousse). Exclus : piscines, rafting, plongée, aviron, voile, offres pour groupes, doublons, bureaux loin de l'eau. Aucune location de pédalo n'est mentionnée dans les données : aucune n'a été inventée.
- **Coucher de soleil, vérifié sur le relief** : un point de vue nommé ou une plage de lac devient un `coucher-de-soleil` si l'ouest est dégagé. Avec l'altimétrie de l'IGN (RGE ALTI), on regarde vers 240°, 270° et 300°, de 300 m à 20 km, courbure de la Terre et réfraction comprises ; le point est gardé si le relief dépasse l'horizon de 4° au plus dans une direction. Le détail dit la saison (« horizon dégagé au coucher du soleil en été (relief IGN, estimé) »).
- **Apidae sans coordonnées** : la commune est lue dans l'adresse, puis on cherche un site du catalogue au nom proche ; sinon, l'expérience est placée au centre de la commune, et le détail le dit. Les horaires qui contiennent un téléphone, une adresse électronique ou un lien sont retirés.

Limites : une partie des activités nautiques Apidae est au centre de leur commune. Un même point BD TOPO peut être `point-de-vue` et `coucher-de-soleil`, avec deux identifiants.

</details>

<details>
<summary>Espaces fragiles</summary>

Chaque site à la position exacte reçoit une étiquette quand il est dans un espace protégé :

| Étiquette | Source | Sites |
| --- | --- | ---: |
| « Espace naturel sensible : nom » | `Sites et équipements/ENS_equipements.gpkg` (147 périmètres), à moins de 50 m | 272 |
| « Réserve naturelle : nom » | BD TOPO, couche `parc_ou_reserve` | 29 |
| « Natura 2000 : nom » | BD TOPO, couche `parc_ou_reserve` | 277 |

:::howto{caption="Source : build.py · ENS_equipements.gpkg, BD TOPO"}
Un site peut porter plusieurs étiquettes : 481 sites sont fragiles en tout. Le lac de Paladru ne l'est pas ; les marais de la Véronnière, du même lieu, le sont.
:::

`@flux/data` exporte `estEspaceFragile(site)` et `zonagesFragiles(site)`. Le classement des alternatives lit les étiquettes ENS et réserve naturelle, mais pas <Terme mot="Natura 2000" />, qui couvre de grands espaces de montagne (voir [Score et classement](/matching/score-et-classement)). Voir aussi les [ENS](/donnees-ssp/sites-et-equipements/ens-equipements) et la [biodiversité](/donnees-ssp/biodiversite).

</details>

<details>
<summary>Alternatives conseillées et calendrier</summary>

**Alternatives** (`construire_alternatives`), depuis `Sites sur-fréquentés.xlsx` (Isère Attractivité, voir [Sites sur-fréquentés](/donnees-ssp/sites-et-equipements/sites-sur-frequentes)) et le portail P1 :

1. Feuille « Lieux conseignés » : 65 couples *site très fréquenté → lieu conseillé*.
2. Feuille « Sites fréquentés », colonne « Itinéraire Bis » : 6 couples ; le texte va dans `Site.itineraireBis` (29 sites).
3. Portail P1 : seulement les couples **déclarés**, étendus à tous les sites du même pôle : 58. Les couples seulement déduits ne sont pas repris : ils seraient affichés « Conseillée par l'office de tourisme », ce qui serait faux.

**Calendrier** : `docs/public/dataviz/p2/calendrier.json`, complété par deux <Terme mot="API" /> publiques en cache : `data.education.gouv.fr` (calendrier scolaire de l'académie de Grenoble, zone A, jusqu'à fin 2027) et `calendrier.api.gouv.fr` (jours fériés 2025 à 2027). Résultat : 19 périodes de vacances et 33 jours fériés ; l'historique complet (depuis 2020) sert au coefficient vacances des profils.

</details>

<details>
<summary>Services autour des sites et accès déclarés</summary>

**Entrées** : <Terme mot="OSM" ancre="osm" /> (OpenStreetMap, licence ODbL), interrogé par l'API Overpass en 30 tuiles mises en cache (3,5 Mo, versionnées) ; BD TOPO de l'IGN (ombre, règles sur les chiens). Pour chaque site placé au point, on compte ce qui est relevé **dans un rayon de 300 m** :

| Champ de `ServicesSite` | Ce qui est compté | Sites renseignés (sur 2 541) |
| --- | --- | ---: |
| `toilettes` | toilettes relevées | 902 |
| `bancs` | bancs | 1 059 |
| `eau` | points d'eau potable | 841 |
| `jeux` | aires de jeux | 650 |
| `ombre` | part d'ombre, de 0 à 1 (forêt ouverte comptée à moitié, déduit) | 2 379 |
| `fauteuil` | accès en fauteuil : `oui`, `limite`, `non` | 172 (95 oui, 35 limité, 42 non) |
| `chiens` | règle sur les chiens | 86 (dont 74 « non », surtout par réglementation) |

:::howto{caption="Source : packages/data/generated/services.json, accès déclarés compris"}
Une valeur inconnue devient un champ absent dans l'application, jamais « non » : l'écran affiche « Non vérifié ».
:::

**Accès déclarés** : 60 sites ont un accès déclaré par le lieu ou par un label ; 27 sont dans `services.json` (les 33 autres n'ont qu'une position de commune). Sources, phrases explicites seulement : le label **Tourisme & Handicap** (Atout France), les fiches **Apidae**, le **recensement des équipements sportifs** (seule la valeur « accessible » est lue). Une fiche qui se contredit ne donne rien. La source est ajoutée à `ServicesSite.source`.

**Déclarations des gestionnaires** : « Mon lieu » n'est pas dans le jeu. La déclaration est saisie dans l'application, gardée sur l'appareil (`plutot-la:mon-lieu:v1`), et **passe avant OpenStreetMap**. Voir le [parcours gestionnaire](/plutotla/parcours-gestionnaire).

Limite : les règles « chiens interdits » viennent surtout du zonage, pas d'un panneau sur place.

</details>

<details>
<summary>Climatologie et météo du jour</summary>

**Climatologie** : `Météo/données météo 1986-2024.csv` (Météo-France, SSP Cloud) donne `climat.json`, **48 stations** de 136 à 1 860 m, période 1991-2024 : pour chaque mois, probabilité d'un jour de pluie, température maximale moyenne, part de jours chauds. `stationProche` choisit la station la plus proche d'altitude voisine (± 250 m, à moins de 40 km) ; la température est corrigée de l'altitude du site (− 0,65 °C par 100 m, déduit).

**Météo du jour** : aucune prévision n'est dans le jeu. `prevoirMeteo(position, options)` (`packages/data/src/meteo.ts`) demande à **Open-Meteo** (sans clé, sans compte) la prévision sur 16 jours à la **position du site**, rien d'autre ; abandonne après 6 secondes ; garde la prévision en cache (stockage local, 3 heures ; sans réseau, une prévision de moins de 48 heures sert encore) ; sinon se replie sur la climatologie (`repliClimatologie`). « Tout effacer », côté visiteur, vide ce cache.

</details>

<details>
<summary>Index léger et chargement à la demande</summary>

Pour que l'accueil s'affiche tout de suite, le script écrit un **index léger** (`index.json`) : mêmes sites, même ordre, même version, 11 champs par site (`id`, `lieuId`, `nom`, `categorie`, `type`, `commune`, `insee`, `position` arrondie à 100 m environ, `precision`, `surfrequente`, `scoreDonnees`).

| Entrée de `@flux/data` | Pour qui | Ce qu'elle donne |
| --- | --- | --- |
| `@flux/data/leger` | le code de l'application | `chargerIndex()` (immédiat), `prechargerJeu()` (import dynamique), `jeuCharge()`, `chargerJeuComplet()`, `chargerServices()`, `chargerClimat()`, `prevoirMeteo()`, `rechercherSites()` et les schémas zod ; **jamais** `jeu.json` en import direct |
| `@flux/data` | les tests et les outils | la même chose, plus `chargerJeu()`, synchrone |

:::howto{caption="Source : exports de packages/data/package.json"}
Un seul import de `@flux/data` dans l'application remettrait les 2 Mo du jeu dans le premier chargement ; un test vérifie que l'espace gestionnaire et la projection ne l'importent pas.
:::

Un fichier abîmé est refusé, et un échec de chargement n'est pas gardé : l'appel suivant réessaie.

</details>

<details>
<summary>Fiches des lieux : types de sortie, photos libres, horaires</summary>

Pour garder `jeu.json` sous 2 Mo, trois champs vont dans `fiches.json` (même version, une ligne par site), et trois autres dans `details.json` : les sources d'un site, la provenance et la précision d'une expérience, chaque libellé écrit une seule fois. `@flux/data` les fusionne dans le jeu avant la validation ; si les versions diffèrent, une erreur lisible le dit.

| Champ de `Site` | Rempli pour | D'où |
| --- | ---: | --- |
| `typeSortie` | 2 872 sites (tous) | déduit de la famille, du type, du nom et de l'altitude |
| `photo` | 489 sites, 416 lieux | Wikimedia Commons, via Wikidata |
| `horaires` | 1 409 sites : 1 282 en accès libre, 127 avec un texte | accès libre déduit du type ; texte des horaires DATAtourisme |

:::howto{caption="Source : packages/data/generated/fiches.json, version 5086974512cc"}
Un champ absent veut dire « inconnu » : pas de photo (on montre un dessin), horaires inconnus (on le dit au visiteur).
:::

**Les 11 types de sortie** (`TypeSortie`) : château et patrimoine 806, sport de nature 595, balade nature 496, randonnée en montagne 234, musée 192, neige et ski 167, village à visiter 98, point de vue 93, parc de loisirs 77, lac et baignade 76, gorges, cascades et grottes 38. La famille d'abord ; un lac à 1 300 m ou plus devient une randonnée en montagne (Lauvitel, Muzelle) ; les mots de montagne ne comptent qu'au-dessus de 700 m. Les règles sont écrites deux fois (`fiches.py` et `packages/core/src/sorties.ts`) ; un test compare les deux et échoue au-delà de 3 % d'écart.

**Photos libres** : décision de l'équipe projet, **seulement des images libres de droits**, chargées depuis leur source avec leur crédit, jamais une image protégée prise sur un site web.

1. **Wikidata** : les éléments qui ont une image (propriété P18) et une position.
2. **Rapprochement strict** : nom rapproché **et** position cohérente **et** même commune (300 m, ou 1,5 km dans la même commune, 3 km pour un lieu vaste). Une fiche sans photo vaut mieux qu'une mauvaise photo.
3. **Wikimedia Commons** : auteur et licence lus dans les métadonnées. Seules passent CC0, domaine public, CC BY et CC BY-SA.
4. **Miniature de 500 px** sur `upload.wikimedia.org`, chargée depuis sa source, jamais recopiée dans le dépôt.

| Licence | Photos |
| --- | ---: |
| CC BY-SA (versions 1.0 à 4.0) | 360 |
| Domaine public | 27 |
| CC BY (versions 2.0 à 4.0) | 25 |
| CC0 | 4 |
| **Total** | **416** |

:::howto{caption="Source : table des photos de fiches.json"}
Une photo par lieu physique ; les 416 photos couvrent 489 entrées et 34 des 48 sites de la liste d'Isère Attractivité (45 sites sur-fréquentés en Isère, 3 à La Grave). Les réponses brutes restent hors du dépôt ; le résultat réduit est versionné (`generated/cache/wikimedia.json`).
:::

**Horaires, DATAtourisme** : la plateforme nationale des données touristiques. On prend l'**export ouvert de data.gouv.fr** (Licence Ouverte 2.0, sans compte ni clé). Le CSV régional n'a ni image ni heure : il faut le RDF national (1,9 Go compressé, 14 Go décompressé), réduit par `extraire_datatourisme.py` à **1 133 lieux** (`generated/cache/datatourisme.json`). Aucun contact n'est lu. Constats sur l'export du 10 novembre 2026 : aucune photo utilisable (les images de l'export national sont en CC BY-NC-ND, donc pas libres) ; des horaires sans jours de la semaine, d'où **127 sites** avec un texte à montrer tel quel et **aucun** avec des plages par jour ; 1 282 lieux de plein air reçoivent `acces: "libre"` d'après leur type.

Limites : 14 des 48 sites de la liste d'Isère Attractivité n'ont pas de photo. Le rapprochement peut se tromper : le Lac de la Grande Moucherolle montre une photo du sommet. « Lac de Pierre Châtel » est mal placé.

</details>

## Reconstruire le jeu

```bash
# depuis la racine, avec un Python qui a pandas, openpyxl, duckdb, numpy, pyproj, shapely
PYTHON=/chemin/vers/venv/bin/python pnpm data
# sans réseau (caches de packages/data/generated/cache/ seulement)
FLUX_HORS_LIGNE=1 PYTHON=/chemin/vers/venv/bin/python pnpm data
```

Environ 17 s hors ligne ; plusieurs minutes au premier lancement (tuiles OpenStreetMap). Deux lancements avec les mêmes entrées donnent le même fichier. Les fichiers de `generated/` sont **versionnés** : Vercel n'a ni Python ni `data/`, il construit l'application avec le jeu déjà présent (voir [Développer](/plutotla/developper)).

<details>
<summary>Variables d'environnement, format et validation</summary>

| Variable | Rôle |
| --- | --- |
| `PYTHON` | interpréteur (défaut `python3`) ; lancé en mode isolé `-I -W ignore` |
| `FLUX_DATA` | dossier des données brutes (défaut : `data/` à la racine) |
| `FLUX_PORTAIL` | dossier public du portail (défaut : `docs/public/`) |
| `FLUX_HORS_LIGNE` | `1` : aucun appel réseau ; les caches suffisent |
| `FLUX_EXTERNES` | téléchargements bruts, **hors du dépôt** (défaut `~/data-externes/plutot-la`) |
| `FLUX_LIEUX` | fichier JSON où écrire les lieux à plusieurs entrées |
| `FLUX_OSM_RAFRAICHIR` | `1` : télécharge à nouveau les 30 tuiles OpenStreetMap (plus de 10 minutes) |
| `SOURCE_DATE_EPOCH` | date de génération fixe |

:::howto{caption="Source : packages/data/scripts/build.sh et build.py"}
Une ligne par variable lue par le script. Aucune n'est obligatoire.
:::

- `jeu.json` suit exactement `JeuDeDonnees`, sauf `lieuId` omis quand il vaut `id`. `version` est une empreinte SHA-256 (12 caractères) du contenu.
- `@flux/data` le valide une fois avec zod (`schemaJeuDeDonnees`) ; en cas d'écart, une erreur lisible donne les 5 premiers problèmes. Les quatre autres fichiers ont leurs propres schémas. zod tourne sans génération de code (`jitless`), comme l'exige la politique de sécurité (CSP) de l'application native.
- `src/index.test.ts` vérifie que les schémas suivent le contrat, que le fichier pèse moins de 2 Mo, les règles de lieux, de noms, de « Sur l'eau » et d'espaces fragiles, l'index léger, les accès déclarés, et l'absence d'adresse et de téléphone. `meteo.test.ts` teste la météo sans réseau.

</details>

## Règles respectées

- Rien n'est écrit dans `data/` ; seuls des agrégats et des données ouvertes entrent dans le jeu.
- Aucune adresse électronique, aucun téléphone, aucune clé ; le catalogue Excel du SSP Cloud n'est pas lu. Un test le vérifie.
- Le fichier des ventes de forfaits (données personnelles) n'est pas utilisé.
- Photos libres seulement, avec auteur, licence et lien ; horaires jamais inventés : un champ absent veut dire « inconnus ».
- Chaque source est listée dans le jeu et visible dans l'écran « Données ouvertes » du gestionnaire.

## Limites

:::limits{link="/plutotla/limites-et-suite"}
- **Neige** : les compteurs ne mesurent que des marcheurs ; le profil des sites de neige est celui des piétons, pas des skieurs. Les ventes de forfaits agrégées et les comptages de ski de randonnée pourraient donner un profil d'hiver.
- **Horaires** : aucun lieu n'a de plages par jour de la semaine ; 127 lieux n'ont qu'un texte à vérifier.
- **Services** : OpenStreetMap est peu renseigné sur l'accès en fauteuil (172 sites sur 2 541) et sur les chiens (86).
- **Taille** : le jeu pèse 1,99 Mo, environ 10 Ko sous la limite de 2 Mo du test ; tout nouveau champ devra aller dans un fichier à part.
- **Hypothèses** : la correction de température par l'altitude et le poids de l'ombre sont déduits ; la climatologie est une moyenne, pas le temps d'un jour donné.
:::
