L'annonce de la démo se terminait sur une réserve : l'API traçait la zone mais ne disait pas qui y habitait, et c'était le chantier suivant. Le voici.
POST /zone/stats rend, pour une zone, ce que l'INSEE sait de ceux qui y
vivent : population, ménages, ménages sous le seuil de pauvreté, niveau de
vie moyen par personne et le nombre de quartiers IRIS que la zone touche.
curl -s -X POST "https://api.trustydata.app/services/v1/zone/stats" \
-H "Authorization: Bearer VOTRE_CLE" \
-H "Content-Type: application/json" \
-d '{"adresse": "Lyon", "duree": 15, "mode": "auto"}'
{
"surface_km2": 136.8,
"population": 737125,
"menages": 362325,
"menages_pauvres": 54799,
"niveau_de_vie_moyen": 27473,
"iris_couverts": 367,
"carreaux": {
"total": 3064,
"estimes": 690
},
"source": {
"filosofi_millesime": 2021,
"contours_iris_millesime": 2026
},
"attribution": "Source : INSEE, Filosofi 2021 (carreaux 200 m) ; IGN, Contours IRIS 2026. Itinéraires : Données cartographiques © les contributeurs OpenStreetMap, sous licence ODbL — https://www.openstreetmap.org/copyright"
}
La zone se décrit d'une seule des trois façons : une durée de trajet
(duree 1 à 30 min, mode auto, pieton ou velo, depuis une adresse, une
commune ou des coordonnées — le même moteur et le même contour que
GET /locations/search?duree=), un rayon (rayon 1 à 50 km, à vol
d'oiseau), ou un contour GeoJSON (polygone) pris tel quel — par exemple
celui que locations/search?polygone=true vous a rendu.
Comment c'est calculé. Les chiffres sont des sommes des carreaux INSEE
Filosofi de 200 m qui tombent dans la zone, pondérées par la part de chaque
carreau à l'intérieur : un carreau à cheval sur la limite compte pour ce qui
est dedans. Le niveau de vie est une moyenne, parce qu'une moyenne
s'additionne et qu'une médiane non — vous ne trouverez pas de « revenu
médian » dans la réponse. carreaux.estimes dit combien de carreaux portent
des valeurs imputées par l'INSEE au titre du secret statistique : sur
l'exemple, 23 % ; hors des villes denses c'est souvent la majorité — la norme
du fichier, pas un défaut de la zone.
Ce qu'il faut savoir avant d'intégrer :
- plan Growth au minimum ; un appel compté par zone, quelle que soit la portée, isochrone comprise ;
- plafond de surface de 10 000 km² (
422 zone_trop_grande) ; une zone sans aucun carreau — en mer, à l'étranger — est un200avec des zéros ; - la mention
attribution(INSEE, Filosofi 2021 ; IGN, Contours IRIS 2026, et OpenStreetMap quand la portée est une durée) est à reproduire avec tout chiffre affiché ; - pas de tranche d'âge, pas de détail par IRIS, pas de croisement avec vos
sites :
locations/search?duree=le fait déjà pour les sites, et qui est client dans la zone, c'est votre fichier qui le sait.
Pour voir sans clé : la démo affiche désormais le chiffre sous le contour,
https://trustydata.fr/demo/zone-de-chalandise. Pour intégrer : le guide,
https://trustydata.fr/docs/zone-de-chalandise.html#stats, et la référence
POST /zone/stats, https://trustydata.fr/docs/reference.html.
Disponible depuis la version 1.8 de la plateforme. Les tranches d'âge, un détail par IRIS, ou un outil MCP pour poser la question à un assistant : si c'est ce qu'il vous faut, dites-le nous par la page de contact.