Calculer une zone de chalandise

Une zone de chalandise réelle n'est pas un disque : la Seine, une voie ferrée ou un massif changent ce qu'on atteint en quinze minutes bien plus qu'un rayon en kilomètres ne peut le dire. Ce guide montre comment demander à GET /locations/search le contour réellement atteignable en voiture, à pied ou à vélo depuis l'un de vos sites, puis comment obtenir la population, les ménages et le niveau de vie moyen de cette zone avec POST /zone/stats, et enrichir une adresse précise avec GET /address/view/{id}. Les sites que vous interrogez viennent de votre propre référentiel ; s'il n'existe pas encore, créez-le d'abord avec le guide Mes lieux.

Les paramètres qui font une isochrone

Par défaut, /locations/search trie vos sites autour d'un point avec rayon, un disque en kilomètres à vol d'oiseau. Pour obtenir une zone de chalandise réelle, remplacez-le par quatre paramètres :

Paramètre	Rôle	Valeurs
duree	Durée de trajet en minutes — le rayon de temps, pas de distance	Entier, 1 à 30
mode	Mode de déplacement de l'isochrone ; n'a de sens qu'avec duree	auto (défaut) · pieton · velo
circulation	Hypothèse de circulation de l'isochrone ; n'a de sens qu'avec duree ; pointe demande la voiture	fluide (défaut) · pointe
polygone	Demande le contour GeoJSON de la zone dans la réponse	Booléen, défaut false

duree et rayon sont exclusifs l'un de l'autre : les envoyer ensemble, ou n'envoyer aucun des deux, est refusé en 422 (portee_ambigue) — de même qu'un mode fourni sans duree (mode_sans_duree). Même règle pour circulation : sans duree, 422 circulation_sans_duree ; pointe à pied ou à vélo, 422 circulation_mode_incompatible — un contour piéton « à l'heure de pointe » serait le même qu'en circulation libre, et le dire vaut mieux que le laisser croire. Aucune portée par défaut n'est prêtée d'office : un rayon supposé serait indiscernable d'un rayon voulu.

Un appel, une réponse

Le centre se donne par lat+lon, ou par adresse — une adresse complète, mais aussi un simple nom de commune. Voici la zone de chalandise à quinze minutes en voiture autour de Lyon, contour compris :

curl "https://api.trustydata.app/services/v1/locations/search?referentiel=boutiques&adresse=Lyon&duree=15&mode=auto&polygone=true&limit=5" \
  -H "Authorization: Bearer VOTRE_CLE_API"

{
  "resultats": [
    {
      "id_externe": "LYON-BELLECOUR",
      "nom_public": "Boulangerie Bellecour",
      "ligne_voie": "12 Place Bellecour",
      "code_postal": "69002",
      "commune": "Lyon",
      "latitude": 45.757814,
      "longitude": 4.832011,
      "distance_m": 241.7,
      "ouverture": { "statut": "ouvert", "prochaine_fermeture": "2026-09-05T19:30:00+02:00" },
      "statut": "actif",
      "geocodage_statut": "non_requis"
    }
  ],
  "pagination": { "limit": 5, "offset": 0, "next_offset": null, "total_estime": 1 },
  "point_central": {
    "lat": 45.75776,
    "lon": 4.83201,
    "adresse_resolue": "Lyon",
    "precision": "commune",
    "commune": "Lyon",
    "code_insee": "69382"
  },
  "portee": {
    "type": "isochrone",
    "duree_min": 15,
    "mode": "auto",
    "circulation": "fluide",
    "polygone": { "type": "Polygon", "coordinates": [ [ [4.79, 45.72], [4.91, 45.73], "…" ] ] }
  },
  "attribution": "Données cartographiques © les contributeurs OpenStreetMap, sous licence ODbL — https://www.openstreetmap.org/copyright"
}

Trois blocs à retenir. point_central dit où la recherche a réellement porté — ici precision: "commune", parce que la saisie ne désignait ni voie ni numéro : le centre est celui de la commune, à quelques kilomètres près sur une grande ville. portee.polygone porte le contour, présent seulement parce que polygone=true a été demandé (ici tronqué pour la lisibilité — un vrai contour compte des dizaines de points). Et chaque entrée de resultats[] garde sa distance_m à vol d'oiseau : c'est elle qui a classé la liste, pas le contour, qui ne sert qu'à délimiter qui entre dans la recherche.

attribution n'apparaît que parce que le moteur d'itinéraire a été sollicité (une duree, ou distances=true sur un rayon) : la mention OpenStreetMap/ODbL est alors obligatoire partout où le résultat est affiché — voir Attribution OSM.

Fluide ou heure de pointe

Par défaut, une isochrone est calculée en circulation libre : chaque tronçon est parcouru à sa vitesse de base (la limitation OpenStreetMap, ou la vitesse par défaut de sa catégorie). C'est circulation=fluide, et c'est ce que l'API a toujours fait. À 15 minutes du 1 rue Scribe à Paris, en voiture, cela fait 131,3 km² et 2 334 839 habitants — une zone qui déborde largement le périphérique, parce qu'à 30 km/h de moyenne on va loin en un quart d'heure.

circulation=pointe calcule la même zone à l'heure de pointe du matin, un jour ouvré vers 08:30. Les vitesses sont alors des vitesses typiques modélisées : à chaque tronçon s'applique un facteur qui dépend de sa classe de voie (autoroute, primaire, secondaire, tertiaire, desserte) et de la densité de population de son environnement (carreaux INSEE Filosofi de 200 m, sur 3 km autour), calibré pour que Paris rende ce que l'on observe à cette heure, et validé sur Lyon, Marseille et Saint-Lô. Ce n'est ni une mesure rue par rue, ni du trafic temps réel : une hypothèse de circulation, la même pour tout le monde, documentée. Même centre, même durée :

curl -X POST "https://api.trustydata.app/services/v1/zone/stats" \
  -H "Authorization: Bearer VOTRE_CLE_API" -H "Content-Type: application/json" \
  -d '{"adresse": "1 rue Scribe, 75009 Paris", "duree": 15, "mode": "auto", "circulation": "pointe"}'

{
  "point_central": {
    "lat": 48.870618,
    "lon": 2.329855,
    "adresse_resolue": "1 Rue Scribe, 75009 Paris 9e Arrondissement",
    "id": "af6bc041-64ae-463b-a310-f8f7f3af97e7",
    "precision": "adresse",
    "commune": null,
    "code_insee": null
  },
  "portee": {
    "type": "isochrone",
    "duree_min": 15,
    "mode": "auto",
    "circulation": "pointe",
    "rayon_km": null,
    "polygone": null
  },
  "surface_km2": 53.8,
  "population": 1125636,
  "menages": 579446,
  "menages_pauvres": 85483,
  "niveau_de_vie_moyen": 39336,
  "iris_couverts": 695,
  "carreaux": {
    "total": 1391,
    "estimes": 54
  },
  "source": {
    "filosofi_millesime": 2021,
    "contours_iris_millesime": 2026,
    "recensement_millesime": 2022
  },
  "attribution": "Source : INSEE, Filosofi 2021 (carreaux 200 m) et Recensement de la population 2022 (IRIS) ; IGN, Contours IRIS 2026. Prix immobiliers : DGFiP, Demandes de valeurs foncières (retraitement Etalab, licence ouverte). Itinéraires : Données cartographiques © les contributeurs OpenStreetMap, sous licence ODbL — https://www.openstreetmap.org/copyright"
}

53,8 km² et 1 125 636 habitants au lieu de 131,3 et 2 334 839 : la zone tient à peu près dans Paris et sa bordure immédiate, de Levallois à Bagnolet et de Clichy à la Seine — comparable à ce que rendent les outils de géomarketing à la même heure. La réponse répète le réglage dans portee.circulation, fluide compris : un chiffre ne se lit pas sans l'hypothèse qui le porte. Le même paramètre existe sur GET /locations/search, avec le même écho.

Lire le contour

portee.polygone est un objet GeoJSON standard — Polygon ou MultiPolygon selon la forme de la zone atteignable — en coordonnées WGS84 (longitude, latitude, dans cet ordre). C'est le format que consomment nativement Leaflet, Mapbox GL ou MapLibre pour tracer un calque : pas de reprojection à faire.

const zone = reponse.portee.polygone;
L.geoJSON(zone, { style: { color: 'seagreen', weight: 2, fillOpacity: 0.1 } })
  .addTo(carte);

Le contour pèse 10 à 20 Ko selon la complexité de la zone — c'est pour cela qu'il n'est jamais renvoyé par défaut : une intégration qui ne veut que la liste des sites (un widget « le plus proche de vous ») n'a pas à le transporter. Ne demandez polygone=true que sur l'appel qui affiche effectivement une carte.

Agréger — sur toute la zone

Le contour délimite ; POST /zone/stats compte. Avec le même centre, la même durée et le même mode que l'appel précédent, il rend ce que l'INSEE sait de ceux qui habitent la zone — le contour est déjà calculé côté API, il n'est pas recalculé, et l'appel est compté une fois quelle que soit la portée. Le corps porte aussi "reference": "departement" : un seul réglage pour deux blocs, les catégories socioprofessionnelles et les activités, expliqué dans les sections dédiées plus bas.

curl -X POST "https://api.trustydata.app/services/v1/zone/stats" \
  -H "Authorization: Bearer VOTRE_CLE_API" -H "Content-Type: application/json" \
  -d '{"adresse": "Lyon", "duree": 15, "mode": "auto", "reference": "departement", "coefficient": 0.15}'

{
  "point_central": {
    "lat": 45.758880705795356,
    "lon": 4.835271469337425,
    "adresse_resolue": "LYON",
    "id": null,
    "precision": "commune",
    "commune": "LYON",
    "code_insee": "69123"
  },
  "portee": {
    "type": "isochrone",
    "duree_min": 15,
    "mode": "auto",
    "circulation": "fluide",
    "rayon_km": null,
    "polygone": null
  },
  "surface_km2": 136.8,
  "population": 737118,
  "menages": 362321,
  "menages_pauvres": 54798,
  "niveau_de_vie_moyen": 27473,
  "iris_couverts": 367,
  "ages": {
    "0_3": {"effectif": 33973, "part": 4.6},
    "4_5": {"effectif": 16957, "part": 2.3},
    "6_10": {"effectif": 42873, "part": 5.8},
    "11_17": {"effectif": 58178, "part": 7.9},
    "18_24": {"effectif": 61809, "part": 8.4},
    "25_39": {"effectif": 179683, "part": 24.4},
    "40_54": {"effectif": 141153, "part": 19.1},
    "55_64": {"effectif": 76399, "part": 10.4},
    "65_79": {"effectif": 86506, "part": 11.7},
    "80_plus": {"effectif": 39173, "part": 5.3},
    "inconnu": {"effectif": 414, "part": 0.1}
  },
  "sexe": {
    "hommes": {"effectif": 391787, "part": 47.2},
    "femmes": {"effectif": 437708, "part": 52.8},
    "population_recensement": 829495
  },
  "menages_profil": {
    "personnes_seules": {"effectif": 167672, "part": 46.3},
    "cinq_personnes_et_plus": {"effectif": 20784, "part": 5.7},
    "proprietaires": {"effectif": 152643, "part": 42.1},
    "monoparentaux": {"effectif": 36080, "part": 10.0},
    "en_collectif": {"effectif": 334118, "part": 92.2},
    "en_maison": {"effectif": 28203, "part": 7.8},
    "surface_moyenne_m2": 72.5
  },
  "logements": {
    "total": 362321,
    "avant_1945": {"effectif": 96628, "part": 26.7},
    "de_1945_a_1970": {"effectif": 75848, "part": 20.9},
    "de_1970_a_1990": {"effectif": 73411, "part": 20.3},
    "apres_1990": {"effectif": 116116, "part": 32.0},
    "periode_inconnue": {"effectif": 318, "part": 0.1},
    "sociaux": {"effectif": 72480, "part": 20.0}
  },
  "csp": {
    "reference": {"type": "departement", "code": "69", "libelle": "Rhône"},
    "agriculteurs": {"effectif": 181, "part": 0.0, "indice": null, "reference_part": 0.4},
    "artisans_commercants": {"effectif": 20730, "part": 3.0, "indice": 84, "reference_part": 3.6},
    "cadres": {"effectif": 145787, "part": 20.9, "indice": 130, "reference_part": 16.1},
    "professions_intermediaires": {"effectif": 114598, "part": 16.4, "indice": 102, "reference_part": 16.1},
    "employes": {"effectif": 96377, "part": 13.8, "indice": 96, "reference_part": 14.4},
    "ouvriers": {"effectif": 45865, "part": 6.6, "indice": 71, "reference_part": 9.3},
    "retraites": {"effectif": 137518, "part": 19.7, "indice": 87, "reference_part": 22.6},
    "autres_inactifs": {"effectif": 136396, "part": 19.6, "indice": 110, "reference_part": 17.8},
    "fiabilite": {"population_15_plus": 697453, "part_iris_communaux": 0.8, "indices_fiables": true, "part_min": 0.5}
  },
  "potentiel_depense": {
    "unites_consommation": 525972,
    "revenu_disponible_estime": 14450034991,
    "revenu_disponible_par_menage": 39882,
    "coefficient": 0.15,
    "potentiel_theorique": 2167505249
  },
  "immobilier": {
    "source": "DVF géolocalisé (DGFiP / Etalab), diffusion 2026",
    "couverture": { "de": "2021-01-04", "a": "2025-12-30" },
    "hors_couverture": false,
    "reference": { "niveau": "departement", "code": "69", "libelle": "Rhône" },
    "appartements": {
      "annees": [
        { "annee": 2021, "ventes": 84, "prix_m2_median": 3402, "reference_prix_m2_median": 3200 },
        { "annee": 2022, "ventes": 12, "prix_m2_median": null, "reference_prix_m2_median": 3300 },
        { "annee": 2023, "ventes": 91, "prix_m2_median": 3750, "reference_prix_m2_median": 3350 }
      ],
      "evolution_pct": 10.2,
      "indice": 112,
      "fiabilite": { "ventes_min": 20, "annees_fiables": [2021, 2023] }
    },
    "maisons": { "...": "même forme" },
    "locaux_activite": { "...": "même forme" }
  },
  "activites": {
    "source": "SIRENE (INSEE), établissements actifs géolocalisés",
    "total": 222612,
    "reference": { "niveau": "departement", "code": "69", "libelle": "Rhône" },
    "fiabilite": { "taux_localisation": 82.2, "etablissements_min": 5, "indices_fiables": true },
    "familles": [
      { "cle": "commerce_detail_alimentaire", "libelle": "Commerce de détail alimentaire",
        "etablissements": 3124, "part": 1.4,
        "densite": 42.4, "reference_densite": 36.6, "indice": 116,
        "sous_familles": [
          { "cle": "alimentation_generale_et_superette", "libelle": "Alimentation générale, supérette",
            "etablissements": 813, "part": 0.4,
            "densite": 11.0, "reference_densite": 7.9, "indice": 140 },
          { "cle": "boulangerie_patisserie", "libelle": "Boulangerie, pâtisserie",
            "etablissements": 796, "part": 0.4,
            "densite": 10.8, "reference_densite": 9.1, "indice": 118 },
          { "...": "huit autres sous-familles" }
        ] },
      { "...": "les treize autres familles, toujours présentes, même à zéro" }
    ]
  },
  "carreaux": {
    "total": 3064,
    "estimes": 690
  },
  "source": {
    "filosofi_millesime": 2021,
    "contours_iris_millesime": 2026,
    "recensement_millesime": 2022
  },
  "attribution": "Source : INSEE, Filosofi 2021 (carreaux 200 m) et Recensement de la population 2022 (IRIS) ; IGN, Contours IRIS 2026. Prix immobiliers : DGFiP, Demandes de valeurs foncières (retraitement Etalab, licence ouverte). Itinéraires : Données cartographiques © les contributeurs OpenStreetMap, sous licence ODbL — https://www.openstreetmap.org/copyright"
}

Réponse obtenue avec une clé du plan Growth — la route demande ce plan au minimum, et rend la même chose en Business. Quatre choses à lire. population, menages et menages_pauvres sont des sommes des carreaux INSEE Filosofi de 200 m qui tombent dans la zone, pondérées par la part de chaque carreau dedans : un carreau à cheval sur la limite compte pour ce qui est à l'intérieur. niveau_de_vie_moyen est une moyenne par personne et par an, en euros — la seule grandeur de revenu qu'un carroyage permet d'additionner ; il vaut null si la population est nulle. iris_couverts compte les quartiers IRIS dont le contour touche la zone : un compte, pas une somme. Et carreaux.estimes dit combien de carreaux portent des valeurs imputées par l'INSEE au titre du secret statistique — souvent la majorité hors des villes denses, et c'est la norme du fichier, pas un défaut de votre zone.

