# Bases croisées : le dictionnaire des données de l'onglet DataViz

::::summary{title="En bref" audience="Data scientists et développeurs qui réutilisent les données DataViz." reading="5 min (dictionnaires repliés)" updated="11 novembre 2026"}

Les fichiers communs à toutes les pages DataViz, le sens de chaque champ, la correspondance compteur et site, les totaux de contrôle.

:::details[Données utilisées]
BD TOPO, hébergements Insee et Apidae, DataTourisme, 2 872 sites, écocompteurs, GTFS Loopi, commerces, emploi URSSAF, covoiturage, ENS, ZNIEFF, PDIPR ; hors bucket : résidences secondaires (Insee).
:::

::::

Toutes les pages de l'onglet DataViz partent des **mêmes fichiers**. On rapproche les sources **une seule fois**, au même endroit : un chiffre affiché sur deux pages est toujours le même.

<Etapes etapes={[
  { titre: "Données brutes", texte: "Fichiers du SSP Cloud, en lecture seule : BD TOPO, hébergements, sites, compteurs, GTFS, Apidae…", icone: "database" },
  { titre: "build_base.py", texte: "Rattache chaque ligne à une commune (code Insee ou point dans le polygone)", icone: "git-merge" },
  { titre: "Bases croisées", texte: "Fond de carte, indicateurs par commune et par EPCI, sites, compteurs", icone: "table" },
  { titre: "Pages", texte: "Cartes et graphiques de l'onglet DataViz, qui ne lisent jamais les données brutes", illustration: "/matching/illustrations/mascotte.svg" },
]} />

<StatGrid>
  <Stat label="Communes" value="512" hint="toute l'Isère, BD TOPO 2026" />
  <Stat label="Champs par commune" value="61" hint="dont 12 déduits et 4 hors bucket" />
  <Stat label="Sites projetés" value="2 872" hint="dont 2 667 en Isère" />
  <Stat label="Compteurs projetés" value="420" hint="uniques, dont 258 avec un total 2025" />
</StatGrid>

