zone_stats

Rend ce que l'INSEE sait de ceux qui habitent une zone de chalandise : population, menages, menages_pauvres (sous le seuil de pauvreté), niveau_de_vie_moyen (euros par personne et par an — une moyenne, jamais une médiane), iris_couverts (quartiers IRIS touchés), surface_km2, et carreaux {total, estimes}. Les chiffres sont des sommes des carreaux INSEE Filosofi de 200 m pondérées par la part de chaque carreau dans la zone ; carreaux.estimes compte ceux que l'INSEE a imputés au titre du secret statistique — c'est la norme du fichier (souvent la majorité hors des villes denses), pas un défaut de la zone. Depuis la plateforme 1.11, la réponse porte aussi le PROFIL de la zone, en trois blocs de {effectif, part} : ages (onze tranches INSEE 0_3 … 80_plus et inconnu, parts rapportées à population), menages_profil (personnes seules, 5 personnes et plus, propriétaires, monoparentaux, en collectif, en maison, parts rapportées à menages, plus surface_moyenne_m2) et logements (total, cinq périodes de construction et sociaux, parts rapportées à logements.total). Les parts sont en pourcentage au dixième, calculées avant arrondi ; les effectifs sont arrondis séparément, leur somme peut différer du total de quelques unités. Depuis la plateforme 1.12, le bloc csp donne les huit catégories socioprofessionnelles des 15 ans et plus (agriculteurs, artisans_commercants, cadres, professions_intermediaires, employes, ouvriers, retraites, autres_inactifs), chacune en {effectif, part, indice} : l'indice vaut 100 × part de la zone / part de la France (100 = la moyenne nationale, 150 = une fois et demie) — ou du département qui pèse le plus dans la zone si reference vaut department (défaut france), son code étant rendu dans csp.reference.code. C'est une estimation, pas une mesure : les CSP ne sont diffusées qu'à l'IRIS et sont réparties sur les carreaux au prorata de leur population — dire « estimé » en citant un indice, et ne citer aucun indice quand csp.fiabilite.indices_fiables est faux (moins de 1 000 personnes de 15 ans et plus : la zone recopie le profil d'un ou deux IRIS). Le bloc potentiel_depense donne les unités de consommation reconstituées, le revenu disponible estimé des habitants (revenu_disponible_estime, en euros par an) et revenu_disponible_par_menage — le chiffre à citer de préférence, en disant « estimation » (niveau de vie écrêté, revenus 2021, unités de consommation reconstituées). potentiel_theorique = revenu disponible estimé × coefficient n'est calculé que si coefficient est passé (0 exclu à 1 : la part du revenu disponible que le secteur capte — le guide « Zone de chalandise » donne des repères par fonction de consommation, restauration ≈ 0,048) ; sinon il vaut null, ne pas l'inventer. Ne jamais le présenter comme un chiffre d'affaires : c'est un potentiel théorique, pas une prévision de chiffre d'affaires. La zone se décrit d'UNE seule façon : soit minutes (1 à 30) de trajet depuis le centre, avec mode car (voiture, défaut), walking ou cycling ; soit radius_km (1 à 50) à vol d'oiseau. Avec minutes et mode car, traffic choisit les conditions : free (défaut, circulation libre) ou peak (heure de pointe du matin, un jour ouvré vers 08:30 — vitesses typiques modélisées par classe de voie et densité, pas de trafic temps réel). peak est refusé à pied et à vélo, et peut répondre « indisponible » si la plateforme ne l'a pas encore ouvert. Le centre est SOIT une adresse libre (address, un nom de commune suffit), SOIT un couple lat+lon WGS84 — jamais les deux ; point_central.precision dit comment il a été résolu. Plafond de surface : 10 000 km². Une zone sans habitant (mer, étranger) rend des zéros, pas une erreur. Plan minimum : Growth ; un appel compté quelle que soit la portée. Reproduire attribution avec tout chiffre cité (INSEE Filosofi, IGN Contours IRIS ; OpenStreetMap ODbL quand la portée est une durée).