attribution est à reproduire avec tout chiffre affiché : elle nomme les millésimes de Filosofi et des Contours IRIS, lus à chaque appel, et la mention OpenStreetMap s'y ajoute parce que la portée est une isochrone — et, pour les prix immobiliers, la DGFiP (DVF, retraitement Etalab, licence ouverte).

Qui habite la zone — le profil

Trois blocs disent qui vit dans la zone, avec la même pondération et la même source que la population : ages (onze tranches INSEE, de 0_3 à 80_plus, plus inconnu), menages_profil (personnes seules, ménages de cinq personnes et plus, propriétaires, familles monoparentales, ménages en collectif ou en maison, et surface_moyenne_m2) et logements (résidences principales par période de construction, et sociaux). Chaque indicateur porte un effectif, arrondi à l'entier, et une part en pourcentage au dixième, calculée avant l'arrondi et rapportée au total de son bloc : la population pour les âges, les ménages pour le profil des ménages, logements.total pour les logements. Les effectifs étant arrondis un par un, la somme des tranches peut s'écarter de population de quelques unités, et les parts d'un bloc sommer à 99,9 ou 100,1 — c'est l'arrondi, pas une erreur. Une part vaut null quand son total est nul, comme niveau_de_vie_moyen.

Ce que le carroyage ne porte pas, la réponse ne l'invente pas : aucune autre grandeur de revenu que le niveau de vie moyen. Les catégories socioprofessionnelles et la répartition par sexe, elles, viennent d'une autre source et sont une estimation — ce sont les deux sections suivantes. Les prix de vente immobiliers viennent d'une troisième source, DVF, et ont leur propre section ; les établissements installés dans la zone d'une quatrième, SIRENE, et ont la leur ; les procédures collectives et les arrêts d'activité s'y ajoutent, avec le BODACC, dans leur propre section.

Hommes et femmes — une estimation

Le bloc sexe donne hommes et femmes, chacun avec un effectif arrondi à l'entier et une part au dixième, calculée avant l'arrondi et rapportée à population_recensement — la somme des deux, rendue dans le bloc. Ce dénominateur n'est pas population : le carroyage Filosofi ne compte que les ménages ordinaires (millésime 2021), le recensement compte toute la population, résidences étudiantes, maisons de retraite et casernes comprises (millésime 2022). Sur l'exemple ci-dessus, l'écart est de 12,5 % ; au national il est de 6,2 %. Les deux parts somment à 100,0 à l'arrondi près.

Hypothèses et limites

Ces chiffres sont une estimation, et voici pourquoi :

1. Le sexe n'est diffusé qu'à l'IRIS. L'INSEE ne publie la population par sexe qu'à la maille du quartier IRIS (base infracommunale « Population », recensement 2022). Nous la répartissons sur les carreaux Filosofi de 200 m au prorata de leur population totale, sous l'hypothèse d'un rapport hommes / femmes homogène à l'intérieur de l'IRIS ; un carreau à cheval sur deux IRIS va entièrement à celui qui contient son centre. L'hypothèse est moins forte que pour les catégories socioprofessionnelles — le rapport varie peu d'une rue à l'autre — mais c'est une hypothèse.
2. Deux populations qui ne se recouvrent pas. population_recensement (recensement 2022, population totale) n'est pas population (Filosofi 2021, ménages ordinaires) : +6,2 % au national, jusqu'à +14 % sur une zone urbaine dense qui loge beaucoup de personnes en collectivité. Les parts sont calculées sur la première, pour qu'elles somment à 100 et que le numérateur et le dénominateur soient de même nature.
3. La fiabilité est celle du bloc csp. Même ventilation, mêmes IRIS : csp.fiabilite (part_iris_communaux, indices_fiables) dit aussi pour ce bloc quelle part de la zone vit dans des communes non découpées en IRIS — là, la répartition est la plus grossière — et si la zone tient dans un ou deux IRIS.
4. Ce qui se perd au chargement, et Mayotte. 1,37 % de la population par sexe du fichier national ne rejoint aucun carreau (IRIS sans contour ou sans carreau peuplé, mesure masse_perdue_sexe_pct à l'ingestion du 17 septembre 2026). Mayotte est absente du fichier du recensement : une zone à Mayotte a une population mais un bloc sexe à zéro, parts null.
5. Ce que le bloc ne rend pas. Ni croisement par âge, ni par catégorie socioprofessionnelle, ni indice par rapport à la France ou au département — le rapport hommes / femmes varie trop peu d'un territoire à l'autre pour qu'un indice dise quelque chose —, ni détail par IRIS. Sur une zone vide, les effectifs valent 0 et les parts null.

Quelle catégorie socioprofessionnelle — une estimation

Le bloc csp donne les huit catégories socioprofessionnelles INSEE de la population de 15 ans et plus (agriculteurs, artisans_commercants, cadres, professions_intermediaires, employes, ouvriers, retraites, autres_inactifs), chacune avec un effectif, une part de la population de 15 ans et plus du recensement répartie sur la zone (la somme des huit postes) au dixième, et un indice d'affinité : 100 × la part dans la zone / la part dans la référence. 100 est la moyenne de la référence ; 130 pour les cadres veut dire une part près d'un tiers plus élevée ; 71 pour les ouvriers, une part inférieure de près d'un tiers. La référence est la France entière par défaut, ou le département qui pèse le plus dans la zone avec "reference": "departement" dans la requête — csp.reference.code dit lequel, et csp.reference.libelle le nomme comme l'INSEE l'écrit (« Rhône », « La Réunion »). Ce réglage n'est pas propre aux catégories socioprofessionnelles : il gouverne aussi l'indice du bloc activités, un seul réglage pour deux blocs. Le bloc fiabilite donne population_15_plus — c'est ce dénominateur —, la part de cette population qui vit dans des communes non découpées en IRIS (part_iris_communaux), un drapeau indices_fiables, vrai à partir de 1 000 personnes de 15 ans et plus, et part_min : la part minimale, en pourcentage de la population de 15 ans et plus, sous laquelle indice n'est pas servi sur un poste — elle vaut 0,5. Chaque poste porte aussi reference_part : sa part sur le territoire de référence, au même dénominateur que l'indice, servie même quand indice vaut null sous ce plancher.

Lire un indice. Un indice est un rapport, pas une différence. Dans une zone où les artisans, commerçants et chefs d'entreprise pèsent 2,9 % des habitants de 15 ans et plus avec un indice de 82 par rapport au Rhône, ils sont 18 % moins présents qu'à l'échelle du département — où ils pèsent environ 3,5 %. L'écart en points n'est que de 0,6. reference_part donne cette seconde part : citer les deux côte à côte évite la confusion.

Hypothèses et limites

Ces chiffres sont une estimation, et voici en détail comment elle est faite, pour que vous décidiez seul si elle convient à votre usage.

1. La source est à l'IRIS, pas au carreau. L'INSEE ne diffuse les catégories socioprofessionnelles qu'à l'IRIS (recensement de la population, base infracommunale « Population »), jamais au carreau de 200 m. Nous répartissons les effectifs de chaque IRIS sur ses carreaux Filosofi, sous l'hypothèse que la composition socioprofessionnelle est homogène à l'intérieur de l'IRIS. Un IRIS d'habitat fait 1 800 à 5 000 habitants ; à cette échelle l'hypothèse est raisonnable, mais elle ne voit pas la différence entre deux rues d'un même quartier.
2. La clé de répartition est la population de 15 ans et plus estimée du carreau. Le carroyage ne compte pas les 15 ans et plus : nous retirons de la population les tranches 0-3, 4-5 et 6-10 ans, et quatre septièmes de la tranche 11-17 ans (11, 12, 13 et 14 ans sur sept années, âges supposés uniformes dans la tranche). Cette clé n'est pas le dénominateur des parts. population_15_plus est la population de 15 ans et plus du recensement 2022 répartie sur la zone — la somme des huit postes —, et c'est sur elle que parts et indices sont calculés, pour qu'elles somment à 100 et que l'indice compare deux grandeurs de même nature (la référence est elle aussi sur base recensement). Elle ne coïncide pas avec population : le recensement compte la population totale, communautés comprises (résidences étudiantes, maisons de retraite, foyers), là où Filosofi ne compte que les ménages ordinaires, à un an d'écart. Sur l'exemple de Lyon, 697 453 personnes de 15 ans et plus pour 737 118 habitants : ne comparez pas les deux.
3. Un carreau appartient à l'IRIS qui contient son centre. Un carreau à cheval sur deux IRIS n'est pas découpé ; il va entièrement à celui de son centroïde.
4. Sous 1 000 personnes de 15 ans et plus, les indices recopient le profil d'un ou deux IRIS. Ils sont rendus quand même, avec indices_fiables: false. Ne les citez pas comme une caractéristique de la zone : c'est celle de son quartier.
5. Les petits postes n'ont pas d'indice. Les catégories socioprofessionnelles ne sont diffusées qu'à l'IRIS : pour les ramener à une zone, elles sont réparties sur les carreaux au prorata de la population. Cette répartition suppose que chaque catégorie se distribue dans l'IRIS comme la population entière — une approximation acceptable pour une catégorie nombreuse, fausse pour une catégorie rare et géographiquement groupée. Sous fiabilite.part_min (0,5 % de la zone), l'indice n'est donc pas servi et vaut null ; l'effectif et la part, eux, restent affichés. Un exemple donne la mesure : sur un rayon de 3 km autour du centre de Paris, la catégorie « agriculteurs » pèse 159 personnes sur 573 837, soit 0,0 % — un rapport à la moyenne nationale n'y voudrait rien dire.
6. En zone rurale, l'IRIS est la commune entière. La répartition y est la plus grossière : tout le territoire communal reçoit le même profil. part_iris_communaux chiffre la part de la population de la zone concernée ; à 100, lisez les indices comme ceux de la commune.
7. La référence départementale est celle du département qui pèse le plus dans la zone, en population de 15 ans et plus, pas celui du centre.
8. Les millésimes diffèrent. Filosofi est de 2021, le recensement de 2022 dans la géographie communale du 1er janvier 2024, les Contours IRIS de 2026 : un an d'écart entre revenus et catégories, et quelques IRIS du recensement qui ne trouvent plus leur contour après une fusion de communes. source porte les trois millésimes.
9. Ce que la répartition perd, mesuré au chargement. Mesuré à l'ingestion du 12 septembre 2026 : 95 IRIS du recensement ne retrouvent pas de contour dans les Contours IRIS 2026 et 334 IRIS appariés n'ont aucun carreau peuplé pour recevoir leur répartition — respectivement 137 494 personnes de 15 ans et plus (0,25 % du total national) et 590 506 personnes dont la catégorie socioprofessionnelle ne rejoint aucune zone ; ce sont ces deux cas, et eux seuls, qui expliquent les 1,3 % de la masse socioprofessionnelle nationale restant non répartie. À l'inverse, 44 IRIS présents dans les Contours IRIS n'ont pas de ligne dans le fichier du recensement — essentiellement à Mayotte —, et 2 769 carreaux ne tombent dans aucun IRIS, pour 107 702 et 34 844 habitants respectivement : ces carreaux-là ne retranchent aucune masse nationale, ils portent simplement zéro catégorie socioprofessionnelle et comptent pour zéro dans l'indice de toute zone qui les recouvre. La référence France, elle, somme tout le fichier : elle n'est pas entamée par cette perte.
10. Ce que le bloc ne rend pas. Ni revenu médian — aucune source de revenu de la plateforme n'en porte au carreau ; les prix de vente immobiliers, eux, sont une médiane par construction, dans leur propre bloc —, ni croisement par âge ou par sexe — la répartition hommes / femmes de la zone a son propre bloc —, ni détail par IRIS.
11. Le bloc peut rendre null. part et indice valent null sur une zone vide (aucun carreau peuplé) ; indice vaut aussi null quand la part de la référence est nulle (un département sans vecteur exploitable, ou un poste à zéro dans la référence), et sur un poste dont la part est sous fiabilite.part_min (ci-dessus). reference.code et reference.libelle valent null en référence france, et aussi en référence departement sur une zone vide. La référence France n'est jamais substituée en silence : demander le département sans qu'il puisse être déterminé rend null, pas la France. reference_part vaut null quand aucune référence n'est connue, c'est-à-dire sur une isochrone inatteignable, où rien n'a été lu, ou quand le département de référence n'a pas pu être déterminé ; une zone sans population en référence France la sert, puisque la France reste connue autour d'elle. Elle vaut 0.0 pour un poste qui ne compte personne sur le territoire de référence.

Ce que valent les logements et les locaux qui s'y vendent — les prix immobiliers

Le bloc immobilier donne, pour trois types de bien — maisons, appartements, locaux_activite —, le prix de vente déclaré des biens vendus dans la zone, par année sur cinq ans : dans annees[], le nombre de ventes, le prix_m2_median en euros par m² de surface réelle bâtie, et reference_prix_m2_median, la même médiane sur tout le département de reference (son code et son libelle). Chaque série porte aussi evolution_pct, la variation du prix médian entre la première et la dernière année fiables — sur toute la période, pas annualisée —, et indice, 100 × prix de la zone / prix du département sur la dernière année fiable. La source est le fichier « Demandes de valeurs foncières » de la DGFiP dans sa version géolocalisée par Etalab (source dit la diffusion, couverture la date de première et de dernière vente connue).

"immobilier": {
  "source": "DVF géolocalisé (DGFiP / Etalab), diffusion 2026",
  "couverture": { "de": "2021-01-04", "a": "2025-12-30" },
  "hors_couverture": false,
  "reference": { "niveau": "departement", "code": "69", "libelle": "Rhône" },
  "appartements": {
    "annees": [
      { "annee": 2021, "ventes": 84, "prix_m2_median": 3402, "reference_prix_m2_median": 3200 },
      { "annee": 2022, "ventes": 12, "prix_m2_median": null, "reference_prix_m2_median": 3300 },
      { "annee": 2023, "ventes": 91, "prix_m2_median": 3750, "reference_prix_m2_median": 3350 }
    ],
    "evolution_pct": 10.2,
    "indice": 112,
    "fiabilite": { "ventes_min": 20, "annees_fiables": [2021, 2023] }
  },
  "maisons": { "...": "même forme" },
  "locaux_activite": { "...": "même forme" }
}

Lisez 2022 : douze ventes, pas de prix. Sous fiabilite.ventes_min ventes dans l'année, la médiane n'est pas servie — on ne cite pas un prix de marché sur douze actes — et l'année n'entre ni dans l'évolution ni dans l'indice ; annees_fiables dit sur quoi ils reposent.

Hypothèses et limites

Ces chiffres sont des prix de vente déclarés, pas une estimation, mais ils demandent d'être lus pour ce qu'ils sont :

1. Ce ne sont pas des loyers. DVF ne contient aucun loyer. Le prix d'un local d'activité est son prix de vente ; en déduire un loyer suppose un taux de rendement que rien dans la donnée ne fonde, et l'API ne le fait pas.
2. « Local d'activité » est une catégorie fourre-tout. Le code DVF 4, « local industriel, commercial ou assimilé », mêle boutique, entrepôt, bureau et atelier, et la surface bâtie y manque plus souvent. Sa médiane est un ordre de grandeur, pas un prix de marché.
3. Le prix est celui de l'acte, au m² de surface réelle bâtie. Il inclut les frais d'agence quand ils sont à la charge du vendeur, jamais les frais de notaire ni le mobilier ; les ventes en l'état futur d'achèvement (neuf, TVA comprise) sont incluses. La surface est la surface réelle bâtie cadastrale, pas la surface Carrez.
4. Une vente = une mutation, un seul type de bien. Une maison vendue avec sa dépendance et son jardin compte une fois, sur la somme de ses surfaces bâties. Un acte qui mêle deux types (un appartement et un local, une maison et un appartement) est écarté : le prix n'y est pas ventilable. Sont écartés aussi les échanges, adjudications, expropriations, terrains nus, les biens sans coordonnées, sans surface bâtie (moins de 9 m²) ou dont le prix au m² sort de 300 à 25 000 €.
5. Sous 20 ventes dans l'année, pas de prix. ventes est servi, prix_m2_median vaut null. Une zone de 10 minutes à pied en zone rurale passe souvent sous ce seuil pour les maisons et presque toujours pour les locaux d'activité.
6. La dernière année est sous-comptée. Une vente n'apparaît qu'une fois publiée par le service de publicité foncière, ce qui prend des mois ; à la diffusion d'octobre, la dernière année ne porte que son premier semestre. couverture.a dit jusqu'où les ventes sont connues. Ne comparez pas le nombre de ventes de la dernière année aux précédentes ; son prix médian, lui, reste une médiane sur les ventes connues.
7. L'évolution n'est pas annualisée. evolution_pct compare la première et la dernière année fiables, quel que soit l'écart entre elles.
8. La référence est le département qui compte le plus de ventes dans la zone, à défaut celui qui pèse le plus dans ses carreaux ; jamais la France. Une zone en mer ou vide n'en a pas (reference: null, indice: null).
9. Alsace-Moselle et Mayotte ne sont pas dans DVF. Le Bas-Rhin, le Haut-Rhin et la Moselle relèvent du livre foncier, un régime de publicité foncière propre où les ventes ne sont pas publiées dans DVF ; Mayotte n'y est pas publiée non plus. La Guadeloupe, la Martinique, la Guyane et La Réunion, elles, le sont. Une zone dont la référence est le 57, le 67, le 68 ou le 976 — et ceux-là seulement — rend hors_couverture: true et des séries à zéro : ce n'est pas « aucune vente ».
10. Ce que le bloc ne rend pas. Ni déciles ni distribution, ni prix des terrains, ni nombre de pièces, ni détail par vente, ni exclusif ou chevauchement dans /zone/compare (une vente n'est pas une population), ni critère de classement.

Ce qu'ils ont à dépenser — le potentiel

Le bloc potentiel_depense donne les unités de consommation reconstituées de la zone, le revenu disponible estimé de ses habitants (revenu_disponible_estime, en euros par an) et le même montant par ménage (revenu_disponible_par_menage, le chiffre à lire pour juger une zone d'un coup d'œil). Si vous passez un coefficient — la part du revenu disponible que votre secteur capte, entre 0 et 1 —, potentiel_theorique vaut ce revenu multiplié par votre coefficient. Sans coefficient, il vaut null et les autres champs sont rendus quand même.

Le calcul, pour que vous puissiez le refaire : le carroyage donne la somme des niveaux de vie des habitants, pas leur revenu — le niveau de vie est le revenu du ménage divisé par ses unités de consommation, attribué à chacun de ses membres. Nous reconstituons donc les unités de consommation de la zone (1 par ménage, 0,5 par autre personne de 14 ans et plus, 0,3 par enfant de moins de 14 ans) et multiplions le niveau de vie moyen par ce nombre. Sommer les niveaux de vie sans cette étape aurait surestimé la masse de revenu d'environ 40 % sur cet exemple (de moitié à l'échelle nationale).

Quel coefficient passer

Le coefficient est votre hypothèse, pas une donnée TrustyData. Pour un point de départ, le tableau ci-dessous part de la structure nationale de la dépense des ménages par fonction de consommation — INSEE, comptes nationaux annuels (base 2020), « Consommation des ménages en 2024 », fichier T_CONSO_EFF_FONCTION.xlsx — et la ramène au revenu disponible en retirant l'épargne (taux d'épargne des ménages 2024 : 18,2 %, Insee Première n° 2056, « La consommation des ménages en 2024 », juin 2025). Relevé le 13 septembre 2026 sur insee.fr/fr/statistiques/8574673 et insee.fr/fr/statistiques/8582021. Les coefficients sont calculés sur les parts avant arrondi ; recalculés depuis la colonne affichée, deux d'entre eux diffèrent d'un millième. Un réseau qui connaît la structure de dépense de sa propre clientèle doit lui préférer la sienne.