:::howto{caption="Source : meta.json des bases croisées"}
Les autres nombres de compteurs cités dans le portail (469, 408, 186, 254) ont un autre périmètre : voir [Combien de compteurs selon le périmètre](#combien-de-compteurs-selon-le-périmètre).
:::

## Les fichiers

Tous les fichiers sont servis par le portail sous `/dataviz/base/`. On peut les ouvrir dans le navigateur ou les télécharger.

| Fichier | Contenu | Taille |
|---|---|---:|
| [communes.json](/dataviz/base/communes.json) | Fond de carte : contour SVG de chaque commune et du département | 547 Ko |
| [communes-indicateurs.json](/dataviz/base/communes-indicateurs.json) | 61 indicateurs pour chacune des 512 communes, dont 4 hors bucket (résidences secondaires, Insee) | 855 Ko |
| [communes-indicateurs.csv](/dataviz/base/communes-indicateurs.csv) | La même table à plat, pour un tableur (séparateur point-virgule ; les 4 champs hors bucket en dernières colonnes) | 137 Ko |
| [epci-indicateurs.json](/dataviz/base/epci-indicateurs.json) | Les indicateurs additionnés par intercommunalité (18 EPCI) | 21 Ko |
| [sites.json](/dataviz/base/sites.json) | Les 2 872 sites du catalogue (2 667 en Isère, 205 dans les départements voisins), placés sur le fond de carte | 596 Ko |
| [compteurs.json](/dataviz/base/compteurs.json) | Les 420 compteurs de passage uniques, placés sur le fond de carte, avec leur total 2025 | 151 Ko |
| [compteurs-sites.json](/dataviz/base/compteurs-sites.json) | Pour chacun des 45 sites sur-fréquentés de l'Isère (48 dans la liste, dont 3 à La Grave) : le compteur retenu, sa distance et un niveau de confiance (déduit) | 24 Ko |
| [meta.json](/dataviz/base/meta.json) | Date de calcul, sources (dont la source hors bucket), totaux de contrôle | 5 Ko |

:::howto{caption="Source : public/dataviz/base/"}
Pour une carte, il faut `communes.json` plus un fichier de valeurs ; pour un tableau, `communes-indicateurs.json` suffit (le CSV dans un tableur).
:::

## Les indicateurs, commune par commune

<DataTable src="/dataviz/base/communes-table.json" pageSize={15} placeholder="Rechercher une commune, un code Insee, une intercommunalité…" />

:::howto{caption="Source : communes-indicateurs.json · (déduit) pour les rapports"}
Triées par lits touristiques. « Lits pour 100 hab. » mesure la dépendance au tourisme (déduit). « Couverture GTFS » vaut « incomplète » quand le réseau urbain manque : « Arrêts TC » est alors trop bas.
:::

## Dictionnaire des données

Une base par bloc ; ouvrez celui dont vous avez besoin.

### communes.json : le fond de carte

Un objet unique. Les coordonnées sont déjà converties dans le repère du dessin : aucune projection n'est à faire côté navigateur.

<details>
<summary>Les champs de communes.json</summary>

| Champ | Définition | Source | Unité |
|---|---|---|---|
| `viewBox` | Cadre du dessin SVG, `"0 0 1000 1015"` | calcul | pixels SVG |
| `width`, `height` | Largeur (1000) et hauteur (1015) du dessin | calcul | pixels SVG |
| `projection` | Paramètres pour passer du Lambert-93 au dessin (voir plus bas) | calcul | — |
| `outline` | Contour du département (chemin SVG) | BD TOPO, union des communes | chemin SVG |
| `simplification_m` | Tolérance de simplification des contours | calcul | mètres |
| `features[].insee` | Code Insee de la commune (5 caractères) | BD TOPO, couche `commune` | texte |
| `features[].nom` | Nom officiel | BD TOPO | texte |
| `features[].d` | Contour de la commune (attribut `d` d'un `path` SVG) | BD TOPO, simplifiée | chemin SVG |
| `features[].cx`, `cy` | Point d'étiquette, toujours à l'intérieur de la commune | calcul (pôle d'inaccessibilité) | pixels SVG |
| `features[].population` | Population municipale | BD TOPO (recensement Insee) | habitants |
| `features[].surface_km2` | Surface, calculée sur le contour complet | BD TOPO | km² |
| `features[].epci`, `epci_siren` | Intercommunalité de rattachement et son numéro SIREN | BD TOPO, couche `epci` | texte |

Pour dessiner la carte, on trace un `path` par élément de `features`, puis `outline` par-dessus. Les communes voisines partagent exactement la même frontière, sans trou ni chevauchement.

</details>

### communes-indicateurs.json : les indicateurs croisés

Un objet dont chaque clé est un code Insee. Les communes sans donnée valent 0 (et non « absent »), sauf les champs de l'Insee hors bucket, qui valent `null` s'ils manquent.

<details>
<summary>Les champs de communes-indicateurs.json</summary>

| Champ | Définition | Source (dossier du bucket) | Unité |
|---|---|---|---|
| `nom`, `population`, `surface_km2`, `epci`, `epci_siren` | Comme dans `communes.json` | BD TOPO | — |
| `densite_hab_km2` | Population divisée par la surface (déduit) | calcul | hab./km² |
| `lits` | Lits touristiques marchands : hôtels, campings et autres hébergements collectifs | `Hébergements/Hébergements par commune.xlsx` (Insee, 1er janvier 2026) | lits |
| `lits_hotels`, `lits_campings`, `lits_autres_collectifs` | Détail de `lits` par type (autres collectifs : résidences de tourisme, villages vacances, auberges de jeunesse) | idem | lits |
| `etablissements`, `etablissements_hotels`, `etablissements_campings`, `etablissements_autres_collectifs` | Nombre d'hébergements, au total et par type | idem | établissements |
| `lits_pour_100_hab` | Lits pour 100 habitants, appelé aussi taux de fonction touristique (déduit) | calcul | lits / 100 hab. |
| `sites` | Sites touristiques du catalogue situés dans la commune | `docs/public/tables/sites-isere.json` | sites |
| `sites_par_categorie` | Détail de `sites` par catégorie : Loisirs et baignade, Nature et paysages, Neige, Patrimoine et culture, Sports de nature | idem | sites |
| `sites_surfrequentes` | Sites de la liste « sur-fréquentés » d'Isère Attractivité | `Sites et équipements/Sites sur-fréquentés.xlsx`, via le catalogue | sites |
| `sites_conseilles` | Lieux conseillés en report par Isère Attractivité | idem | sites |
| `score_moyen_sites` | Moyenne du score de données exploitables des sites de la commune (déduit) | catalogue | note sur 10 |
| `compteurs` | Compteurs de passage situés dans la commune | `Fréquentation/eco-compteur-Isère/sites/sites_isere.csv` et archives `Fréquentation/DONNEES brutes ecocompteurs ENS/` | compteurs |
| `compteurs_actifs_2025` | Parmi eux, ceux qui ont au moins un jour de mesure en 2025 | comptages journaliers 2025 et mesures ENS 2025 | compteurs |
| `arrets_tc` | Arrêts de transport en commun distincts (même nom à 10 m près = un seul arrêt). **Sous-compté** là où `tc_couverture` vaut « incomplète » | `Transports/Données transports Loopi~/data/gtfs/*.zip`, fichiers `stops.txt` | arrêts |
| `arrets_tc_pour_1000_hab` | Arrêts pour 1 000 habitants (déduit) | calcul | arrêts / 1 000 hab. |
| `tc_couverture` | « incomplète » si le réseau urbain de la commune manque aux horaires du bucket, sinon « réseaux présents » (déduit) | contrôle des fichiers `agency.txt` des 149 flux | texte |
| `tc_reseau_absent` | Nom du réseau absent (M réso, TouGo ou Pays Voironnais Mobilités), vide sinon | idem | texte |
| `gares` | Gares de voyageurs (intérêt national, régional ou local) | `Transports/Equipements gares, taxis et aéroport par commune.xlsx` (BPE Insee) | gares |
| `parkings` | Parkings recensés par l'IGN | BD TOPO, couche `equipement_de_transport` | parkings |
| `aires_covoiturage`, `places_covoiturage` | Aires de covoiturage et leurs places | `Transports/Mobilités alternatives (covoiturage, bornes élecrtiques.).xlsx`, feuille « Covoiturage » (BNLC) | aires, places |
| `stations_recharge`, `points_recharge` | Stations de recharge électrique et points de charge | idem, feuille « recharges électriques » | stations, points |
| `evenements` | Fiches de fêtes et manifestations, rattachées par la commune de leur adresse | `Activités/Fêtes et manifestations.xlsx` (Apidae) | fiches |
| `restaurants` | Restaurants et restauration rapide | `Commerces/Commerces par commune.xlsx`, feuille « Commerces par commune 4 » | établissements |
| `restaurants_pour_1000_hab` | Restaurants pour 1 000 habitants (déduit) | calcul | restaurants / 1 000 hab. |
| `commerces` | Grandes surfaces, commerces alimentaires de proximité et commerces de biens courants (hors restaurants) | idem | établissements |
| `grandes_surfaces`, `commerces_alimentaires`, `commerces_courants` | Détail de `commerces` | idem | établissements |
| `emplois_tourisme` | Salariés des activités du tourisme en 2025 (codes APE 55, 56, 79, 77.21, 91.02 à 91.04, 93.2) | `Emploi/emplois en Isère par commune.xlsx` (URSSAF) | salariés |
| `emplois_tourisme_detail` | Détail : `hebergement` (55), `restauration` (56), `agences_voyage` (79), `loisirs` (77.21, 91.02 à 91.04, 93.2) | idem | salariés |
| `etablissements_employeurs_tourisme` | Établissements employeurs de ces mêmes activités en 2025 | idem | établissements |
| `apidae_hebergements` | Fiches d'hébergement Apidae, rattachées par la commune de leur adresse | `Hébergements/Hébergements Apidae.xlsx` | fiches |
| `apidae_meubles`, `apidae_hotels`, `apidae_campings`, `apidae_collectifs` | Détail par type Apidae : hébergement locatif (meublés et gîtes), hôtellerie, hôtellerie de plein air, hébergement collectif | idem, colonne « Type » | fiches |
| `apidae_capacite_meubles` | Capacité des meublés : somme des « Capacité maximum » (sinon « Capacité ») déclarées | idem, colonne « Spécificités » | personnes |
| `apidae_chambres_hotels` | Chambres déclarées par les hôteliers | idem | chambres |
| `datatourisme` | Fiches DataTourisme situées dans la commune (point dans le polygone, sinon nom et code postal) | `Sites et équipements/Données France DataTourisme.xlsx`, feuilles « Données … » | fiches |
| `datatourisme_detail` | Détail par feuille : `evenements`, `prestataires`, `sites_culturels`, `sites_loisirs`, `hebergements`, `restauration`, `commerces_services` | idem | fiches |
| `surface_ens_km2`, `part_ens_pct` | Surface de la commune en espace naturel sensible, et sa part (déduit) | `Sites et équipements/ENS_equipements.gpkg`, couche `fusionn` | km², % |
| `surface_znieff_km2`, `part_znieff_pct` | Surface en ZNIEFF de type I ou II (sans double compte des zones superposées), et sa part (déduit) | `Biodiversité/Infos biodiversité - CGDD/ZNIEFF.zip` (`ZNIEFF1_G2`, `ZNIEFF2_G2`) | km², % |
| `part_znieff1_pct` | Part de la surface en ZNIEFF de type I seulement, les zones les plus remarquables (déduit) | idem | % |
| `pdipr_km` | Longueur des tronçons du plan départemental des itinéraires de randonnée dans la commune (déduit) | `Rando/plan-departemental-des-itineraires-de-promenades-et-de-randonnees-departement-de.geojson` | km |
| `logements` | **Hors bucket.** Ensemble des logements en 2023, arrondi à l'unité | Insee, recensement 2023, [« Logement en 2023 »](https://www.insee.fr/fr/statistiques/8997194) (jeu `DS_RP_LOGEMENT_PRINC`, géographie au 1er janvier 2026) | logements |
| `res_secondaires` | **Hors bucket.** Résidences secondaires **et logements occasionnels** en 2023 (l'Insee ne les sépare pas à la commune), arrondi à l'unité | idem, catégorie `DW_SEC_DW_OCC` | logements |
| `part_res_secondaires` | **Hors bucket.** Part des résidences secondaires dans l'ensemble des logements (déduit) | calcul sur les deux champs précédents | % |
| `insee_millesime` | **Hors bucket.** Année du recensement des trois champs précédents (2023) | idem | année |

Un champ est une colonne de la table, une commune est une ligne. Les champs marqués « (déduit) » sont calculés par le portail à partir des autres champs ou des contours : ils ne viennent tels quels d'aucun fichier source. Les champs marqués « hors bucket » viennent d'un fichier public de l'Insee, absent des données fournies pour le hackathon.

</details>

:::note{title="Résidences secondaires : une source hors bucket"}
Les champs `logements`, `res_secondaires`, `part_res_secondaires` et `insee_millesime` ne viennent pas du SSP Cloud : ils sont lus dans le fichier public de l'Insee [« Logement en 2023 »](https://www.insee.fr/fr/statistiques/8997194), décrit dans [Résidences secondaires (Insee)](/sources/territoire-sites-et-referentiels/residences-secondaires-insee). Les 512 communes sont couvertes : 55 900 résidences secondaires et logements occasionnels sur 688 500 logements, soit 8,1 % (déduit). La part dépasse 80 % dans les stations : Auris, Chamrousse, Huez, Les Deux Alpes (déduit). Le script `scripts/insee_residences.py` télécharge le fichier et garde l'extrait de l'Isère dans un cache non versionné ; `meta.json` cite la source.
:::

:::caution{title="Arrêts de transport : sous-comptés dans 123 communes"}
M réso, TouGo et Pays Voironnais Mobilités manquent aux horaires du bucket : dans ces 123 communes (652 000 habitants), `arrets_tc` ne compte que les cars et les trains (51 arrêts à Grenoble, 0 à Meylan) et `tc_couverture` vaut « incomplète ». Voir [Limites des données](/dataviz/limites-des-donnees#transports-en-commun--réseaux-urbains-absents).
:::

### epci-indicateurs.json : les intercommunalités

Un objet dont chaque clé est le numéro SIREN de l'intercommunalité : la **somme** des indicateurs de comptage des communes, et les rapports recalculés à son échelle.

<details>
<summary>Les champs de epci-indicateurs.json</summary>

Champs : `nom`, `communes` (nombre de communes membres) et la **somme** des indicateurs de comptage des communes : `population`, `surface_km2`, `lits` et son détail, `sites`, `sites_par_categorie`, `sites_surfrequentes`, `sites_conseilles`, `compteurs`, `compteurs_actifs_2025`, `arrets_tc`, `gares`, `parkings`, `aires_covoiturage`, `places_covoiturage`, `stations_recharge`, `points_recharge`, `evenements`, `restaurants`, `commerces`, `emplois_tourisme`, `etablissements_employeurs_tourisme`, les champs `apidae_…`, `datatourisme`, `surface_ens_km2`, `surface_znieff_km2` et `pdipr_km`. Les rapports `lits_pour_100_hab`, `densite_hab_km2`, `part_ens_pct` et `part_znieff_pct` sont recalculés à l'échelle de l'intercommunalité (déduit). `tc_couverture` et `tc_reseau_absent` ont le même sens que pour les communes. **Hors bucket** (Insee, recensement 2023) : `logements` et `res_secondaires` sont additionnés, `part_res_secondaires` est recalculée (déduit), `insee_millesime` vaut 2023.

</details>

### sites.json : les sites placés sur la carte

Une liste d'objets, un par site, dans le même ordre que le [tableau de tous les sites](/sites/tous-les-sites).

<details>
<summary>Les champs de sites.json</summary>

| Champ | Définition | Source | Unité |
|---|---|---|---|
| `id` | Rang du site dans `tables/sites-isere.json` | catalogue | entier |
| `x`, `y` | Position dans le repère du fond de carte | calcul depuis la latitude et la longitude | pixels SVG |
| `nom`, `categorie`, `type`, `commune`, `insee` | Identité du site | catalogue (`scripts/build_sites_catalog.py`) | texte |
| `score` | Richesse des données exploitables autour du site | catalogue | note sur 10 |
| `surfrequente` | Le site est dans la liste des sites sur-fréquentés d'Isère Attractivité | catalogue | oui / non |
| `conseille` | Présent seulement si le site est un lieu conseillé en report | catalogue | oui |
| `position_approchee` | Présent seulement si le site est placé au centre de sa commune, faute de coordonnées | catalogue | oui |
| `fiche` | Présent seulement si le site a une fiche détaillée : adresse de la page | portail | lien |
| `hors_isere` | Présent seulement si le site est dans un département voisin : nom du département (Savoie, Hautes-Alpes…) | catalogue, champ `departement` | texte |

</details>

:::howto{caption="Source : sites.json, tables/sites-isere.json"}
205 des 2 872 sites sont dans un département voisin (70 en Savoie, 52 dans les Hautes-Alpes, 33 dans la Drôme…) et portent le champ `hors_isere` : filtrez-les ou masquez-les sur une carte de l'Isère.
:::

### compteurs.json : les compteurs de passage

Une liste d'objets, un par compteur. Les 49 compteurs des espaces naturels sensibles (ENS) présents dans les deux sources ne comptent qu'une fois, ici comme dans le [catalogue des sites](/sites/tous-les-sites).

<details>
<summary>Les champs de compteurs.json</summary>

| Champ | Définition | Source | Unité |
|---|---|---|---|
| `id` | Identifiant Eco-Compteur du site de comptage | `sites_isere.csv`, `sites.csv` des archives ENS | texte |
| `x`, `y` | Position dans le repère du fond de carte | calcul | pixels SVG |
| `lat`, `lon` | Position géographique | idem | degrés |
| `nom` | Nom du site de comptage | idem | texte |
| `source` | « Eco-Compteur Isère », « écocompteurs ENS » ou les deux | calcul | texte |
| `gestionnaire` | Organisme qui gère le compteur | `sites_isere.csv` (`domain_name`) | texte |
| `modes` | Ce qui est compté : piétons, vélos, trottinettes, voitures, véhicules, motos, bus | `user_types`, `channels.csv` | liste |
| `debut`, `fin`, `periode` | Premier et dernier jour de mesure ; `periode` donne les années | idem | date |
| `insee` | Commune qui contient le compteur (point dans le polygone) | calcul | texte |
| `total_2025` | Passages comptés en 2025, tous modes et tous sens confondus | `comptages/comptages_journalier_2025_2026.csv`, sinon `measures.csv` de l'archive ENS 2025 | passages |
| `jours_2025` | Jours de 2025 avec au moins une mesure | idem | jours |
| `couverture_2025` | Part des jours de 2025 mesurés, de 0 à 1 (déduit) | calcul | ratio |
| `moyenne_jour` | `total_2025` divisé par `jours_2025` (déduit) | calcul | passages / jour |
| `total_2025_source` | Fichier qui a servi au total | calcul | texte |

Les champs `total_2025` à `moyenne_jour` n'existent que pour les 258 compteurs mesurés en 2025. Avant de comparer deux compteurs, vérifiez `couverture_2025` : un compteur à 0,4 a manqué plus de la moitié de l'année.

</details>

### Combien de compteurs selon le périmètre

Pour l'Isère, retenez **420 compteurs de passage uniques**, dont **258 ont mesuré en 2025**. Les autres nombres cités dans le portail comptent autre chose.

<details>
<summary>Les six nombres de compteurs et leur périmètre</summary>

| Nombre | Ce qu'il compte | Fichier ou calcul | Où on le lit |
|---:|---|---|---|
| 469 | Lignes lues dans les deux listes de compteurs, **avant dédoublonnage** : 417 compteurs Eco-Compteur Isère + 52 compteurs ENS | `sites_isere.csv` et `sites.csv` des archives ENS ; `compteurs_avant_dedoublonnage` dans `meta.json` | `meta.json` des bases croisées |
| 420 | Compteurs **uniques** placés sur la carte : 49 des 52 compteurs ENS sont déjà dans Eco-Compteur Isère, ils ne comptent qu'une fois (417 + 3) | `compteurs.json` | cette page, [tous les sites](/sites/tous-les-sites), [Plutôt là](/plutotla) |
| 408 | Compteurs du seul fichier **Eco-Compteur Isère** qui ont au moins un jour de comptage du 1er janvier 2021 au 7 novembre 2026 (sans les compteurs ENS) | fichiers de `Fréquentation/eco-compteur-Isère/comptages/` | [Analyses · Eco-Compteur Isère](/analyses/frequentation/eco-isere) |
| 258 | Compteurs uniques qui ont **au moins un jour de mesure en 2025** : ils ont un `total_2025` | `compteurs.json`, `compteurs_total_2025` dans `meta.json` | cette page, [vue d'ensemble](/dataviz) |
| 186 | Compteurs retenus pour l'indice des pics : **124 piétons et 62 vélos** qui ont au moins une année complète (330 jours) entre 2021 et 2025 et au moins 20 passages par jour en moyenne (déduit) | `p2/meta.json` (`scripts/dataviz/p2.py`) | [P2 · Anticiper les pics](/dataviz/p2-anticiper-les-pics) |
| 254 | Compteurs dont l'application **Plutôt là** tire un profil d'affluence, parce qu'ils sont rattachés à un de ses sites (déduit) ; l'application ajoute 6 profils génériques, soit 260 profils | `packages/data/generated/jeu.json` | [Plutôt là](/plutotla) (page des données) |

:::howto{caption="Source : meta.json des bases croisées, p2/meta.json, analyse Eco-Compteur Isère, jeu de données de l'application"}
Du périmètre le plus large au plus étroit. Les 260 profils de l'application (254 de compteurs + 6 génériques) ne sont pas les 258 compteurs mesurés en 2025.
:::

</details>

### compteurs-sites.json : quel compteur mesure quel site sur-fréquenté ?

Un compteur proche d'un site ne le mesure pas forcément : il peut être sur un autre sentier, une route ou une piste cyclable. Ce fichier donne, pour chacun des **45 sites sur-fréquentés de l'Isère** (48 dans la liste d'Isère Attractivité, dont 3 à La Grave, dans les Hautes-Alpes), le compteur retenu et la **raison** de ce choix (déduit). Les pages P1 (report des flux) et P2 (anticipation des pics) peuvent s'en servir pour attribuer une fréquentation à un site.

| Niveau de confiance | Règle | Sites en Isère | Dans la liste |
|---|---|---:|---:|
| même nom | Un mot distinctif est commun au nom du site et au nom du compteur (Emparis, Taillefer, Chalais…), compteur à 5 km au plus | 20 | 20 |
| même sentier | Le compteur est posé (à 50 m près) sur un sentier relié sans rupture au site (300 m), à 2 km au plus. Réseau : PDIPR, chemins des ENS, sentiers et escaliers de la BD TOPO (les pistes « Chemin » sont exclues) | 15 | 15 |
| simple proximité | Le compteur le plus proche est à 2 km au plus, sans autre indice : à vérifier sur place | 4 | 4 |
| trop loin | Aucun compteur à moins de 2 km, et pas de nom commun à moins de 5 km : pas de mesure pour ce site | 6 | 9 (dont 3 à La Grave) |
| **Total** | | **45** | **48** |

:::howto{caption="Source : compteurs-sites.json (objet totaux) · (déduit)"}
Sur les 45 sites isérois, 35 ont un compteur utilisable, dont 28 ont mesuré en 2025 (total 2025 non nul). Un site reçoit le premier niveau qui s'applique, dans l'ordre du tableau.
:::

<details>
<summary>Les champs de compteurs-sites.json</summary>

| Champ | Définition | Unité |
|---|---|---|
| `rows[].site_id` | Rang du site dans `sites.json` (et dans `tables/sites-isere.json`) | entier |
| `rows[].site`, `commune`, `insee`, `x`, `y` | Identité et position du site | texte, pixels SVG |
| `rows[].departement`, `en_isere` | Département du site, et vrai si le site est en Isère (faux pour les 3 sites de La Grave) | texte, oui / non |
| `rows[].compteur_id`, `compteur`, `compteur_source`, `compteur_x`, `compteur_y` | Compteur retenu (identifiant de `compteurs.json`) | texte, pixels SVG |
| `rows[].distance_m` | Distance à vol d'oiseau entre le site et le compteur retenu | mètres |
| `rows[].confiance` | « même nom », « même sentier », « simple proximité » ou « trop loin » (déduit) | texte |
| `rows[].utilisable` | Vrai pour « même nom » et « même sentier » : le compteur peut représenter le site | oui / non |
| `rows[].modes`, `periode` | Ce que compte le compteur et ses années de mesure | liste, texte |
| `rows[].total_2025`, `moyenne_jour_2025`, `couverture_2025` | Repris de `compteurs.json`, seulement si le compteur a mesuré en 2025 | passages, ratio |
| `rows[].plus_proche_id`, `plus_proche`, `plus_proche_distance_m` | Présents seulement si le compteur retenu n'est pas le plus proche | texte, mètres |
| `rows[].compteurs_2km` | Nombre de compteurs à 2 km au plus du site | compteurs |
| `niveaux` | Rappel des règles ci-dessus | texte |
| `totaux` | Sites de la liste (48), en Isère (45) et hors Isère (3, La Grave), nombre de sites par niveau en Isère et hors Isère, sites isérois utilisables (35) et, parmi eux, avec un total 2025 (29, dont 28 non nuls) | sites |

Pour attribuer une fréquentation à un site, gardez les lignes où `utilisable` est vrai et où `total_2025` existe. Un `total_2025` à 0 signale un compteur en panne ou démonté. Pour ne garder que l'Isère, filtrez sur `en_isere` : 45 lignes sur 48.

</details>

## Le repère de la carte

Toutes les positions sont en **pixels SVG**, dans un cadre de 1000 sur 1015 : le nord en haut, l'axe vertical vers le bas. La conversion part du Lambert-93 (le système de coordonnées officiel en France, en mètres) :

```text
x = 10 + (X - 836000) * 0.0075734
y = 10 + (6534500 - Y) * 0.0075734
```

:::howto{caption="Source : scripts/dataviz/common.py"}
Un pixel vaut environ 132 mètres. Pour un point en latitude et longitude, utilisez `project(lon, lat)` du module Python décrit plus bas.
:::

## Les totaux de contrôle

Recalculés à chaque lancement et écrits dans [meta.json](/dataviz/base/meta.json) ; chacun est comparé à un chiffre connu (ligne « Total » d'un fichier, analyse, lignes lues).

<details>
<summary>Les totaux, indicateur par indicateur</summary>

| Indicateur | Total Isère | Contrôle |
|---|---:|---|
| Population | 1 298 990 | somme des 512 communes de la BD TOPO |
| Lits touristiques | 40 674 | identique à la ligne « Total » du fichier Insee, écartée du calcul |
| Hébergements | 451 | idem |
| Sites du catalogue en Isère | 2 667 | sur 2 872 sites ; les 205 autres sont dans les départements voisins (champ `departement`) |
| Sites sur-fréquentés en Isère | 45 | 48 dans la liste d'Isère Attractivité, dont 3 à La Grave (Hautes-Alpes) |
| Compteurs | 420 | 469 lignes lues : 417 Eco-Compteur Isère + 52 compteurs ENS, dont 49 déjà dans le premier fichier |
| Arrêts de transport en commun | 7 140 | 149 flux GTFS lus ; 123 communes à couverture incomplète |
| Fêtes et manifestations | 6 051 | sur 6 052 fiches (une seule est dans le Rhône) |
| Restaurants | 4 322 | identique à l'analyse « Commerces et emploi » |
| Commerces hors restaurants | 4 914 | idem |
| Emplois salariés du tourisme (2025) | 21 286 | identique à l'analyse « Commerces et emploi » (mêmes codes APE) |
| Aires de covoiturage | 474 | 5 313 places, identique à l'analyse « Covoiturage » |
| Stations de recharge | 429 | 1 024 points de charge |
| Hébergements Apidae | 5 008 | sur 5 017 fiches (9 hors Isère) ; 4 114 meublés pour 25 162 personnes |
| Fiches DataTourisme | 6 072 | toutes rattachées à une commune |
| Surface en ENS | 112 km² | 1,4 % de l'Isère (déduit) |
| Surface en ZNIEFF | 4 470 km² | 57 % de l'Isère, types I et II sans double compte (déduit) |
| Sentiers PDIPR | 9 199 km | somme des tronçons découpés par commune (déduit) |
| Résidences secondaires et logements occasionnels (hors bucket, Insee 2023) | 55 893 | sur 688 510 logements ; écart de moins de 0,1 % avec le total départemental de l'Insee (arrondis) |

</details>

## Comment rejouer les calculs

Depuis le dossier `docs/`, avec un environnement Python créé hors du dépôt à partir de `scripts/requirements.txt` :

```bash
python -I -W ignore scripts/insee_residences.py   # résidences secondaires de l'Insee (hors bucket), une fois
python -I -W ignore scripts/dataviz/build_base.py
```

Le calcul prend moins d'une minute. Il lit les données brutes dans `data/` sans jamais les modifier. La seule source hors bucket, le fichier de l'Insee, est téléchargée par `insee_residences.py` (98 Mo, une seule fois) dans `scripts/.cache/insee/` ; `build_base.py` la télécharge lui-même si ce cache manque. Il réécrit un fichier seulement si son contenu change : on peut le relancer autant de fois qu'on veut.

Pour reconstruire **toutes** les données du portail dans l'ordre (profilage, catalogue des sites, analyses, bases croisées, puis les fichiers des pages P0 à P5), un seul script :

```bash
PYTHON=~/venvs/hackathon-flux/bin/python scripts/rebuild-data.sh            # tout
PYTHON=~/venvs/hackathon-flux/bin/python scripts/rebuild-data.sh --sans-pages  # jusqu'aux bases croisées
```

Pour réutiliser les bases dans un autre script Python, importez le module commun :

```python
import sys
from pathlib import Path
sys.path.insert(0, str(Path("scripts/dataviz").resolve()))
from common import project, load_communes, load_indicateurs, load_sites, load_compteurs, load_compteurs_sites, commune_of, OUT

ind = load_indicateurs()                  # {"38185": {"nom": "Grenoble", "lits": 2377, ...}, ...}
x, y = project(5.7245, 45.1885)           # longitude, latitude -> position sur le fond de carte
insee = commune_of(5.7245, 45.1885)       # "38185"
fiables = [r for r in load_compteurs_sites() if r["utilisable"]]
```

:::howto{caption="Source : scripts/dataviz/common.py"}
`OUT` est le dossier `public/dataviz/` : un fichier JSON écrit là est servi sous `/dataviz/…`.
:::

## Limites

:::limits{link="/dataviz/limites-des-donnees"}
- **Apidae et DataTourisme** sont des fiches déclarées par les offices, pas un recensement : une commune sans fiche n'est pas forcément sans offre.
- **Emploi** : les effectifs URSSAF ne comptent que les salariés du privé, au lieu de l'établissement ; les petites valeurs (secret statistique) valent 0.
- **Événements** : la commune vient du texte de l'adresse Apidae (stations et anciennes communes converties par une table) ; `evenements` compte des fiches, pas des jours de fête.
- **Espaces protégés** : parts d'ENS et de ZNIEFF calculées sur les contours complets, ZNIEFF I et II sans double compte ; le fond de carte, lissé à 60 m, sert à dessiner, pas à mesurer.
- **Taille** : `communes-indicateurs.json` pèse 855 Ko ; dans le navigateur, préférez `communes-table.json` ou un extrait. Un même lieu peut apparaître sous deux noms proches dans `sites.json`.
:::
