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 un 200 avec 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.