Fonction de consommation (INSEE)	Part de la consommation	Coefficient à passer
Produits alimentaires et boissons non alcoolisées	12,3 %	0,100
Boissons alcoolisées, tabac et stupéfiants	3,3 %	0,027
Articles d'habillement et chaussures	2,9 %	0,024
Logement, eau, gaz, électricité et autres combustibles	27,8 %	0,227
Meubles, articles de ménage et entretien courant du foyer	3,8 %	0,031
Santé	3,8 %	0,031
Transports	12,7 %	0,104
Information et communication	3,6 %	0,030
Loisirs, sport et culture	7,1 %	0,058
Services de l'enseignement	0,7 %	0,006
Restaurants et services d'hébergement	8,6 %	0,070
Assurance et services financiers	8,2 %	0,067
Soins corporels, protection sociale et biens et services divers	6,2 %	0,051

Chaque fonction se déplie ci-dessous en ses sous-fonctions et ses postes, avec le code de la nomenclature INSEE : plus la ligne est fine, plus le coefficient est spécifique à votre activité — un restaurateur prendra « Restaurants, cafés et similaires » (CP1111, 0,048) plutôt que la fonction entière, qui inclut les cantines et l'hébergement. Les postes d'une fonction somment à cette fonction. Mêmes sources et même calcul que le tableau ; ces lignes sont générées depuis le fichier INSEE par tools/coefficients-insee.py et se régénèrent à chaque millésime.

Produits alimentaires et boissons non alcoolisées — 0,100

Code INSEE	Poste	Part de la consommation	Coefficient à passer
CP011	Produits alimentaires	11,24 %	0,092
CP0111	Céréales et produits à base de céréales	2,27 %	0,019
CP0112	Animaux vivants, viandes et autres parties d’animaux terrestres abattus	2,18 %	0,018
CP0113	Poisson et autres fruits de mer	0,48 %	0,004
CP0114	Lait, produits laitiers divers et œufs	1,63 %	0,013
CP0115	Huiles et graisses	0,28 %	0,002
CP0116	Fruits et fruits à coque	0,80 %	0,007
CP0117	Légumes, tubercules, bananes plantains, bananes de cuisine et légumes secs	1,33 %	0,011
CP0118	Sucre, confiserie et desserts	0,92 %	0,008
CP0119	Plats préparés et autres produits alimentaires	1,34 %	0,011
CP012	Boissons non alcoolisées	1,04 %	0,008
CP0121	Jus de fruits et de légumes	0,18 %	0,002
CP0122	Café et succédanés de café	0,32 %	0,003
CP0123	Thé, maté et autres produits d’origine végétale pour tisanes	0,05 %	0,000
CP0125	Eau	0,17 %	0,001
CP0126	Boissons rafraîchissantes	0,20 %	0,002
CP0129	Autres boissons non alcoolisées	0,12 %	0,001

Boissons alcoolisées, tabac et stupéfiants — 0,027

Code INSEE	Poste	Part de la consommation	Coefficient à passer
CP021	Boissons alcoolisées	1,40 %	0,011
CP0211	Spiritueux et liqueurs	0,36 %	0,003
CP0212	Vin	0,67 %	0,005
CP0213	Bière	0,35 %	0,003
CP0219	Autres boissons alcoolisées	0,02 %	0,000
CP023	Tabac	1,59 %	0,013
CP024	Stupéfiants	0,36 %	0,003

Articles d’habillement et chaussures — 0,024

Code INSEE	Poste	Part de la consommation	Coefficient à passer
CP031	Articles d’habillement	2,42 %	0,020
CP0311	Tissus pour habillement	0,01 %	0,000
CP0312	Vêtements	2,12 %	0,017
CP0313	Autres articles et accessoires d’habillement	0,25 %	0,002
CP0314	Nettoyage, réparation, confection et location d’articles d’habillement	0,04 %	0,000
CP032	Chaussures	0,49 %	0,004
CP0321	Chaussures diverses	0,48 %	0,004
CP0322	Nettoyage, réparation et location de chaussures	0,01 %	0,000

Logement, eau, gaz, électricité et autres combustibles — 0,227

Code INSEE	Poste	Part de la consommation	Coefficient à passer
CP041	Loyers d’habitation effectivement payés	5,04 %	0,041
CP0411	Loyers effectivement payés par les locataires pour des résidences principales	4,99 %	0,041
CP0412	Autres loyers effectifs	0,05 %	0,000
CP042	Loyers d’habitation imputés	14,45 %	0,118
CP0421	Loyers imputés des propriétaires-occupants pour leur résidence principale	12,70 %	0,104
CP0422	Autres loyers imputés	1,75 %	0,014
CP043	Entretien, réparation et sécurité des logements	2,18 %	0,018
CP0431	Équipement de sécurité et fournitures pour travaux d’entretien et de réparation des logements	0,19 %	0,002
CP0432	Services concernant l’entretien, les réparations et la sécurité du logement	1,99 %	0,016
CP044	Alimentation en eau et services divers liés au logement	1,65 %	0,014
CP0441	Alimentation en eau	0,33 %	0,003
CP0442	Collecte des ordures ménagères	0,39 %	0,003
CP0443	Reprise des eaux usées	0,48 %	0,004
CP0444	Services divers liés au logement	0,45 %	0,004
CP045	Électricité, gaz et autres combustibles	4,48 %	0,037
CP0451	Électricité	2,74 %	0,022
CP0452	Gaz	1,10 %	0,009
CP0453	Combustibles liquides	0,21 %	0,002
CP0454	Combustibles solides	0,25 %	0,002
CP0455	Autres sources d’énergie pour les systèmes de chauffage et de refroidissement	0,18 %	0,002

Meubles, articles de ménage et entretien courant du foyer — 0,031

Code INSEE	Poste	Part de la consommation	Coefficient à passer
CP051	Meubles, articles d’ameublement et tapis	1,15 %	0,009
CP0511	Meubles, articles d’ameublement et tapis	1,06 %	0,009
CP0512	Réparation, installation et location de meubles, d’articles d’ameublement et de tapis	0,09 %	0,001
CP052	Articles de ménage en textiles	0,18 %	0,001
CP0521	Articles de ménage en textiles	0,13 %	0,001
CP0522	Réparation, location et confection d’articles de ménage en textiles	0,05 %	0,000
CP053	Appareils ménagers	0,80 %	0,007
CP0531	Gros appareils ménagers, électriques ou autres	0,59 %	0,005
CP0532	Petits appareils ménagers	0,15 %	0,001
CP0533	Réparation, installation et location d’appareils ménagers	0,06 %	0,000
CP054	Verrerie, vaisselle et ustensiles de ménage	0,32 %	0,003
CP055	Outillage et matériel pour la maison et le jardin	0,31 %	0,003
CP0551	Outillage et matériel motorisés	0,10 %	0,001
CP0552	Outillage non motorisé et accessoires divers	0,15 %	0,001
CP0553	Réparation et location d’outillage et de matériel motorisés et non motorisés	0,06 %	0,000
CP056	Biens et services liés à l’entretien courant du foyer	1,03 %	0,008
CP0561	Articles de ménage non durables	0,80 %	0,007
CP0562	Services domestiques et services ménagers	0,23 %	0,002

Santé — 0,031

Code INSEE	Poste	Part de la consommation	Coefficient à passer
CP061	Médicaments et produits de santé	1,44 %	0,012
CP062	Services de soins ambulatoires	1,69 %	0,014
CP063	Services de soins hospitaliers	0,41 %	0,003
CP064	Autres services de santé	0,29 %	0,002

Transports — 0,104

Code INSEE	Poste	Part de la consommation	Coefficient à passer
CP071	Achats de véhicules	2,66 %	0,022
CP0711	Voitures automobiles	2,33 %	0,019
CP0712	Motocycles	0,21 %	0,002
CP0713	Bicyclettes	0,12 %	0,001
CP072	Dépenses d’utilisation des véhicules	7,47 %	0,061
CP0721	Pièces et accessoires pour véhicules personnels	2,28 %	0,019
CP0722	Carburants et lubrifiants pour véhicules personnels	3,45 %	0,028
CP0723	Entretien et réparation de véhicules personnels	0,43 %	0,004
CP0724	Services divers relatifs aux véhicules personnels	1,31 %	0,011
CP073	Services de transport de voyageurs	2,36 %	0,019
CP0731	Transport de voyageurs par chemin de fer	0,56 %	0,005
CP0732	Transport de voyageurs par route	0,55 %	0,005
CP0733	Transport de voyageurs par air	1,03 %	0,008
CP0734	Transport de voyageurs par mer et voies navigables intérieures	0,04 %	0,000
CP0735	Transport combiné de voyageurs	0,19 %	0,002
CP074	Services de transport de marchandises	0,22 %	0,002
CP0741	Services postaux et de coursiers	0,12 %	0,001
CP0749	Autres transports de marchandises	0,10 %	0,001

Information et communication — 0,030

Code INSEE	Poste	Part de la consommation	Coefficient à passer
CP081	Matériel d’information et de communication	0,93 %	0,008
CP082	Logiciels, à l’exclusion des jeux	0,02 %	0,000
CP083	Services d’information et de communication	2,66 %	0,022

Loisirs, sport et culture — 0,058

Code INSEE	Poste	Part de la consommation	Coefficient à passer
CP091	Biens durables à fonction récréative	0,57 %	0,005
CP0911	Matériel photographique et cinématographique et appareils optiques	0,04 %	0,000
CP0912	Gros biens durables à fonction récréative	0,53 %	0,004
CP092	Autres biens à fonction récréative	1,08 %	0,009
CP0921	Jeux, jouets et articles de loisirs	0,55 %	0,004
CP0922	Articles de sport, matériel de camping et matériel pour activités de plein air	0,53 %	0,004
CP093	Produits de jardinage et animaux de compagnie	0,85 %	0,007
CP0931	Produits de jardinage, plantes et fleurs	0,33 %	0,003
CP0932	Animaux de compagnie et produits pour animaux de compagnie	0,53 %	0,004
CP094	Services récréatifs	2,55 %	0,021
CP0941	Location et réparation de matériel photographique et cinématographique et d’appareils optiques	0,01 %	0,000
CP0942	Location, entretien et réparation de gros biens durables à fonction récréative	0,09 %	0,001
CP0943	Location et réparation de jeux, de jouets et d’articles de loisirs	0,07 %	0,001
CP0944	Location et réparation d’articles de sport, de matériel de camping et de matériel pour activités de plein air	0,05 %	0,000
CP0945	Services vétérinaires et autres pour animaux de compagnie	0,39 %	0,003
CP0946	Services récréatifs et sportifs	0,98 %	0,008
CP0947	Jeux de hasard	0,94 %	0,008
CP095	Biens culturels	0,05 %	0,000
CP0951	Instruments de musique	0,02 %	0,000
CP0952	Médias audiovisuels	0,03 %	0,000
CP096	Services culturels	0,86 %	0,007
CP0961	Services fournis par les cinémas, les théâtres et les salles de concert	0,64 %	0,005
CP0962	Services fournis par les musées, les bibliothèques et les sites culturels	0,09 %	0,001
CP0963	Services photographiques	0,10 %	0,001
CP0969	Autres services culturels	0,03 %	0,000
CP097	Journaux, livres et articles de papeterie	0,73 %	0,006
CP0971	Livres	0,29 %	0,002
CP0972	Journaux et périodiques	0,27 %	0,002
CP0973	Imprimés divers	0,05 %	0,000
CP0974	Articles de papeterie et matériel de dessin	0,11 %	0,001
CP098	Forfaits touristiques	0,41 %	0,003

Services de l’enseignement — 0,006

Code INSEE	Poste	Part de la consommation	Coefficient à passer
CP101	Éducation des jeunes enfants et enseignement primaire	0,05 %	0,000
CP102	Enseignement secondaire	0,06 %	0,000
CP103	Enseignement postsecondaire non supérieur	0,01 %	0,000
CP104	Enseignement supérieur	0,28 %	0,002
CP105	Enseignement non défini par niveau	0,35 %	0,003

Restaurants et services d’hébergement — 0,070

Code INSEE	Poste	Part de la consommation	Coefficient à passer
CP111	Services de restauration et de débits de boissons	6,66 %	0,054
CP1111	Restaurants, cafés et similaires	5,85 %	0,048
CP1112	Cantines, cafétérias et réfectoires	0,80 %	0,007
CP112	Services d’hébergement	1,92 %	0,016

Assurance et services financiers — 0,067

Code INSEE	Poste	Part de la consommation	Coefficient à passer
CP121	Assurance	5,07 %	0,041
CP1211	Assurance-vie et assurance accidents	2,46 %	0,020
CP1212	Assurance liée à la santé	1,11 %	0,009
CP1213	Assurance liée aux logements	0,56 %	0,005
CP1214	Assurance liée aux transports	0,73 %	0,006
CP1219	Autres assurances	0,21 %	0,002
CP122	Services financiers	3,10 %	0,025

Soins corporels, protection sociale et biens et services divers — 0,051

Code INSEE	Poste	Part de la consommation	Coefficient à passer
CP131	Soins corporels	2,36 %	0,019
CP1311	Appareils électriques pour soins corporels	0,06 %	0,001
CP1312	Autres appareils, articles et produits pour soins corporels	1,28 %	0,010
CP1313	Salons de coiffure et instituts de soins et de beauté	1,02 %	0,008
CP132	Autres effets personnels	1,06 %	0,009
CP1321	Articles de bijouterie et montres	0,62 %	0,005
CP1329	Autres effets personnels n.c.a.	0,43 %	0,004
CP133	Protection sociale	1,50 %	0,012
CP139	Autres services	1,29 %	0,011

