Aller au contenu
Plutôt là

Données : du SSP Cloud au jeu embarqué

En bref
Pour qui
Data scientists, développeurs, toute personne qui veut vérifier un chiffre.
Lecture
5 min
Mise à jour
11 novembre 2026

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

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.

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.

Le flux, en quatre étapes

  1. Sources

    748 fichiers du SSP Cloud, bases du portail, API publiques, DATAtourisme

  2. Script

    build.py relie, nettoie, agrège et vérifie, sans rien écrire dans data/

  3. Jeu embarqué

    cinq fichiers JSON versionnés dans packages/data/generated/

  4. Téléphone

    index léger tout de suite, le reste à la demande, hors ligne ensuite

Source : packages/data/scripts/build.py, packages/data/src/ · jeu version 5086974512cc

Comment lire

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.

Le schéma complet du flux (sources, transformations, fichiers)
Diagramme

Source : packages/data/scripts/build.py

Comment lire

À 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.

Ce que contient le jeu

FichierTailleContenuChargé
jeu.json1,75 Mo (281 Ko compressé)sites et lieux, profils, expériences, alternatives conseillées, calendrieren arrière-plan, au démarrage
details.json68 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.json237 Ko (69 Ko compressé)11 champs par site, pour la recherchetout de suite
fiches.json198 Ko (27 Ko compressé)type de sortie, photo libre, horairesavec le jeu
services.json156 Kotoilettes, bancs, ombre, eau, jeux, accès en fauteuil, chiens à 300 mà la demande
climat.json16 Konormales mensuelles de 48 stations Météo-Franceà la demande

Source : packages/data/generated/ · version 5086974512cc

Comment lire

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 jeuNombreD'où
Sites2 872 entrées, 2 563 lieuxcatalogue du portail, enrichi des compteurs proches, des lieux et des zonages
Profils d'affluence260254 profils de compteurs et 6 profils moyens
Expériences2 245DataTourisme, BD TOPO, PDESI, Apidae
Alternatives conseillées129 couplesIsère Attractivité (71), couples déclarés du portail P1 (58)
Vacances scolaires19 périodeszone A, fin 2024 à fin 2027
Jours fériés33 jours2025 à 2027
Sources citées31chaque fichier utilisé et son usage

Source : packages/data/generated/jeu.json, version 5086974512cc

Comment lire

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

PartieSources principalesCe que fait le script
Sites et compteurscatalogue du portail, 420 compteurs de passagesrattache à chaque site jusqu'à 3 compteurs à moins de 2 km, avec une confiance
Lieuxcatalogue, BD TOPO, ENS, pôles du portail P1réunit les entrées d'un même endroit (règles R0 à R4)
Noms lisiblescataloguecorrige 402 noms (« PPO_Voreppe » devient « Parcours d'orientation de Voreppe »)
Profils d'affluenceécocompteurs de l'Isère, 2021-2026un profil par mois, jour de la semaine, heure et vacances, en base 100
ExpériencesDataTourisme, BD TOPO, PDESI, Apidae, altimétrie IGN8 types ; coucher du soleil vérifié sur le relief
Espaces fragilesENS, BD TOPO (réserves, Natura 2000)481 sites marqués fragiles
Alternatives conseilléesSites sur-fréquentés.xlsx, portail P1couples déclarés seulement, jamais déduits
Calendrierportail P2, calendrier scolaire, jours fériésvacances de la zone A et fériés
ServicesOpenStreetMap, BD TOPO, labels et fiches Apidaerelevé à 300 m de chaque site placé au point
ClimatologieMétéo/données météo 1986-2024.csv48 stations, une ligne par mois
Fiches des lieuxWikidata et Wikimedia Commons, DATAtourismetype de sortie, photo libre avec crédit, horaires

Source : packages/data/scripts/build.py et fiches.py

Comment lire

Une ligne par partie, dans l'ordre du script. Le détail de chaque ligne est replié ci-dessous.

Sites et compteurs

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.

Transformation (construire_sites) :

  1. Chaque ligne du catalogue devient un Site. Son id est le nom d'origine en minuscules sans accents, suivi du code INSEETerritoire : Code à cinq chiffres d'une commune dans le Code officiel géographique, par exemple 38185 pour Grenoble. À ne pas confondre avec le code postal. C'est la clé de jointure la plus sûre entre fichiers. : 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 écocompteursTourisme : Capteur automatique posé sur un sentier ou une piste cyclable qui compte les passages (piétons, vélos), souvent par heure ou par quart d'heure. Il compte des passages, pas des personnes : un aller-retour compte deux fois. à 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, GTFSTransport : General Transit Feed Specification. Format standard des horaires théoriques de transport en commun : une archive ZIP de fichiers texte (arrêts, lignes, courses, horaires de passage, calendrier). Le portail en recense 149 dans le bucket. ; parkings : parkings à moins de 500 m, BD TOPOTerritoire : Base de données topographique de l'IGN : bâtiments, routes, cours d'eau, lieux nommés, équipements, zones protégées, en 3D et à précision métrique. Fournie pour l'Isère en GeoPackage et en Parquet.), 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).

Lieux : un endroit, plusieurs entrées

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ègleDeux entrées sont le même lieu si…
R0le portail les range dans le même groupe de sites sur-fréquentés (« pôle » de la page P1, vérifié à la main)
R1mê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
R2elles 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
R3même sentier ou même ENS, à moins de 1,5 km, et un nom propre commun
R4elles partent du même point, et l'une est un itinéraire qui porte le nom de l'autre (33 regroupements)
Jamaisun site et l'alternative que l'office conseille à sa place ; deux lacs différents

Source : build.py (construire_lieux)

Comment lire

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 (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 (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.

Noms lisibles

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.

Profils d'affluence

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) : 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 DuckDBDonnées et outils : Moteur SQL qui tourne dans un script Python, R ou en ligne de commande, sans serveur. Il lit directement des fichiers Parquet ou CSV, y compris sur un stockage S3, et calcule vite sur des millions de lignes. : profil par heure).

Diagramme

Source : build.py (construire_profils, profil_journalier, profil_horaire)

Comment lire

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 centileDonnées et outils : Valeur sous laquelle se trouve un pourcentage donné des observations. Le 95e centile du nombre de lits par habitant est la valeur que seules 5 % des communes dépassent. Le portail s'en sert comme plafond, pour qu'une valeur extrême n'écrase pas les autres..
  • 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) 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).