Ces treize parts somment à 101,1 % de la dépense de consommation des ménages ; un solde territorial négatif (les achats des résidents à l'étranger, moins ceux des non-résidents en France) ramène le total à 100 % et n'a pas de coefficient à en tirer, donc il ne figure pas dans le tableau. Deux lignes méritent une nuance : « Logement, eau, gaz, électricité et autres combustibles » inclut les loyers imputés des propriétaires occupants — une convention comptable, pas une dépense réellement payée — pour plus de la moitié de son poids ; « Assurance et services financiers » inclut les services d'intermédiation financière indirectement mesurés (SIFIM), une estimation comptable elle aussi. Un commerce de détail regardera surtout l'alimentation, les boissons et le tabac, l'habillement, le mobilier et l'entretien du foyer, les transports, les loisirs et la culture, la restauration et l'hébergement, et les soins et services divers.

Exemple : ouvrir un restaurant à Lyon

Vous cherchez un emplacement à Lyon et voulez savoir ce que les habitants à quinze minutes en voiture dépensent en restaurants et cafés. La fonction « Restaurants et services d'hébergement » vaut 0,070, mais elle inclut l'hôtellerie et les cantines ; la ligne qui correspond à votre activité est « Restaurants, cafés et similaires » (CP1111) : 89 429 millions d'euros sur 1 527 515 de dépense de consommation en 2024, soit 5,85 %, et 0,048 du revenu disponible une fois l'épargne retirée. Le même appel que plus haut, avec ce coefficient :

curl -X POST "https://api.trustydata.app/services/v1/zone/stats" \
  -H "Authorization: Bearer VOTRE_CLE_API" -H "Content-Type: application/json" \
  -d '{"adresse": "Lyon", "duree": 15, "mode": "auto", "reference": "departement", "coefficient": 0.048}'

"potentiel_depense": {
  "unites_consommation": 525972,
  "revenu_disponible_estime": 14450034991,
  "revenu_disponible_par_menage": 39882,
  "coefficient": 0.048,
  "potentiel_theorique": 693601689
}

Trois lectures du même chiffre, toutes calculables depuis les champs de la réponse (population 737 118, menages 362 321) :

• La zone entière : potentiel_theorique, 693 601 689 € par an, soit environ 694 millions d'euros que les habitants de la zone consacrent chaque année aux restaurants et cafés.
• Par ménage et par mois : revenu_disponible_par_menage × 0,048 ÷ 12 = 39 882 × 0,048 ÷ 12 ≈ 160 € (1 914 € par an).
• Par habitant et par mois : revenu_disponible_estime ÷ population × 0,048 ÷ 12 = 19 603 × 0,048 ÷ 12 ≈ 78 € (941 € par an, enfants compris).

Hypothèses et limites

1. Les unités de consommation sont reconstituées. Le carroyage ne les donne pas ; nous appliquons l'échelle dite OCDE modifiée, celle de l'INSEE, à partir des ménages et des tranches d'âge, avec deux hypothèses : un premier adulte par ménage, et trois septièmes de la tranche 11-17 ans comptés comme enfants de moins de 14 ans.
2. Le niveau de vie est écrêté. L'INSEE ramène les très hauts et très bas niveaux de vie à un plancher et un plafond avant de les sommer : les quartiers les plus aisés sont sous-estimés, et nous ne corrigeons pas cet écrêtage.
3. Les revenus sont ceux de 2021, sans réévaluation de l'inflation depuis. Le millésime est dans source.
4. Les carreaux imputés au titre du secret statistique pèsent dans ce bloc comme dans les autres — carreaux.estimes dit combien.
5. Seuls les ménages ordinaires comptent : les personnes en communauté (résidences étudiantes, maisons de retraite, foyers) ne sont pas dans Filosofi.
6. Le potentiel théorique n'est pas une prévision de chiffre d'affaires. Une partie des dépenses des habitants se fait hors de la zone, en ligne ou ailleurs, et la zone reçoit des clients qui n'y habitent pas. C'est une masse théorique à comparer entre zones, pas un chiffre à mettre dans un compte de résultat.
7. Le coefficient est votre choix. La table ci-dessus est un repère national ; l'API renvoie le coefficient reçu tel quel et ne le corrige jamais.
8. Comportement null. Sans coefficient, coefficient et potentiel_theorique valent null. Sur une zone vide, les masses valent 0 et le montant par ménage null. Si le millésime chargé ne portait pas les tranches d'âge, tout le bloc vaudrait null plutôt que de compter zéro enfant.

Ce qui est déjà installé — les activités

Les blocs précédents décrivent les habitants de la zone. Le bloc activites décrit ce qui y est déjà installé : le nombre d'établissements SIRENE de la zone, rangés en 14 familles d'activité et 160 sous-familles, avec pour chaque poste une densite pour 10 000 habitants et un indice qui la compare à un territoire de référence. « 796 boulangeries-pâtisseries, soit 10,8 pour 10 000 habitants, indice 118 » : la zone en compte 18 % de plus par habitant que son département.

"activites": {
  "source": "SIRENE (INSEE), établissements actifs géolocalisés",
  "total": 222612,
  "reference": { "niveau": "departement", "code": "69", "libelle": "Rhône" },
  "fiabilite": { "taux_localisation": 82.2, "etablissements_min": 5, "indices_fiables": true },
  "familles": [
    { "cle": "commerce_detail_alimentaire", "libelle": "Commerce de détail alimentaire",
      "etablissements": 3124, "part": 1.4,
      "densite": 42.4, "reference_densite": 36.6, "indice": 116,
      "sous_familles": [
        { "cle": "alimentation_generale_et_superette", "libelle": "Alimentation générale, supérette",
          "etablissements": 813, "part": 0.4,
          "densite": 11.0, "reference_densite": 7.9, "indice": 140 },
        { "cle": "boulangerie_patisserie", "libelle": "Boulangerie, pâtisserie",
          "etablissements": 796, "part": 0.4,
          "densite": 10.8, "reference_densite": 9.1, "indice": 118 },
        { "...": "huit autres, effectifs décroissants, jusqu'à poissonnerie : 18" }
      ] },
    { "...": "les familles 2 à 11" },
    { "cle": "agriculture", "libelle": "Agriculture, sylviculture, pêche",
      "etablissements": 379, "part": 0.2,
      "densite": 5.1, "reference_densite": 48.8, "indice": 11,
      "sous_familles": [
        { "...": "neuf autres" },
        { "cle": "peche_chasse_et_aquaculture", "libelle": "Pêche, chasse, aquaculture",
          "etablissements": 3, "part": 0.0,
          "densite": 0.0, "reference_densite": 0.1, "indice": null }
      ] },
    { "...": "les familles 13 et 14" }
  ]
}

La forme est la même à tous les niveaux : cle, l'identifiant stable du poste — c'est lui qu'on stocke, jamais le libellé —, libelle, son nom public, etablissements, part en pourcentage de total au dixième, densite pour 10 000 habitants de la zone, reference_densite, la même densité sur le territoire de référence, et indice : 100 × densite / reference_densite, à l'entier. 100 est la référence. Chaque code NAF tombant dans exactement un poste, les sous-familles somment à leur famille et les familles à total. Les familles sortent toujours dans le même ordre, celui de l'exemple ; les sous-familles d'une famille sont triées par effectif décroissant.

Lisez la peche_chasse_et_aquaculture de l'exemple : trois établissements, une densité servie — 0.0, parce que trois établissements pour 737 118 habitants arrondissent à zéro au dixième —, et indice: null. Sous fiabilite.etablissements_min établissements dans le poste, l'indice n'est pas rendu : un rapport de densités sur trois établissements dirait surtout du bruit. Il vaut null dans deux autres cas — une zone sans habitant, et une référence qui n'a rien à comparer : soit qu'elle n'ait aucun établissement dans ce poste, et sa reference_densite vaut alors 0.0 au niveau d'une sous-famille et null au niveau d'une famille, soit qu'aucune population de référence ne soit connue, et elle vaut null.

La densité est servie dès que la zone a des habitants : ce n'est qu'une division, et elle tient même quand l'indice ne tient pas. Sur une zone sans habitant — la mer, l'étranger, un isochrone sans contour —, elle vaut null comme l'indice ; etablissements et part, eux, restent servis. Enfin fiabilite.indices_fiables passe à false sous 1 000 habitants dans la zone : le dénominateur des densités est alors trop petit pour qu'elles se citent, même seuil et même sens que csp.fiabilite.

Les 14 familles sont toujours présentes, même à zéro : le premier niveau de la réponse ne change pas d'une zone à l'autre, et un graphique construit dessus n'a pas de trou. Les sous-familles à zéro, elles, sont omises — une zone rurale ne traîne pas 160 lignes vides, ce qui compte d'autant plus sur /zone/compare, où le bloc est rendu jusqu'à dix fois.

L'indice est plus solide que l'effectif

Puisque le comptage est un plancher, on pourrait croire tout le bloc inutilisable. C'est vrai de l'effectif brut, beaucoup moins de l'indice. La densité de la zone et celle de la référence sont calculées de la même façon, sur le même périmètre : les mêmes établissements manquent des deux côtés, et le sous-compte s'annule en grande partie dans leur rapport. Un indice de 116 sur le commerce alimentaire reste lisible là où « 3 124 établissements » demande d'être présenté comme un minimum.

La règle pratique tient en une ligne : comparez avec les indices, dénombrez avec les effectifs — et dites alors que c'est un plancher. L'annulation n'est pas parfaite : elle suppose que la part d'établissements géolocalisés ne varie pas trop entre la zone et sa référence. Elle varie surtout entre urbain et rural, ce qui est exactement la raison pour laquelle le taux servi est celui du département et non le national.

Hypothèses et limites

La grille est exhaustive — chacune des 732 sous-classes de la NAF rév. 2 tombe dans un poste et un seul, sans trou ni double compte. Le comptage, lui, ne l'est pas, et la nomenclature elle-même impose des lectures qu'il vaut mieux connaître avant de citer un chiffre.

1. Un établissement n'est pas un point de vente. SIRENE enregistre des établissements : un siège social, un entrepôt, un bureau, une adresse de domiciliation en sont, une vitrine aussi. Le bloc dit ce qui est immatriculé à une adresse, pas ce qu'un passant voit dans la rue.
2. La densité est rapportée aux habitants, pas aux passants. Le dénominateur est la population Filosofi de la zone, c'est-à-dire les personnes qui y résident. Une zone d'activité, un quartier de bureaux ou un centre-ville très commerçant mais peu habité rendent des densités très élevées qui ne disent rien d'une saturation : la clientèle y vient d'ailleurs. Lisez alors les effectifs et les parts plutôt que les densités.
3. Le tabac est sous-compté. Le code 47.26Z ne couvre que le commerce de détail spécialisé de produits à base de tabac. Un bar-tabac, qui est le cas le plus courant, est déclaré en débit de boissons (56.30Z) et reste dans la famille « Cafés, hôtels, restaurants ». La sous-famille « Tabac » ne compte donc qu'une partie des points de vente de tabac.
4. La boulangerie est en deux codes, réunis ; l'usine est ailleurs. 10.71C (boulangerie et boulangerie-pâtisserie) et 47.24Z (commerce de détail de pain et de pâtisserie en magasin spécialisé) désignent le même commerce de rue selon la façon dont il s'est déclaré : ils sont dans la même sous-famille. 10.71A, la fabrication industrielle de pain et de pâtisserie fraîche, part en « Industrie et production » — un boulanger compte les boutiques de sa rue, pas l'usine de la zone industrielle.
5. « Rééducation, appareillage et pédicures-podologues » mêle trois métiers. Le code 86.90E les réunit et la NAF ne permet pas de les séparer : la sous-famille porte donc le nom entier. N'en déduisez aucun des trois isolément — ni le nombre de cabinets de rééducation, ni celui de pédicures.
6. « Commerce de détail non alimentaire » n'est pas fait que de boutiques. La sous-famille « Vente à distance et hors magasin » pèse 50,8 % de la famille à elle seule — 598 476 établissements actifs sur 1 178 430 au national, dont 277 682 pour la seule vente à domicile (47.99A). Lue au niveau de la famille, cette ligne se comprend comme des magasins, et c'est largement faux : descendez aux sous-familles, où la vente à distance est isolée.
7. « Sociétés civiles immobilières et location de biens » porte aussi les marchands de biens. Le poste réunit la location de logements et de terrains, les supports juridiques de gestion de patrimoine immobilier — les SCI, très nombreuses et sans vitrine — et, pour environ 1,5 % de son effectif, les marchands de biens immobiliers (68.10Z). Les SCI sont nommées plutôt que cachées : sans cela, elles gonfleraient silencieusement la famille « Banque, assurance, immobilier ».
8. Quatre postes contiennent un code minoritaire que leur libellé ne couvre pas, chacun sous 15 % de son effectif : 45.32Z (commerce de détail d'équipements automobiles) sous « Commerce de véhicules et de deux-roues » ; 88.99A (autre accueil sans hébergement d'enfants et d'adolescents) sous « Crèche, accueil de jeunes enfants » ; 55.90Z (autres hébergements) sous « Hébergement touristique de courte durée » ; 86.90C (centres de collecte et banques d'organes) sous « Laboratoire d'analyses médicales ». La grille complète plus bas dit, poste par poste, exactement ce que chacun contient.
9. L'activité est celle déclarée, au code APE. L'INSEE attribue un code APE à partir de la déclaration de l'entreprise. Il peut dater d'avant un changement d'activité, et un établissement qui fait deux métiers n'en porte qu'un seul. Le comptage hérite de ces approximations.
10. Un établissement est dans la zone si son point y est. Pas de pondération de surface ici, contrairement aux carreaux de population : c'est un point dans un contour, oui ou non. Un établissement géolocalisé à la voie ou au lieu-dit plutôt qu'au numéro peut donc tomber du mauvais côté d'une limite.
11. Ce que le bloc ne rend pas. Ni la liste des établissements ni leurs SIRET — pour cela, la recherche d'entreprises a son propre guide —, ni leurs effectifs salariés, ni leur chiffre d'affaires, ni les codes NAF dans la réponse : ils ne varient jamais d'une zone à l'autre, leur place est la grille ci-dessous. Sur /zone/compare, exclusif et chevauchements ne portent pas d'établissements non plus : population, ménages et potentiel seulement.

La grille, code NAF par code NAF

Chaque famille se déplie ci-dessous en ses sous-familles, et chaque sous-famille en les codes NAF qui la composent, avec le libellé abrégé à 40 caractères publié par l'INSEE. C'est ici, et nulle part dans la réponse, que se vérifie ce qu'un poste contient réellement — avant de publier un chiffre sous le nom d'un métier, lisez la liste de son poste. Ces abréviations sont celles de la nomenclature (« Cult céréale, légumineuse, graine oléag. ») : ce sont des raccourcis, pas des définitions. Ces lignes sont générées depuis la grille versionnée par tools/activites-naf.py et se régénèrent quand elle bouge.

Commerce de détail alimentaire — 10 sous-familles, 18 codes NAF

Code NAF	Libellé INSEE abrégé
Boulangerie, pâtisserie — boulangerie_patisserie
10.71B	Cuisson de produits de boulangerie
10.71C	Boulangerie et boulangerie-pâtisserie
10.71D	Pâtisserie
47.24Z	Comm. dét. pain pâtiss. & confiser. (ms)
Boucherie, charcuterie — boucherie_charcuterie
10.13B	Charcuterie
47.22Z	Com. dét. viande & prdt avec viande (ms)
Poissonnerie — poissonnerie
47.23Z	Comm. détail poisson crustacé etc. (ms)
Primeur, fruits et légumes — primeur
47.21Z	Com. détail fruit & légume en mag. spéc.
Alimentation générale, supérette — alimentation_generale_et_superette
47.11A	Commerce de détail de produits surgelés
47.11B	Commerce d'alimentation générale
47.11C	Supérettes
47.11E	Magasins multi-commerces
Supermarché, hypermarché — supermarche_et_hypermarche
47.11D	Supermarchés
47.11F	Hypermarchés
Caviste, boissons — caviste_et_boissons
47.25Z	Com. détail boisson en magasin spéciali.
Tabac — tabac
47.26Z	Comm. dét. produit à base de tabac (ms)
Commerce alimentaire sur marchés — marche_alimentaire
47.81Z	Cd alimentaire sur éventaire & marché
Autre commerce alimentaire spécialisé — autre_commerce_alimentaire
47.29Z	Aut. com. détail alim. en mag. spéciali.

Commerce de détail non alimentaire — 15 sous-familles, 39 codes NAF

Code NAF	Libellé INSEE abrégé
Habillement, chaussure, maroquinerie — habillement_et_chaussure
47.51Z	Com. dét. textiles en magasin spécialisé
47.71Z	Com. dét. habillement en mag. spécialisé
47.72A	Commerce de détail de la chaussure
47.72B	Com. dét. maroquinerie & article voyage
Équipement de la maison, ameublement — equipement_de_la_maison
47.53Z	Cd tapis moquette & revêt. mur sol (ms)
47.54Z	Comm. dét. appareil électroménager (ms)
47.59A	Commerce de détail de meubles
47.59B	Comm. détail autres équipements du foyer
Bricolage, quincaillerie — bricolage_et_quincaillerie
47.52A	Com. dét. quinc. pein. etc. (mag.<400m2)
47.52B	Com. dét. quinc. pein. etc. (mag.>400m2)
Livres, presse, sport, jouets — culture_sport_et_loisirs
47.61Z	Comm. dét. livres en magasin spécialisé
47.62Z	Comm. détail journaux & papeterie (ms)
47.63Z	Com. dét. enreg. musicaux & vidéo (ms)
47.64Z	Com. dét. articles de sport en mag. spé.
47.65Z	Com. dét. jeux & jouets en mag. spécial.
Informatique, téléphonie, audiovisuel — informatique_et_telephonie
47.41Z	Com. dét ordi. un. périph. & logicl (ms)
47.42Z	Comm. dét. matériel télécom. (ms)
47.43Z	Comm. dét. matériels audio/vidéo (ms)
Parfumerie, produits de beauté — parfumerie_et_produits_de_beaute
47.75Z	Com. dét. parfumerie & prodt beauté (ms)
Bijouterie, horlogerie — bijouterie_et_horlogerie
47.77Z	Com. dét. art. horlogerie & bijout. (ms)
Optique, articles médicaux et orthopédiques — optique_et_articles_medicaux
47.74Z	Com. dét. art. médicaux & orthopéd. (ms)
47.78A	Commerces de détail d'optique
Fleuriste, jardinerie, animalerie — fleuriste_jardinerie_animalerie
47.76Z	Com. dét. fleur plante anim. cie + alim.
Commerce de véhicules et de deux-roues — commerce_automobile_et_deux_roues
45.11Z	Comm. de voiture & véhicule auto. léger
45.19Z	Commerce d'autres véhicules automobiles
45.32Z	Commerce de détail équipement automobile
45.40Z	Commerce et réparation de motocycles
Carburants, combustibles — carburants_et_combustibles
47.30Z	Comm. détail carburant en mag. spéciali.
47.78B	Comm. détail de charbons & combustibles
Grand magasin, commerce non spécialisé — grand_magasin_et_bazar
47.19A	Grands magasins
47.19B	Autres comm. détail en magasin non spéc.
Vente à distance et hors magasin — vente_a_distance_et_hors_magasin
47.91A	Vente à distance sur catalogue général
47.91B	Vente à distance sur catalogue spécialis
47.99A	Vente à domicile
47.99B	Vente par automate, aut. cd hors magasin
Commerce non alimentaire sur marchés — marche_non_alimentaire
47.82Z	Cd textiles habillt & chauss. s/marchés
47.89Z	Aut. com. dét. sur éventaires & marchés
Autre commerce de détail spécialisé — autre_commerce_specialise
47.78C	Autre commerce détail spécialisé divers
47.79Z	Comm. détail biens d'occasion en magasin

Cafés, hôtels, restaurants — 8 sous-familles, 11 codes NAF

Code NAF	Libellé INSEE abrégé
Restauration traditionnelle — restauration_traditionnelle
56.10A	Restauration traditionnelle
Restauration rapide, cafétéria — restauration_rapide
56.10B	Cafétérias et autres libres-services
56.10C	Restauration de type rapide
Traiteur — traiteur
56.21Z	Services des traiteurs
Restauration collective — restauration_collective
56.29A	Restauration collective sous contrat
56.29B	Autres services de restauration n.c.a.
Débit de boissons — debit_de_boissons
56.30Z	Débits de boissons
Hôtellerie — hotellerie
55.10Z	Hôtels et hébergement similaire
Hébergement touristique de courte durée — hebergement_touristique
55.20Z	Hébergt tourist. & aut. hbt courte durée
55.90Z	Autres hébergements
Camping, parc résidentiel de loisirs — camping
55.30Z	Terrain camping & parc pr caravane etc.

Services aux particuliers — 14 sous-familles, 37 codes NAF

Code NAF	Libellé INSEE abrégé
Coiffure — coiffure
96.02A	Coiffure
Soins de beauté, bien-être — soins_de_beaute_et_bien_etre
96.02B	Soins de beauté
96.04Z	Entretien corporel
Blanchisserie, pressing — blanchisserie_et_pressing
96.01A	Blanchisserie-teinturerie de gros
96.01B	Blanchisserie-teinturerie de détail
Services funéraires — services_funeraires
96.03Z	Services funéraires
Réparation de biens domestiques — reparation_de_biens_domestiques
95.11Z	Répar. ordinateur & équipt périphérique
95.12Z	Réparation équipements de communication
95.21Z	Réparation prdts électroniq. grd public
95.22Z	Répar. électromén. & éqpt maison & jard.
95.23Z	Réparation chaussures & articles en cuir
95.24Z	Réparation meubles & d'équipt du foyer
95.25Z	Répar.articles horlogerie & bijouterie
95.29Z	Répar. aut. biens personnel & domestique
Garage, réparation automobile, contrôle technique — garage_et_controle_technique
45.20A	Entretien & répar. véhicule auto. léger
45.20B	Entretien & répar. autre véhicule auto.
71.20A	Contrôle technique automobile
Auto-école — auto_ecole
85.53Z	Enseignement de la conduite
Enseignement sportif et culturel — enseignement_sportif_et_culturel
85.51Z	Enseigmnt discipl. sport. & act. loisir.
85.52Z	Enseignement culturel
Sport, remise en forme — sport_et_forme
93.11Z	Gestion d'installations sportives
93.12Z	Activités de clubs de sports
93.13Z	Activité des centres de culture physique
93.19Z	Autres activités liées au sport
Loisirs, attractions, jeux — loisirs_et_attractions
92.00Z	Organisation jeux de hasard & d'argent
93.21Z	Act. parcs attractions & parcs à thèmes
93.29Z	Autres activités récréative & de loisirs
Agence de voyage — agence_de_voyage
79.11Z	Activités des agences de voyage
79.12Z	Activités des voyagistes
79.90Z	Autre serv. réservation & activ. connexe
Location de véhicules et de biens personnels — location_de_vehicules_et_de_biens_personnels
77.11A	Loc. courte durée voit. & v. auto. léger
77.11B	Loc. longue durée voit. & v. auto. léger
77.21Z	Loc. & loc.-bail article loisir & sport
77.22Z	Location de vidéocassette & disque vidéo
77.29Z	Loc. & loc.-bail aut. bien perso. & dom.
Vétérinaire — veterinaire
75.00Z	Activités vétérinaires
Autres services personnels — autres_services_personnels
96.09Z	Autres services personnels n.c.a.

Santé et action sociale — 15 sous-familles, 29 codes NAF

Code NAF	Libellé INSEE abrégé
Médecin généraliste — medecin_generaliste
86.21Z	Activité des médecins généralistes
Médecin spécialiste — medecin_specialiste
86.22A	Act. radiodiagnostic et de radiothérapie
86.22B	Activités chirurgicales
86.22C	Autre activité des médecins spécialistes
Chirurgien-dentiste — dentiste
86.23Z	Pratique dentaire
Infirmier, sage-femme — infirmier_et_sage_femme
86.90D	Act. des infirmiers et des sages-femmes
Rééducation, appareillage et pédicures-podologues — reeducation_appareillage
86.90E	Act. rééduc. appareillag. & pédic.-podo.
Laboratoire d'analyses médicales — laboratoire_analyses_medicales
86.90B	Laboratoires d'analyses médicales
86.90C	Centres de collecte et banques d'organes
Ambulance — ambulance
86.90A	Ambulances
Autres activités de santé humaine — autres_activites_de_sante
86.90F	Activités de santé humaine nca.
Hôpital, clinique — hopital_et_clinique
86.10Z	Activités hospitalières
Pharmacie — pharmacie
47.73Z	Comm. dét. produits pharmaceutiques (ms)
Hébergement pour personnes âgées — hebergement_personnes_agees
87.10A	Hébergt médicalisé pour personnes âgées
87.30A	Hébergement social pour personnes âgées
Hébergement social et pour personnes handicapées — hebergement_social_et_handicap
87.10B	Hébergt médicalisé pr enfants handicapés
87.10C	Hébrgt médic. adul. hand. & aut. ht méd.
87.20A	Hébrgt soc. hand. mental & malade mental
87.20B	Hébergement social pour toxicomanes
87.30B	Hébergt social pour handicapés physiques
87.90A	Hébergt social pr enfants en difficultés
87.90B	Hébgt soc. adult., famille en difficulté
Aide à domicile, aide par le travail — aide_a_domicile
88.10A	Aide à domicile
88.10B	Accueil ss hbgt adult. hand., pers. âgée
88.10C	Aide par le travail
Crèche, accueil de jeunes enfants — accueil_de_jeunes_enfants
88.91A	Accueil de jeunes enfants
88.91B	Accueil sans hébergt d'enfant handicap
88.99A	Aut. accueil sans hébrgt enfants & ado.
Autre action sociale sans hébergement — autre_action_sociale
88.99B	Action sociale sans hébergement n.c.a.

Services aux entreprises — 17 sous-familles, 79 codes NAF

Code NAF	Libellé INSEE abrégé
Activités juridiques — activites_juridiques
69.10Z	Activités juridiques
Comptabilité, gestion — comptabilite_et_gestion
69.20Z	Activités comptables
Conseil pour les affaires et la gestion — conseil_de_gestion
70.22Z	Conseil pr affaire & aut. cons. gestion
Siège social — siege_social
70.10Z	Activités des sièges sociaux
Publicité, communication, études de marché — publicite_et_communication
70.21Z	Conseil en relation publique & communic.
73.11Z	Activités des agences de publicité
73.12Z	Régie publicitaire de médias
73.20Z	Études de marché et sondages
Architecture, ingénierie, études techniques — architecture_et_ingenierie
71.11Z	Activités d'architecture
71.12A	Activité des géomètres
71.12B	Ingénierie, études techniques
71.20B	Analyses, essais & inspection technique
74.90A	Activ des économistes de la construction
Recherche et développement — recherche_et_developpement
72.11Z	Recherche-développemnt en biotechnologie
72.19Z	R&D : aut. sciences physique & naturelle
72.20Z	R&D en sciences humaines et sociales
Design, photographie, traduction — design_photographie_traduction
74.10Z	Activités spécialisées de design
74.20Z	Activités photographiques
74.30Z	Traduction et interprétation
74.90B	Act. spéc. scientif. & techniq. diverses
Informatique, édition de logiciels, numérique — informatique_et_numerique
58.21Z	Édition de jeux électroniques
58.29A	Édition de logiciel système et de réseau
58.29B	Edit. logiciel outil dévelop. & langage
58.29C	Edition de logiciels applicatifs
62.01Z	Programmation informatique
62.02A	Conseil en système & logiciel informati.
62.02B	Tierce mainten. syst. & appli. nformati.
62.03Z	Gestion d'installations informatiques
62.09Z	Autres activités informatiques
63.11Z	Traitt donnée, hébergt & activ. connexe
63.12Z	Portails Internet
Télécommunications — telecommunications
61.10Z	Télécommunications filaires
61.20Z	Télécommunications sans fil
61.30Z	Télécommunications par satellite
61.90Z	Autres activités de télécommunication
Édition, médias, audiovisuel — edition_medias_et_audiovisuel
58.11Z	Édition de livres
58.12Z	Édition répertoires & fichiers d'adresse
58.13Z	Édition de journaux
58.14Z	Édition de revues et périodiques
58.19Z	Autres activités d'édition
59.11A	Prod. film & progm. pour la télévision
59.11B	Prod. film institutionnel & publicitaire
59.11C	Production de films pour le cinéma
59.12Z	Post-production film & prog. télévision
59.13A	Distribution de films cinématographiques
59.13B	Edition et distribution vidéo
59.20Z	Enregistrement sonore & édition musicale
60.10Z	Édition et diffusion de programmes radio
60.20A	Edition de chaînes généralistes
60.20B	Edition de chaînes thématiques
63.91Z	Activités des agences de presse
63.99Z	Autres services d'information n.c.a.
Intérim, recrutement — interim_et_recrutement
78.10Z	Activ. agence placement de main-d'oeuvre
78.20Z	Activ. des agences de travail temporaire
78.30Z	Aut. mise à dispo. de ressource humaine
Sécurité privée — securite_privee
80.10Z	Activités de sécurité privée
80.20Z	Activités liées aux systèmes de sécurité
80.30Z	Activités d'enquête
Nettoyage, propreté — nettoyage_et_proprete
81.10Z	Act. combinée soutien lié aux bâtiments
81.21Z	Nettoyage courant des bâtiments
81.22Z	Aut. act. nettoyage bâtim. & nett. ind.
81.29A	Désinfection désinsectisatn dératisation
81.29B	Autres activités de nettoyage n.c.a.
Aménagement paysager — amenagement_paysager
81.30Z	Services d'aménagement paysager
Services administratifs et soutien aux entreprises — services_administratifs_et_soutien
82.11Z	Services admin. combinés de bureau
82.19Z	Photocopie & aut. act. spé. sout. bureau
82.20Z	Activités de centres d'appels
82.30Z	Organisation salon profession. & congrès
82.91Z	Act. recouv. fac. & info. fin. s/client.
82.92Z	Activités de conditionnement
82.99Z	Autre activité de soutien aux entr. nca.
Location de matériel professionnel — location_de_materiel_professionnel
77.12Z	Location et location-bail de camions
77.31Z	Loc. & loc.-bail machine & éqpt agricole
77.32Z	Loc. & loc.-bail mach. & éqpt pr constr.
77.33Z	Loc. & loc.-bail mach. bur. & mat. info.
77.34Z	Loc. & loc.-bail mat. transport par eau
77.35Z	Loc. & loc.-bail mat. transport aérien
77.39Z	Loc. & loc.-bail mach., éqpt & bien div.
77.40Z	Loc-bail propr. intel., sf oeuvre avec ©

Banque, assurance, immobilier — 8 sous-familles, 25 codes NAF

Code NAF	Libellé INSEE abrégé
Banque, crédit — banque_et_credit
64.11Z	Activités de banque centrale
64.19Z	Autres intermédiations monétaires
64.91Z	Crédit-bail
64.92Z	Autre distribution de crédit
64.99Z	Aut. act. finan. hs as. & c. retra. nca.
Holding, gestion de fonds — holding_et_gestion_de_fonds
64.20Z	Activités des sociétés holding
64.30Z	Fonds placement & entité financ. simil.
66.19A	Support juridiq. gest. patrimoine mobil.
66.30Z	Gestion de fonds
Assurance — assurance
65.11Z	Assurance vie
65.12Z	Autres assurances
65.20Z	Réassurance
65.30Z	Caisses de retraite
Courtage et agents d'assurance — courtage_en_assurance
66.21Z	Évaluation des risques et dommages
66.22Z	Act. des agents & courtiers d'assurances
66.29Z	Aut. act. aux. assur. & caisse retraite
Services financiers auxiliaires — services_financiers_auxiliaires
66.11Z	Administration de marchés financiers
66.12Z	Courtage valeur mobilière & marchandise
66.19B	Aut. aux. sce financ. hs ass. retr. nca.
Agence immobilière — agence_immobiliere
68.31Z	Agences immobilières
Administration de biens immobiliers — administration_de_biens
68.32A	Administrat. immeuble & autre bien immo.
Sociétés civiles immobilières et location de biens — societes_civiles_immobilieres
68.10Z	Activité marchands de biens immobiliers
68.20A	Location de logements
68.20B	Location terrain & autre bien immobilier
68.32B	Support juridi. gestion patrimoine immo.

Construction et artisanat du bâtiment — 13 sous-familles, 38 codes NAF

Code NAF	Libellé INSEE abrégé
Promotion immobilière — promotion_immobiliere
41.10A	Promotion immobilière de logements
41.10B	Promotion immobilière de bureaux
41.10C	Promotion immobilière d'autres bâtiments
41.10D	Supports juridiques de programmes
Construction de bâtiments — construction_de_batiments
41.20A	Construction de maisons individuelles
41.20B	Construction d'autres bâtiments
Travaux publics, génie civil — travaux_publics_et_genie_civil
42.11Z	Construction de routes et autoroutes
42.12Z	Const. voie ferrée surface & souterraine
42.13A	Construction d'ouvrages d'art
42.13B	Construction et entretien de tunnels
42.21Z	Construction de réseaux pour fluides
42.22Z	Const. réseaux électriq. & de télécom.
42.91Z	Construc. ouvrages maritimes et fluviaux
42.99Z	Constr. aut. ouvrage de génie civil nca.
Démolition, terrassement, forage — demolition_et_terrassement
43.11Z	Travaux de démolition
43.12A	Travaux de terrassement courants
43.12B	Travaux de terrassement spécialisés
43.13Z	Forages et sondages
Installation électrique — installation_electrique
43.21A	Travaux instal. électriq. ds tous locaux
43.21B	Travaux instal. électriq. sr voie publi.
Plomberie, chauffage, climatisation — plomberie_et_chauffage
43.22A	Travaux instal. eau & gaz en tous locaux
43.22B	Travaux instal. équipt thermique & clim.
Isolation, plâtrerie — isolation_et_platrerie
43.29A	Travaux d'isolation
43.31Z	Travaux de plâtrerie
Menuiserie, serrurerie, agencement — menuiserie_et_serrurerie
43.32A	Travaux de menuiserie bois et PVC
43.32B	Travaux menuiserie métal. & serrurerie
43.32C	Agencement de lieux de vente
Revêtement des sols et des murs — revetement_sols_et_murs
43.33Z	Travaux revêtement des sols et des murs
Peinture, vitrerie — peinture_et_vitrerie
43.34Z	Travaux de peinture et vitrerie
Charpente, couverture, étanchéité — charpente_couverture_etancheite
43.91A	Travaux de charpente
43.91B	Travaux de couverture par éléments
43.99A	Travaux d'étanchéification
Maçonnerie, gros œuvre — maconnerie_et_gros_oeuvre
43.99C	Trav. maçon. gle & gros oeuvre bâtiment
Autres travaux de construction — autres_travaux_de_construction
43.29B	Autres travaux d'installation n.c.a.
43.39Z	Autres travaux de finition
43.99B	Travaux montage de structure métallique
43.99D	Aut. travaux spécialisés de construction
43.99E	Location avec opérateur mat. de constr.

Commerce de gros et négoce — 14 sous-familles, 60 codes NAF

Code NAF	Libellé INSEE abrégé
Intermédiaire du commerce, centrale d'achat — intermediaire_du_commerce
46.11Z	Interm. du comm. en produits agricoles
46.12A	Centrales d'achat de carburant
46.12B	Aut. ic comb. mét. minér. & prod. chim.
46.13Z	Interm. comm. bois & matériaux construc.
46.14Z	Int. comm. équipt indus., navire & avion
46.15Z	Int. comm. meuble, art. ménage & quinc.
46.16Z	Int. comm. textile, habillt & assimil.
46.17A	Centrales d'achat alimentaires
46.17B	Autre ic en denrées, boissons et tabac
46.18Z	Int. spécialis. comm. aut. prod. spécif.
46.19A	Centrales d'achat non alimentaires
46.19B	Autre interm. commerce en prodts divers
Gros de produits agricoles et animaux vivants — gros_de_produits_agricoles
46.21Z	Com gros céréal. tab. brt & alim. bétail
46.22Z	Commerce de gros de fleurs et plantes
46.23Z	Commerce de gros d'animaux vivants
46.24Z	Commerce de gros de cuirs et peaux
Gros de fruits et légumes — gros_de_fruits_et_legumes
46.31Z	Commerce de gros de fruits et légumes
Gros de viandes et de poissons — gros_de_viandes_et_poissons
46.32A	Commerce de gros de viandes de boucherie
46.32B	Comm. gros de produits à base de viande
46.32C	Commerce de gros de volailles et gibier
46.38A	Com. gros aut. alim. yc poisson crustacé
Gros de produits alimentaires — gros_de_produits_alimentaires
46.33Z	Com. gros prod. laitier oeuf & mat. grse
46.36Z	Com. gros de sucre chocolat & confiserie
46.37Z	Comm. gros de café, thé, cacao et épices
46.38B	Comm. gros alimentaire spécialisé divers
46.39A	Commerce de gros de produits surgelés
46.39B	Comm de gros alimentaire non spécialisé
Gros de boissons et de tabac — gros_de_boissons_et_tabac
46.34Z	Commerce de gros de boissons
46.35Z	Comm. gros de produits à base de tabac
Gros de biens domestiques — gros_de_biens_domestiques
46.41Z	Commerce de gros de textiles
46.42Z	Commerce gros d'habillement & chaussures
46.43Z	Commerce de gros appareil électroménager
46.44Z	Com. gros vaisselle verrerie prod. entr.
46.45Z	Com. gros parfumerie & produit de beauté
46.47Z	Com. gros meuble tapis appareil éclaira.
46.48Z	Com. gros artic. horlogerie & bijouterie
46.49Z	Commerce gros d'autres biens domestiques
Gros de produits pharmaceutiques — gros_de_produits_pharmaceutiques
46.46Z	Comm. gros de produits pharmaceutiques
Gros d'équipements informatiques et électroniques — gros_informatique_et_electronique
46.51Z	Comm. gros ordi. éqpt périph. & logiciel
46.52Z	Cg éqpt & composant électron. & télécom.
Gros de machines et d'équipements — gros_de_machines_et_equipements
45.31Z	Commerce de gros d'équipement automobile
46.61Z	Commerce de gros de matériel agricole
46.62Z	Commerce de gros de machines-outils
46.63Z	Com. gros machine pr extrac., constr. GC
46.64Z	Com. gros machine pr ind. text. & habil.
46.65Z	Commerce de gros de mobilier de bureau
46.66Z	Com. gros autre machine & équipt bureau
46.69A	Commerce de gros de matériel électrique
46.69B	Com. gros fourniture & équipt ind. div.
46.69C	Cg fournit. & équipt div. pr com. & sces
Gros de matériaux de construction — gros_de_materiaux_de_construction
46.73A	Com. gros bois & matériaux construction
46.73B	Cg appareil sanitaire & prod. décoration
46.74A	Commerce de gros de quincaillerie
46.74B	Cg fourniture pour plomberie & chauffage
Gros de combustibles et de produits industriels — gros_de_produits_industriels
46.71Z	Com. gros combustible & produits annexes
46.72Z	Commerce de gros de minerais et métaux
46.75Z	Commerce de gros de produits chimiques
46.76Z	Commerce gros d'aut. prod. intermédiaire
Gros de déchets et récupération — gros_de_dechets_et_recuperation
46.77Z	Commerce de gros de déchets et débris
Gros non spécialisé — gros_non_specialise
46.90Z	Commerce de gros non spécialisé

Transport et logistique — 11 sous-familles, 30 codes NAF

Code NAF	Libellé INSEE abrégé
Taxi, VTC — taxi_et_vtc
49.32Z	Transports de voyageurs par taxis
49.39B	Autres transports routiers de voyageurs
Transport collectif de voyageurs — transport_collectif_de_voyageurs
49.31Z	Transport urbain & suburbain de voyageur
49.39A	Transport routier régulier de voyageurs
49.39C	Téléphériques et remontées mécaniques
Transport ferroviaire — transport_ferroviaire
49.10Z	Transport ferrov. interurbain voyageur
49.20Z	Transports ferroviaires de fret
Transport routier de fret — transport_routier_de_fret
49.41A	Transports routiers de fret interurbains
49.41B	Transports routiers de fret de proximité
49.41C	Location de camions avec chauffeur
Déménagement — demenagement
49.42Z	Services de déménagement
Transport maritime et fluvial — transport_maritime_et_fluvial
50.10Z	Transport maritime & côtier de passagers
50.20Z	Transports maritimes et côtiers de fret
50.30Z	Transports fluviaux de passagers
50.40Z	Transports fluviaux de fret
Transport aérien et spatial — transport_aerien_et_spatial
51.10Z	Transports aériens de passagers
51.21Z	Transports aériens de fret
51.22Z	Transports spatiaux
Entreposage et stockage — entreposage
52.10A	Entreposage et stockage frigorifique
52.10B	Entreposage et stockage non frigorifique
Services auxiliaires de transport, manutention — services_auxiliaires_de_transport
49.50Z	Transports par conduites
52.21Z	Sces auxiliaires de transport terrestre
52.22Z	Sces auxiliaires des transports par eau
52.23Z	Sces auxiliaires des transports aériens
52.24A	Manutention portuaire
52.24B	Manutention non portuaire
Messagerie, affrètement, fret express — messagerie_et_fret_express
52.29A	Messagerie, fret express
52.29B	Affrètement & organisation des transp.
Poste et courrier — poste_et_courrier
53.10Z	Activ. poste (obligation sce universel)
53.20Z	Autres activités de poste et de courrier

Industrie et production — 15 sous-familles, 287 codes NAF

Code NAF	Libellé INSEE abrégé
Industrie agroalimentaire — industrie_agroalimentaire
10.11Z	Transf. & conserv. viande de boucherie
10.12Z	Transf. & conserv. de viande de volaille
10.13A	Prépa. indust. produits à base de viande
10.20Z	Transf. & conserv. poisson, crust., etc.
10.31Z	Transf. et conserv. de pommes de terre
10.32Z	Préparation de jus de fruits et légumes
10.39A	Autre transf. et conserv. de légumes
10.39B	Transformation et conservation de fruits
10.41A	Fabrication d'huiles et graisses brutes
10.41B	Fab. d'huiles et graisses raffinées
10.42Z	Fab. de margarine & graisses similaires
10.51A	Fab. de lait liquide & de produits frais
10.51B	Fabrication de beurre
10.51C	Fabrication de fromage
10.51D	Fabrication d'autres produits laitiers
10.52Z	Fabrication de glaces et sorbets
10.61A	Meunerie
10.61B	Autres activités du travail des grains
10.62Z	Fabrication de produits amylacés
10.71A	Fab. indus. de pain & pâtisserie fraîche
10.72Z	Fab. pain, biscuit & pâtiss. de conserv.
10.73Z	Fabrication de pâtes alimentaires
10.81Z	Fabrication de sucre
10.82Z	Fabric. de cacao, chocolat & confiseries
10.83Z	Transformation du thé et du café
10.84Z	Fabric. de condiments et assaisonnements
10.85Z	Fabrication de plats préparés
10.86Z	Fab. d'aliment homogénéisé & diététique
10.89Z	Fab. d'autres prod. alimentaires n.c.a.
10.91Z	Fabric. d'aliments pour animaux de ferme
10.92Z	Fab. aliments pour animaux de compagnie
Boissons, vins, tabac — boissons_et_tabac
11.01Z	Prod. de boissons alcooliques distillées
11.02A	Fabrication de vins effervescents
11.02B	Vinification
11.03Z	Fabrication de cidre & de vins de fruits
11.04Z	Prod. aut. boisson fermentée non distil.
11.05Z	Fabrication de bière
11.06Z	Fabrication de malt
11.07A	Industrie des eaux de table
11.07B	Production de boissons rafraîchissantes
12.00Z	Fabrication de produits à base de tabac
Textile, habillement, cuir — textile_habillement_cuir
13.10Z	Prépa. de fibres textiles et filature
13.20Z	Tissage
13.30Z	Ennoblissement textile
13.91Z	Fabrication d'étoffes à mailles
13.92Z	Fab. d'article textile, sauf habillement
13.93Z	Fabrication de tapis et moquettes
13.94Z	Fabric. de ficelles, cordes et filets
13.95Z	Fabric. de non-tissés, sauf habillement
13.96Z	Fab. autre textile techniq. & industriel
13.99Z	Fabrication d'autres textiles n.c.a.
14.11Z	Fabrication de vêtements en cuir
14.12Z	Fabrication de vêtements de travail
14.13Z	Fabrication de vêtements de dessus
14.14Z	Fabrication de vêtements de dessous
14.19Z	Fabric. autres vêtements et accessoires
14.20Z	Fabrication d'articles en fourrure
14.31Z	Fabric. d'articles chaussants à mailles
14.39Z	Fabrication d'autres articles à mailles
15.11Z	Prépa. cuirs; prép. & teinture fourrures
15.12Z	Fab. art. voyage, maroquin., & sellerie
15.20Z	Fabrication de chaussures
Bois, papier, imprimerie — bois_papier_et_imprimerie
16.10A	Sciage & rabotage bois, sf imprégnation
16.10B	Imprégnation du bois
16.21Z	Fabric. placage et panneaux de bois
16.22Z	Fabrication de parquets assemblés
16.23Z	Fab. charpentes et autres menuiseries
16.24Z	Fabrication d'emballages en bois
16.29Z	Fab. objet div. bois, liège, vann., etc.
17.11Z	Fabrication de pâte à papier
17.12Z	Fabrication de papier et de carton
17.21A	Fabrication de carton ondulé
17.21B	Fabrication de cartonnages
17.21C	Fabrication d'emballages en papier
17.22Z	Fab. article papier sanit. ou domestique
17.23Z	Fabrication d'articles de papeterie
17.24Z	Fabrication de papiers peints
17.29Z	Fab. aut. article en papier ou en carton
18.11Z	Imprimerie de journaux
18.12Z	Autre imprimerie (labeur)
18.13Z	Activités de pré-presse
18.14Z	Reliure et activités connexes
18.20Z	Reproduction d'enregistrements
Chimie, pharmacie, plastique, caoutchouc — chimie_pharmacie_plastique
19.10Z	Cokéfaction
19.20Z	Raffinage du pétrole
20.11Z	Fabrication de gaz industriels
20.12Z	Fabrication de colorants et de pigments
20.13A	Enrichissment & retrait. mat. nucléaire
20.13B	Fab. aut. prod. chim. inorg. base n.c.a.
20.14Z	Fab. aut. prod. chimique org. de base
20.15Z	Fabric. de produits azotés et d'engrais
20.16Z	Fabric. de matières plastiques de base
20.17Z	Fabrication de caoutchouc synthétique
20.20Z	Fab. pesticide & aut. prod. agrochimique
20.30Z	Fab. de peinture, vernis, encre & mastic
20.41Z	Fab. savon, détergent & prod. entretien
20.42Z	Fab. parfum & produit pour la toilette
20.51Z	Fabrication de produits explosifs
20.52Z	Fabrication de colles
20.53Z	Fabrication d'huiles essentielles
20.59Z	Fabric. autres produits chimiques n.c.a.
20.60Z	Fab. fibre artificielle ou synthétique
21.10Z	Fab. de produits pharmaceutiques de base
21.20Z	Fabric. de préparations pharmaceutiques
22.11Z	Fabrication et rechapage de pneumatiques
22.19Z	Fabric. d'autres articles en caoutchouc
22.21Z	Fab. plaque, feuille, tube, etc. plast.
22.22Z	Fab. d'emballage en matière plastique
22.23Z	Fab. élément mat. plastiq. pr construct.
22.29A	Fab. pièce techniq. base mat. plastiq.
22.29B	Fab. prod. conso. courante en plastique
Matériaux de construction, verre, céramique — materiaux_de_construction
23.11Z	Fabrication de verre plat
23.12Z	Façonnage & transformation du verre plat
23.13Z	Fabrication de verre creux
23.14Z	Fabrication de fibres de verre
23.19Z	Fab. & façonnage aut. article en verre
23.20Z	Fabrication de produits réfractaires
23.31Z	Fabrication de carreaux en céramique
23.32Z	Fab. produit construct. en terre cuite
23.41Z	Fab. art. céramiq. usage domest. & déco.
23.42Z	Fab. appareil sanitaire en céramique
23.43Z	Fab. isolateur & pièce isolante céramiq.
23.44Z	Fab. aut. prod. céram. à usage technique
23.49Z	Fabrication d'autres produits céramiques
23.51Z	Fabrication de ciment
23.52Z	Fabrication de chaux et plâtre
23.61Z	Fab. élément en béton pour la construct.
23.62Z	Fab. élément en plâtre pour la construc.
23.63Z	Fabrication de béton prêt à l'emploi
23.64Z	Fabrication de mortiers et bétons secs
23.65Z	Fabrication d'ouvrages en fibre-ciment
23.69Z	Fab. aut. ouvrage béton, ciment, plâtre
23.70Z	Taille, façonnage & finissage de pierres
23.91Z	Fabrication de produits abrasifs
23.99Z	Fab. aut. prod. minéraux non métal. nca.
Métallurgie, travail des métaux — metallurgie_et_travail_des_metaux
24.10Z	Sidérurgie
24.20Z	Fab. tube, profilé creux etc. en acier
24.31Z	Étirage à froid de barres
24.32Z	Laminage à froid de feuillards
24.33Z	Profilage à froid par formage ou pliage
24.34Z	Tréfilage à froid
24.41Z	Production de métaux précieux
24.42Z	Métallurgie de l'aluminium
24.43Z	Métallurgie du Pb, du Zn ou du Sn
24.44Z	Métallurgie du cuivre
24.45Z	Métallurgie autres métaux non ferreux
24.46Z	Élaboration et transform. mat. nucléaire
24.51Z	Fonderie de fonte
24.52Z	Fonderie d'acier
24.53Z	Fonderie de métaux légers
24.54Z	Fonderie d'autres métaux non ferreux
25.11Z	Fab. structure métal. & partie structure
25.12Z	Fabric. de portes et fenêtres en métal
25.21Z	Fab. radiat. & chaudière pr chauf. ctral
25.29Z	Fab. aut. réservr, citerne, etc. métal.
25.30Z	Fab. générat. vapeur sf pr chauff. ctral
25.40Z	Fabrication d'armes et de munitions
25.50A	Forge; métallurgie des poudres
25.50B	Découpage, emboutissage
25.61Z	Traitement et revêtement des métaux
25.62A	Décolletage
25.62B	Mécanique industrielle
25.71Z	Fabrication de coutellerie
25.72Z	Fabrication de serrures et de ferrures
25.73A	Fabrication de moules et modèles
25.73B	Fabrication d'autres outillages
25.91Z	Fab. fût & emballage métalliq. similaire
25.92Z	Fabric. d'emballages métalliques légers
25.93Z	Fab. art. fil métal., chaîne & ressort
25.94Z	Fabrication de vis et de boulons
25.99A	Fabric. d'articles métalliques ménagers
25.99B	Fabric. d'autres articles métalliques
Équipements électriques et électroniques — equipements_electriques_et_electroniques
26.11Z	Fabrication de composants électroniques
26.12Z	Fab. de cartes électroniques assemblées
26.20Z	Fab. ordinateur & équipement périphériq.
26.30Z	Fabric. d'équipements de communication
26.40Z	Fab. produit électronique grand public
26.51A	Fab. équipement d'aide à la navigation
26.51B	Fab. instrumentation scientifiq. & tech.
26.52Z	Horlogerie
26.60Z	Fab. éqpt irrad. médic. & électromedic.
26.70Z	Fab. matériel optique et photographique
26.80Z	Fab. de supports magnétiques et optiques
27.11Z	Fab. moteur génér. transfo. & mat. élec.
27.12Z	Fab. mat. de distrib. & de cde électri.
27.20Z	Fabric. pile & accumulateur électrique
27.31Z	Fabrication de câbles de fibres optiques
27.32Z	Fab. aut. fil & câble éltron. ou éltriq.
27.33Z	Fabric. matériel installation électrique
27.40Z	Fabric. appareils d'éclairage électrique
27.51Z	Fabrication d'appareils électroménagers
27.52Z	Fab. appareils ménagers non électriques
27.90Z	Fabric. d'autres matériels électriques
Machines et équipements — machines_et_equipements
28.11Z	Fab. moteur & turb. sf pr avion & véhic.
28.12Z	Fab. équipement hydraulique & pneumatiq.
28.13Z	Fabric. d'autres pompes et compresseurs
28.14Z	Fabric. autres articles de robinetterie
28.15Z	Fab. engrenage & organe méca. transmis.
28.21Z	Fabrication de fours et brûleurs
28.22Z	Fab. matériel de levage & de manutention
28.23Z	Fab. machine équipt bureau (sf ordinat.)
28.24Z	Fab. outillage portatif à moteur incorp.
28.25Z	Fab. équipt aérauliq. & frigorifiq. ind.
28.29A	Fab. éqpt emballage condition. & pesage
28.29B	Fab. d'autres machines d'usage général
28.30Z	Fab. machines agricoles et forestières
28.41Z	Fab. de machines de formage des métaux
28.49Z	Fabrication d'autres machines-outils
28.91Z	Fabric. de machines pour la métallurgie
28.92Z	Fab. machine pour extraction ou constr.
28.93Z	Fab. machine pour l'indus. agro-aliment.
28.94Z	Fab. machine pour industries textiles
28.95Z	Fab. machine pr indus. papier & carton
28.96Z	Fab. machine pr trav. du caoutch, plast.
28.99A	Fabrication de machines d'imprimerie
28.99B	Fabric. d'autres machines spécialisées
Matériels de transport — materiels_de_transport
29.10Z	Construction de véhicules automobiles
29.20Z	Fabrication de carrosseries et remorques
29.31Z	Fab. équipt électriq. & électron. auto.
29.32Z	Fabric. d'autres équipements automobiles
30.11Z	Construct. navires & structure flottante
30.12Z	Construction de bateaux de plaisance
30.20Z	Const. loco. & autre mat. ferro. roulant
30.30Z	Construction aéronautique et spatiale
30.40Z	Constr. véhicules militaires de combat
30.91Z	Fabrication de motocycles
30.92Z	Fab. bicyclette & véhic. pour invalides
30.99Z	Fab. aut. équipement de transport n.c.a.
Meuble et autres industries manufacturières — meuble_et_autres_industries
31.01Z	Fab. de meubles de bureau et de magasin
31.02Z	Fabrication de meubles de cuisine
31.03Z	Fabrication de matelas
31.09A	Fabric. sièges d'ameublement d'intérieur
31.09B	Fab. aut. meub. & ind. connexe ameublmnt
32.11Z	Frappe de monnaie
32.12Z	Fab. article de joaillerie et bijouterie
32.13Z	Fab. art. bijout. fantaisie & similaire
32.20Z	Fabrication d'instruments de musique
32.30Z	Fabrication d'articles de sport
32.40Z	Fabrication de jeux et jouets
32.50A	Fab. matériel médico-chirurg. & dentaire
32.50B	Fabrication de lunettes
32.91Z	Fabrication d’articles de brosserie
32.99Z	Autres activités manufacturières n.c.a.
Réparation et installation industrielles — reparation_et_installation_industrielles
33.11Z	Réparation d'ouvrages en métaux
33.12Z	Répar. machine & équipement mécaniques
33.13Z	Répar. matériel électronique & optique
33.14Z	Réparation d'équipements électriques
33.15Z	Réparation et maintenance navale
33.16Z	Répar. & maint. aéronef & eng. spatiaux
33.17Z	Répar. & maint. d'aut. équipt transport
33.19Z	Réparation d'autres équipements
33.20A	Instal. struct. métal., chaudr. & tuyau.
33.20B	Instal. machines & équipement mécanique
33.20C	Instal. éqpts ctrle des processus indus.
33.20D	Inst. éqpt élec. électro. optiq. ou aut.
Industries extractives — industries_extractives
05.10Z	Extraction de houille
05.20Z	Extraction de lignite
06.10Z	Extraction de pétrole brut
06.20Z	Extraction de gaz naturel
07.10Z	Extraction de minerais de fer
07.21Z	Extr. de minerais d'uranium & de thorium
07.29Z	Extr. aut. minerai de métaux non ferreux
08.11Z	Extr. pierre ornement. & construct. etc.
08.12Z	Exploit. gravière & sabl., extr. argile
08.91Z	Extr. minéraux chimiq. & engrais min.
08.92Z	Extraction de tourbe
08.93Z	Production de sel
08.99Z	Autres activités extractives n.c.a.
09.10Z	Act. de soutien à l'extr. hydrocarbures
09.90Z	Act. de soutien aut. indus. extractives
Production et distribution d'énergie — energie
35.11Z	Production d'électricité
35.12Z	Transport d'électricité
35.13Z	Distribution d'électricité
35.14Z	Commerce d'électricité
35.21Z	Production de combustibles gazeux
35.22Z	Distrib. combustible gazeux pr conduites
35.23Z	Commerce combustible gazeux par conduite
35.30Z	Prod. & distrib. vapeur et air condit.
Eau, assainissement, déchets — eau_et_dechets
36.00Z	Captage, traitement & distribution d'eau
37.00Z	Collecte et traitement des eaux usées
38.11Z	Collecte des déchets non dangereux
38.12Z	Collecte des déchets dangereux
38.21Z	Traitmnt & élimin. déchets non dangereux
38.22Z	Traitmnt & élimination déchets dangereux
38.31Z	Démantèlement d'épaves
38.32Z	Récupération de déchets triés
39.00Z	Dépollution & autre sces gestion déchets

Agriculture, sylviculture, pêche — 10 sous-familles, 39 codes NAF

Code NAF	Libellé INSEE abrégé
Grandes cultures — grandes_cultures
01.11Z	Cult céréale, légumineuse, graine oléag.
01.12Z	Culture du riz
01.14Z	Culture de la canne à sucre
01.15Z	Culture du tabac
01.16Z	Culture de plantes à fibres
01.19Z	Autres cultures non permanentes
Maraîchage, horticulture — maraichage_et_horticulture
01.13Z	Cult. légume, melon, racine & tubercule
01.30Z	Reproduction de plantes
Viticulture — viticulture
01.21Z	Culture de la vigne
Arboriculture et autres cultures permanentes — arboriculture_et_cultures_permanentes
01.22Z	Culture fruits tropicaux et subtropicaux
01.23Z	Culture d'agrumes
01.24Z	Culture de fruits à pépins et à noyau
01.25Z	Cult. d'aut. fruits & de fruits à coque
01.26Z	Culture de fruits oléagineux
01.27Z	Culture de plantes à boissons
01.28Z	Cult. plante aromatiq. médicin. pharma.
01.29Z	Autres cultures permanentes
Élevage bovin et laitier — elevage_bovin_et_laitier
01.41Z	Élevage de vaches laitières
01.42Z	Élevage d'autres bovins et de buffles
Autres élevages — autres_elevages
01.43Z	Élevage de chevaux et d'autres équidés
01.44Z	Élevage de chameaux & d'autres camélidés
01.45Z	Élevage d'ovins et de caprins
01.46Z	Élevage de porcins
01.47Z	Élevage de volailles
01.49Z	Élevage d'autres animaux
Polyculture et polyélevage — polyculture_et_polyelevage
01.50Z	Culture et élevage associés
Services de soutien à l'agriculture — services_agricoles
01.61Z	Activités de soutien aux cultures
01.62Z	Activités de soutien à la prod. animale
01.63Z	Traitement primaire des récoltes
01.64Z	Traitement des semences
Sylviculture, exploitation forestière — sylviculture_et_exploitation_forestiere
02.10Z	Sylviculture & autres act. forestières
02.20Z	Exploitation forestière
02.30Z	Récolte prodts forestiers non ligneux
02.40Z	Services de soutien à l'expl. forestière
Pêche, chasse, aquaculture — peche_chasse_et_aquaculture
01.70Z	Chasse, piégeage et services annexes
03.11Z	Pêche en mer
03.12Z	Pêche en eau douce
03.21Z	Aquaculture en mer
03.22Z	Aquaculture en eau douce

Administration, enseignement, associations — 8 sous-familles, 36 codes NAF

Code NAF	Libellé INSEE abrégé
Administration publique — administration_publique
84.11Z	Administration publique générale
84.12Z	A. p. santé form. cult. & soc. (sf sécu)
84.13Z	Adm. publique des activités économiques
84.21Z	Affaires étrangères
84.22Z	Défense
84.23Z	Justice
84.24Z	Activités d’ordre public et de sécurité
84.25Z	Services du feu et de secours
Sécurité sociale et retraites — securite_sociale_et_retraites
84.30A	Activités générales de sécurité sociale
84.30B	Gestion des retraites complémentaires
84.30C	Distribution sociale de revenus
Enseignement scolaire — enseignement_scolaire
85.10Z	Enseignement pré-primaire
85.20Z	Enseignement primaire
85.31Z	Enseignement secondaire général
85.32Z	Enseignemt secondaire techn. ou profess.
Enseignement supérieur — enseignement_superieur
85.41Z	Enseignement post-secondaire non sup.
85.42Z	Enseignement supérieur
Formation continue et soutien à l'enseignement — formation_continue
85.59A	Formation continue d'adultes
85.59B	Autres enseignements
85.60Z	Activités de soutien à l'enseignement
Spectacle vivant et création artistique — spectacle_vivant_et_creation_artistique
90.01Z	Arts du spectacle vivant
90.02Z	Activités de soutien au spectacle vivant
90.03A	Création artistique (arts plastiques)
90.03B	Autre création artistique
90.04Z	Gestion de salles de spectacles
Patrimoine, musées, cinémas — patrimoine_et_culture
59.14Z	Projection de films cinématographiques
91.01Z	Gestion des bibliothèques & des archives
91.02Z	Gestion des musées
91.03Z	Gestion site histor. & attraction simil.
91.04Z	Gest. jardin bota. & zoo. & réserv. nat.
Associations et organisations — association_et_organisation
94.11Z	Act. organisations patronale & consul.
94.12Z	Act. des organisations professionnelles
94.20Z	Activités des syndicats de salariés
94.91Z	Activités des organisations religieuses
94.92Z	Activités des organisations politiques
94.99Z	Aut. org. fonctionnant par adhé. volont.

Autres activités — 2 sous-familles, 4 codes NAF

Code NAF	Libellé INSEE abrégé
Ménages employeurs et producteurs pour usage propre — menages_employeurs
97.00Z	Act. ménage: empl. de person. domestique
98.10Z	Act. ménage : prod. biens (usage propre)
98.20Z	Act. ménage : prod. serv. (usage propre)
Organismes extraterritoriaux — organismes_extraterritoriaux
99.00Z	Act. organisations extraterritoriales

Ce qui a cessé — les défaillances et les arrêts d'activité

Le bloc defaillances répond à la question : dans cette zone, pour cette activité, y a-t-il eu de la casse, et est-ce que ça monte ? Deux séries par année depuis 2017 : les procédures collectives publiées au BODACC — liquidation, redressement, sauvegarde — comptées sur chaque établissement de l'entreprise situé dans la zone, et les arrêts d'activité, fermetures SIRENE qui ne sont ni une cession ni un déménagement. Ce sont des événements passés, comptés ; le bloc ne dit rien de l'avenir d'un établissement ni de la cause d'un arrêt.

Le mot défaillance a ici le sens que lui donne la Banque de France : l'ouverture d'un redressement judiciaire ou d'une liquidation judiciaire. La sauvegarde n'en est pas une — c'est une procédure ouverte avant la cessation des paiements — et elle est servie à part, dans procedures.sauvegarde, parce qu'elle est publique et qu'un lecteur la cherchera.

Ce qu'est un arrêt d'activité

Un établissement fermé au sens de SIRENE n'a pas forcément cessé d'exister : son commerce peut avoir été repris, ou l'entreprise s'être installée à côté. Le bloc ne compte donc comme arrêt qu'une fermeture sans :

• autre établissement, de même code NAF, à la même adresse (quel que soit son SIREN), créé dans les 6 mois avant ou après la fermeture — un repreneur ;
• autre établissement du même SIREN créé dans les 3 mois avant ou après — un déménagement.

Ces fenêtres ne sont pas arbitraires. Sur les boulangeries-pâtisseries fermées en 2023 et positionnées, 24 % ont été reprises à la même adresse, 22 % ont rouvert ailleurs sous le même SIREN, et 4,5 % seulement sont liées à une procédure collective de l'entreprise. Publier les fermetures SIRENE brutes aurait compté deux fois trop de casse pour un commerce de proximité.

"defaillances": {
  "source": "BODACC (DILA) et SIRENE (INSEE), établissements géolocalisés",
  "annees": [2017, 2018, "…", 2026],
  "annee_en_cours": { "annee": 2026, "partielle": true,
                      "bodacc_jusqu_au": "2026-09-18", "sirene_jusqu_au": "2026-09-19" },
  "reference": { "niveau": "departement", "code": "69", "libelle": "Rhône" },
  "fiabilite": { "taux_localisation": 78.9, "defaillances_min": 5,
                 "actifs_min": 20, "arrets_recents_sous_comptes": true,
                 "procedures_sous_declarees": false,
                 "departements_sous_declares": [] },
  "procedures": { "liquidation": [42, "…"], "redressement": [7, "…"],
                  "sauvegarde": [3, "…"], "autres": [0, "…"] },
  "defaillances": [49, "…"],
  "arrets": [310, "…"],
  "periodes": {
    "recente":    { "de": 2023, "a": 2025, "defaillances": 212, "arrets": 1402,
                    "taux_defaillance": 3.9, "reference_taux": 3.1, "indice": 126 },
    "precedente": { "de": 2020, "a": 2022, "defaillances": 118, "arrets": 1180 },
    "evolution_defaillances_pct": 79.7, "evolution_arrets_pct": 18.8 },
  "familles": [
    { "cle": "commerce_detail_alimentaire", "libelle": "Commerce de détail alimentaire",
      "defaillances": [3, "…"], "arrets": [21, "…"],
      "periodes": { "recente": { "de": 2023, "a": 2025, "defaillances": 14, "arrets": 61,
                                 "taux_defaillance": 3.3, "reference_taux": 2.9, "indice": 114 },
                    "precedente": { "de": 2020, "a": 2022, "defaillances": 9, "arrets": 55 },
                    "evolution_defaillances_pct": 55.6, "evolution_arrets_pct": 10.9 },
      "sous_familles": [
        { "cle": "boulangerie_patisserie", "libelle": "Boulangerie, pâtisserie",
          "defaillances": [1, 0, "…"], "arrets": [3, 2, "…"],
          "periodes": { "…": "même forme que la famille" } },
        { "...": "les autres sous-familles qui ont au moins un événement" }
      ] },
    { "...": "les familles 2 à 14" }
  ]
}

Champ	Sens
annees	Les années servies, de 2017 à l'année en cours. Tous les tableaux du bloc ont un entier par année, dans cet ordre.
annee_en_cours	L'année en cours est partielle ; bodacc_jusqu_au et sirene_jusqu_au disent jusqu'où chaque source a été lue.
procedures	Jugements d'ouverture par nature, par année : liquidation, redressement, sauvegarde, autres (autres jugements d'ouverture).
defaillances	Liquidation + redressement, par année (sauvegarde et autres exclus).
arrets	Arrêts d'activité, par année.
periodes	Deux périodes cumulées de trois années complètes (recente et precedente), avec taux, indice et évolution.
familles, sous_familles	Les mêmes postes que le bloc activites : cle stable, libelle, defaillances et arrets par année, periodes.
fiabilite	taux_localisation (celui de la référence, comme pour activites), les deux seuils defaillances_min et actifs_min, arrets_recents_sous_comptes, procedures_sous_declarees (vrai quand le département dominant publie trop peu au BODACC : taux, indice et évolution ne sont alors pas servis) et departements_sous_declares (les codes concernés).

Comment lire les périodes, le taux et l'indice

Sur une petite zone, l'année par année est du bruit : un commerçant d'un centre-ville lira « 0, 1, 1, 1, 0, 2, 2, 1 ». Le bloc sert donc deux périodes cumulées de trois années complètes — les trois dernières et les trois d'avant, dérivées de annee_en_cours : en 2026, 2023-2025 contre 2020-2022 — et c'est sur elles que portent le taux, l'indice et l'évolution.

• taux_defaillance : les défaillances de la période divisées par 3 fois les établissements actifs du poste dans la zone, × 100 — soit pour 100 établissements actifs et par an, au dixième. reference_taux est la même formule sur le territoire de référence.
• indice : 100 × le taux de la zone ÷ le taux de la référence, calculé sur les bruts et non sur les taux arrondis. 100 est la référence ; 126 veut dire 26 % de plus.
• taux_defaillance et indice valent null quand la période récente compte moins de 5 défaillances (defaillances_min) ou que le poste compte moins de 20 établissements actifs dans la zone (actifs_min) : un petit numérateur et un petit dénominateur sont deux instabilités distinctes. Les effectifs restent servis.
• evolution_defaillances_pct et evolution_arrets_pct : (récente − précédente) ÷ précédente × 100, null si la période précédente est à zéro.