Exemple réel, profil generique:nature-et-paysages (base 100Données et outils : Valeur divisée par une valeur de référence, puis multipliée par 100. La référence vaut donc 100 : 150 signifie « une fois et demie la référence », 80 « 20 % de moins ». Cela permet de comparer des sources de tailles très différentes (deux compteurs, des nuitées et des entrées de musée).) :

JFMAMJJASOND
Mois607782100120118107110103917356
LunMarMerJeuVenSamDim
Jour7882818680134158

Source : Fréquentation/eco-compteur-Isère/comptages/ · moyenne des compteurs piétons proches de sites « Nature et paysages » (déduit)

Comment lire

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.

Expériences
Source (SSP Cloud)Ce qu'on en tireType
Sites et équipements/Données France DataTourisme.xlsx, « Données restaurants »restaurants, cafés, glaciersrestaurant
idem, « Données sites de loisir »plages et piscines ; parcs de loisirs, fermes pédagogiques, mini-golfsbaignade, famille
idem, « Données sites culturels »musées, centres d'interprétation ; parcs et jardinsmusee, famille
idem, « Données brutes »itinéraires pédestresrandonnee
idem, plusieurs feuilleslocation de matériel nautique, bateaux promenade, bases nautiquespedalo (« Sur l'eau »)
Fonds de carte/BDTOPO/…gpkg, couche zone_d_activite_ou_d_interetpoints de vue, baignades surveillées, bases nautiques, musées, parcs, sentiersplusieurs types
Rando/plan-départemental-des-espaces-sites-et-itinéraires.geojson (PDESIEnvironnement : Plan départemental des espaces, sites et itinéraires relatifs aux sports de nature. Liste, arrêtée par le Département au titre du code du sport, des lieux de pratique des sports de nature à préserver et à gérer : falaises d'escalade, sites de vol libre, itinéraires.)trail et raquettes, au départ du tracérandonnee
Activités/*.xlsx (ApidaeTourisme : Réseau et base de données touristiques alimentés par les offices de tourisme d'Auvergne-Rhône-Alpes et d'autres territoires : hébergements, activités, événements, sites. Accessible par une API avec clé., 3 fichiers)pédalo, canoë-kayak, paddle, bateau promenade, base nautique, ouverts à touspedalo (« Sur l'eau »)

Source : build.py (construire_experiences)

Comment lire

Une ligne par source. Les fichiers sont décrits dans DataTourisme, Activités et BD TOPO.

  • 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.

Espaces fragiles

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

ÉtiquetteSourceSites
« Espace naturel sensible : nom »Sites et équipements/ENS_equipements.gpkg (147 périmètres), à moins de 50 m272
« Réserve naturelle : nom »BD TOPO, couche parc_ou_reserve29
« Natura 2000 : nom »BD TOPO, couche parc_ou_reserve277

Source : build.py · ENS_equipements.gpkg, BD TOPO

Comment lire

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 Natura 2000Environnement : Réseau européen de sites naturels désignés au titre des directives Oiseaux (ZPS) et Habitats (ZSC). Un projet ou une manifestation qui peut les affecter doit évaluer ses incidences., qui couvre de grands espaces de montagne (voir Score et classement). Voir aussi les ENS et la biodiversité.

Alternatives conseillées et calendrier

Alternatives (construire_alternatives), depuis Sites sur-fréquentés.xlsx (Isère Attractivité, voir Sites sur-fréquentés) 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 APIDonnées et outils : Interface de programmation. Adresse web qu'un programme interroge pour recevoir des données (souvent en JSON) au lieu de télécharger un fichier. Certaines demandent une clé d'accès, à ne jamais publier. 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.

Services autour des sites et accès déclarés

Entrées : OSMDonnées et outils : OpenStreetMap. Carte du monde libre et collaborative. Ses objets portent des étiquettes (« tags ») comme tourism=viewpoint ; la qualité dépend des contributeurs locaux. (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 ServicesSiteCe qui est comptéSites renseignés (sur 2 541)
toilettestoilettes relevées902
bancsbancs1 059
eaupoints d'eau potable841
jeuxaires de jeux650
ombrepart d'ombre, de 0 à 1 (forêt ouverte comptée à moitié, déduit)2 379
fauteuilaccès en fauteuil : oui, limite, non172 (95 oui, 35 limité, 42 non)
chiensrègle sur les chiens86 (dont 74 « non », surtout par réglementation)

Source : packages/data/generated/services.json, accès déclarés compris

Comment lire

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.

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

Climatologie et météo du jour

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.

Index léger et chargement à la demande

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/dataPour quiCe qu'elle donne
@flux/data/legerle code de l'applicationchargerIndex() (immédiat), prechargerJeu() (import dynamique), jeuCharge(), chargerJeuComplet(), chargerServices(), chargerClimat(), prevoirMeteo(), rechercherSites() et les schémas zod ; jamais jeu.json en import direct
@flux/datales tests et les outilsla même chose, plus chargerJeu(), synchrone

Source : exports de packages/data/package.json

Comment lire

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.

Fiches des lieux : types de sortie, photos libres, horaires

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 SiteRempli pourD'où
typeSortie2 872 sites (tous)déduit de la famille, du type, du nom et de l'altitude
photo489 sites, 416 lieuxWikimedia Commons, via Wikidata
horaires1 409 sites : 1 282 en accès libre, 127 avec un texteaccès libre déduit du type ; texte des horaires DATAtourisme

Source : packages/data/generated/fiches.json, version 5086974512cc

Comment lire

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.
LicencePhotos
CC BY-SA (versions 1.0 à 4.0)360
Domaine public27
CC BY (versions 2.0 à 4.0)25
CC04
Total416

Source : table des photos de fiches.json

Comment lire

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é.

Reconstruire le jeu

TerminalBash
# 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).

Variables d'environnement, format et validation
VariableRôle
PYTHONinterpréteur (défaut python3) ; lancé en mode isolé -I -W ignore
FLUX_DATAdossier des données brutes (défaut : data/ à la racine)
FLUX_PORTAILdossier public du portail (défaut : docs/public/)
FLUX_HORS_LIGNE1 : aucun appel réseau ; les caches suffisent
FLUX_EXTERNEStéléchargements bruts, hors du dépôt (défaut ~/data-externes/plutot-la)
FLUX_LIEUXfichier JSON où écrire les lieux à plusieurs entrées
FLUX_OSM_RAFRAICHIR1 : télécharge à nouveau les 30 tuiles OpenStreetMap (plus de 10 minutes)
SOURCE_DATE_EPOCHdate de génération fixe

Source : packages/data/scripts/build.sh et build.py

Comment lire

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.

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

À garder en tête

  • 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).
Toutes les limites (5)
  • 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é.
Limites communes des données →