Hypothèses et limites

1. Les procédures collectives sont un plancher. Seules comptent celles dont l'entreprise a au moins un établissement géolocalisé : 73 % des ouvertures 2017-2026 en ont un. fiabilite.taux_localisation dit la part vue sur la référence ; l'indice, calculé de la même façon des deux côtés, annule en grande partie ce sous-compte. Une procédure est comptée sur chaque établissement de l'entreprise situé dans la zone et vivant à la date du jugement, pas au seul siège : une chaîne de magasins en procédure compte une fois dans la zone de chaque magasin. Une entreprise ouverte en redressement puis convertie en liquidation compte une seule fois, à l'ouverture du redressement : la conversion est publiée dans une autre famille du BODACC (« Jugement prononçant ») et n'est pas une nouvelle ouverture. Seule une liquidation ouverte après la résolution d'un plan compte une seconde fois. C'est la convention de la Banque de France.
2. Les arrêts d'activité sont un plafond. Le rapprochement d'une reprise se fait sur l'adresse déclarée, pas sur la position : un repreneur qui écrit « 12 RUE DE LA PAIX » là où le fermé disait « 12 R DE LA PAIX » n'est pas reconnu, et la fermeture compte comme un arrêt. Un arrêt peut aussi être une retraite, un changement de code NAF ou une radiation administrative.
3. Les trois derniers mois d'arrêts sont sous-comptés. Une fermeture se déclare avec retard ; les procédures du BODACC, publiées en quelques jours, n'ont pas ce retard. fiabilite.arrets_recents_sous_comptes vaut aujourd'hui toujours true, et l'année en cours est partielle pour les deux séries.
4. Le Bas-Rhin est sous-compté. Le tribunal judiciaire de Strasbourg ne publie presque plus ses jugements d'ouverture au BODACC depuis 2022 (environ 650 par an jusqu'en 2019, une vingtaine par an depuis). Sur une zone dont le département dominant est concerné, fiabilite.procedures_sous_declarees vaut true et taux_defaillance, indice et evolution_defaillances_pct ne sont pas servis, à aucun niveau ; les effectifs et les arrêts d'activité restent servis. fiabilite.departements_sous_declares liste les codes concernés (["67"] aujourd'hui).
5. Le dénominateur est le stock d'aujourd'hui. Un taux de 2023 divise par les établissements actifs d'aujourd'hui, pas par ceux de 2023. L'approximation est sans effet sur l'indice, calculé de la même façon des deux côtés.
6. Une sauvegarde n'est pas une défaillance. Elle n'entre ni dans defaillances ni dans les taux ; elle reste visible dans procedures.sauvegarde.
7. Aucune cause. Ni d'une liquidation, ni d'un arrêt : aucune source ne la porte. Le bloc compte des événements passés ; il ne prédit rien et ne rend jamais une liste nominative d'entreprises.

Comme pour les activités, les 14 familles sont toujours présentes, même à zéro, et les sous-familles sans aucun événement sur la fenêtre sont omises. Le bloc est réservé aux plans Growth et au-dessus, rendu dans le même appel que /zone/stats et, identique, pour chaque zone de /zone/compare, sans appel supplémentaire ; sources : BODACC (DILA) et SIRENE (INSEE).

Comparer des emplacements — et mesurer la cannibalisation

Quand vous hésitez entre plusieurs adresses, ou que vous ajoutez un point de vente à un réseau existant, la question n'est pas seulement « combien d'habitants dans chaque zone ? » mais « combien de ces habitants sont déjà dans une autre de mes zones ? ». POST /zone/compare prend de 2 à 10 zones, chacune décrite comme sur /zone/stats (une durée, un rayon ou un contour, avec son propre centre), et rend pour chacune exactement le même bloc que /zone/stats — mêmes clés, mêmes valeurs —, plus deux choses que vous ne pouvez pas calculer vous-même sans les carreaux :

• exclusif, par zone : la population, les ménages et le potentiel que cette zone est seule à couvrir, hors de tout chevauchement avec les autres zones de la requête. part_population dit quelle part de la zone cela représente.
• chevauchements, par paire de zones qui se recouvrent : ce que les deux comptent deux fois.

curl -X POST "https://api.trustydata.app/services/v1/zone/compare" \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "zones": [
      {"id": "part-dieu",   "adresse": "Place Charles Béraudier 69003 Lyon", "duree": 10, "mode": "auto"},
      {"id": "bellecour",   "lat": 45.7578, "lon": 4.8320, "duree": 10, "mode": "auto"},
      {"id": "villeurbanne", "adresse": "Gratte-Ciel, Villeurbanne", "rayon": 3}
    ],
    "reference": "departement",
    "coefficient": 0.048,
    "critere": "potentiel_exclusif"
  }'

La réponse garde vos zones dans l'ordre envoyé, sous l'id que vous leur avez donné (ou leur position, "1", "2"…), et ajoute classement : les identifiants triés sur le critere choisi — population par défaut, population_exclusive, potentiel_theorique ou potentiel_exclusif (les deux derniers demandent un coefficient, appliqué à toutes les zones : un potentiel ne se compare qu'à coefficient égal).

{
  "zones": [
    {"id": "part-dieu", "population": 441009, "potentiel_depense": {"potentiel_theorique": 428399391, ...},
     "exclusif": {"population": 51484, "menages": 25085, "part_population": 11.7,
                  "potentiel_depense": {"revenu_disponible_estime": 1083557762, "coefficient": 0.048, "potentiel_theorique": 52010773}},
     ...},
    {"id": "bellecour", ...},
    {"id": "villeurbanne", ...}
  ],
  "chevauchements": [
    {"zones": ["part-dieu", "bellecour"], "population": 207618, "menages": 109505,
     "potentiel_depense": {"revenu_disponible_estime": 4415158143, "coefficient": 0.048, "potentiel_theorique": 211927591}}
  ],
  "classement": ["bellecour", "part-dieu", "villeurbanne"],
  "critere": "potentiel_exclusif",
  "source": {"filosofi_millesime": 2021, "contours_iris_millesime": 2026, "recensement_millesime": 2022},
  "attribution": "..."
}

Ce qu'il faut savoir

• Un appel compté, quel que soit le nombre de zones (code ZONE_COMPARE, plan Growth).
• De 2 à 10 zones. Au-delà, la réponse ne tiendrait plus dans la seconde ; découpez.
• Une zone inatteignable (isochrone que le moteur ne sait pas tracer) rend des zéros, exclusif.part_population à null, n'entre dans aucune paire et se classe dernière.
• Les erreurs disent quelle zone est en cause. Quand une zone précise est fautive — deux portées à la fois, adresse non résolue, contour invalide, zone au-dessus de 10 000 km², ou id hors motif (identifiant_invalide) —, detail est un objet, par exemple {"code": "portee_ambigue", "zone": "bellecour"} ou {"code": "identifiant_invalide", "zone": "bellecour!"} — zone porte alors l'identifiant tel qu'envoyé (ou la position s'il était vide) ; quand c'est la requête entière (nombre_zones_invalide, identifiants_dupliques, coefficient_requis), detail reste une chaîne, comme sur /zone/stats.
• Le bloc activités est rendu pour chaque zone, identique à celui de /zone/stats — mais ni exclusif ni chevauchements ne comptent d'établissements : ils portent la population, les ménages et le potentiel, et rien d'autre. Comparez les indice d'une zone à l'autre plutôt que les effectifs, pour la raison dite plus haut.
• Ni le contour des exclusifs ni celui des intersections ne sont rendus — seulement leurs chiffres. rendre_polygone rend le contour de chaque zone, comme sur /zone/stats.

Un avis de lecture sur la zone — la synthèse

POST /zone/synthese (plan Growth) rend, pour une zone, un avis structuré en français rédigé par un modèle de langage à partir des seules données de la zone. Le corps est celui de /zone/stats (durée, rayon ou contour, reference, coefficient), plus deux champs facultatifs :

• activites — de 0 à 20 clés de familles ou de sous-familles de la grille d'activités ; une clé inconnue fait un 422 activite_inconnue, et plus de 20 clés un 422 activites_trop_nombreuses.
• contexte — 300 caractères au plus, description libre de l'activité envisagée. C'est une description, jamais une instruction : au-delà de 300 caractères, 422 contexte_trop_long.

Vous décrivez la zone, vous ne fournissez pas ses chiffres : le service la recalcule et rédige sur ses propres données. Le champ rendre_polygone est accepté et ignoré sur cette route.

curl -X POST "https://api.trustydata.app/services/v1/zone/synthese" \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "adresse": "1 rue de la République 69001 Lyon",
    "duree": 10,
    "mode": "auto",
    "activites": ["restauration_traditionnelle"],
    "contexte": "restaurant traditionnel, 80 couverts"
  }'

{
  "point_central": { ... },
  "portee": {"type": "isochrone", "duree_min": 10, "mode": "auto", "circulation": "pointe"},
  "synthese": {
    "verdict": "Une phrase.",
    "points_forts": ["…", "…"],
    "points_attention": ["…"],
    "lecture_activite": "Un paragraphe, ou null si aucune activité ni contexte.",
    "a_verifier": ["…", "…"]
  },
  "fiabilite": {"csp": true, "immobilier": true, "activites": true},
  "genere_le": "2026-10-11T09:12:44Z",
  "modele": "claude-opus-5-5",
  "mention": "Avis généré automatiquement à partir des données de la zone ; il ne remplace pas l'analyse du franchiseur.",
  "attribution": "..."
}

Le verdict tient en 240 caractères au plus ; les listes comptent de 1 à 4 entrées de 240 caractères au plus ; lecture_activite compte 900 caractères au plus, ou null. La réponse ne rend pas les chiffres de la zone : /zone/stats les donne.

Ce qu'il faut savoir

• Un appel compté par demande (code ZONE_SYNTHESE), y compris quand la réponse est servie depuis le cache, conservé 24 heures pour une même zone, une même référence, un même coefficient, les mêmes activités et le même contexte. Une réponse 502 ou 503, elle, n'est pas décomptée.
• Compter 15 à 30 secondes de réponse : prévoyez un délai de lecture en conséquence.
• Erreurs. Celles de /zone/stats (401, 403, 422, 503), plus 422 activite_inconnue, 422 activites_trop_nombreuses et 422 contexte_trop_long ; 503 synthese_indisponible quand l'avis ne peut pas être rédigé pour le moment (le détail n'est pas rendu) ; 502 synthese_invalide si la réponse du modèle ne respecte pas le format attendu — refaites l'appel.
• Pas d'outil MCP pour cette route : un assistant dispose des chiffres par zone_stats et n'a pas besoin qu'on lui rédige un avis.

Trois façons de décrire la zone

• Une durée — adresse (ou lat+lon) + duree (1 à 30 min) + mode (auto par défaut, pieton, velo) : l'exemple ci-dessus.
• Un rayon — un centre + rayon (1 à 50 km), disque à vol d'oiseau, sans moteur d'itinéraire.
• Un contour — polygone, un GeoJSON Polygon ou MultiPolygon WGS84 pris tel quel : celui que portee.polygone vous a rendu plus haut, ou un contour dessiné à la main. Seul, sans centre.

Une seule de ces trois formes par appel — deux à la fois font un 422 portee_ambigue. Le plafond de surface est de 10 000 km² (422 zone_trop_grande) ; un rayon de 50 km en fait 7 850, un isochrone de 30 minutes en voiture rarement plus de 3 000. Et une zone sans aucun carreau — en mer, à l'étranger — est un 200 avec des zéros, pas une erreur, comme une recherche sans résultat.

Enrichir — par adresse

Le contour délimite une zone et /zone/stats la chiffre ; ni l'un ni l'autre ne dit rien d'une adresse précise. Pour qualifier ce que vous voyez sur la carte — une adresse candidate à un nouveau site, un point de passage identifié dans la zone — appelez GET /address/view/{id} sur l'adresse qui vous intéresse :

curl "https://api.trustydata.app/services/v1/address/view/69382_1080_00012" \
  -H "Authorization: Bearer VOTRE_CLE_API"

La richesse de la réponse dépend du plan de votre clé, comme pour tout endpoint /address/* : le plan Discovery rend déjà l'adresse restituée ; le plan Starter ajoute la position (WGS84 et Lambert 93) ; le plan Growth ajoute le bloc geocoding, dont geocoding.code_iris — l'identifiant de la zone IRIS INSEE qui contient l'adresse ; le plan Business ajoute statistical_grid, la maille de 200 m de la grille Filosofi (INSEE) dans laquelle tombe cette adresse précise, avec son nombre d'habitants et de ménages.

Ce que le contour ne dit pas

• Le contour ne porte pas de chiffre lui-même. Population, ménages et niveau de vie moyen « de la zone » viennent de POST /zone/stats, avec le même centre et la même durée, ou en lui renvoyant portee.polygone tel quel.
• Le tri des résultats reste à vol d'oiseau. portee.polygone délimite qui entre dans la recherche ; il ne change pas l'ordre de resultats[], toujours classé sur distance_m.
• L'enrichissement routier s'arrête à 25 résultats. Avec distances=true, les 25 premiers résultats de la page gagnent duree_s et distance_routiere_m (calculés dans le mode de la portée) et toujours en circulation libre, y compris sous une portée circulation=pointe ; au-delà, les deux champs valent null. C'est un enrichissement de la page rendue, pas un second tri : voir Mes lieux pour le détail des bornes et de la pagination.

Questions fréquentes

Quel appel calcule une zone de chalandise ?

GET /services/v1/locations/search avec adresse (ou lat/lon), duree de 1 à 30 minutes, mode auto, pieton ou velo, et polygone=true pour recevoir le contour GeoJSON. Plan Growth.

Comment obtenir la population de la zone ?

POST /services/v1/zone/stats, avec la même durée et le même mode, ou un rayon, ou le contour lui-même : population, ménages, ménages pauvres, niveau de vie moyen et IRIS couverts, sommés sur les carreaux Filosofi 200 m (INSEE, millésime 2021). Plan Growth.

Fluide ou heure de pointe ?

circulation=fluide (défaut) ou circulation=pointe. En pointe, les vitesses modélisées de l'heure de pointe du matin réduisent le contour ; la réponse rappelle le réglage dans portee.circulation.

Comment savoir si deux de mes points de vente se cannibalisent ?

POST /services/v1/zone/compare décrit les deux emplacements comme sur /zone/stats et calcule ce qu'ils partagent : chevauchements donne la population, les ménages et le potentiel comptés dans les deux zones à la fois, tandis que exclusif donne ce que chacune est seule à couvrir. Une part de chevauchement élevée au regard du part_population de chaque zone signale une cannibalisation forte entre les deux sites. Voir Comparer des emplacements pour l'exemple complet et la lecture du classement.

Aller plus loin

• Démo — Zone de chalandise — tester en direct sans écrire de code
• Cas d'usage — Zone de chalandise
• Article — Zone de chalandise : définition et méthodes de calcul — la notion, les zones primaire à tertiaire, isochrone ou rayon
• Article — Créer une zone de chalandise
• Référence complète — GET /locations/search et POST /zone/stats en détail, tous les paramètres
• Mes lieux — créer et alimenter le référentiel de sites interrogé ici
• Attribution OSM — la mention à afficher dès qu'une duree entre en jeu

Sources des données mobilisées par ce guide : le référentiel BAN officiel (IGN) et l'INSEE (IRIS, grille Filosofi) pour les adresses ; OpenStreetMap, sous licence ODbL, pour le réseau routier qui dessine l'isochrone ; l'INSEE (carroyage Filosofi 2021) et l'IGN (Contours IRIS 2026) pour les chiffres de zone.