POST /zone/stats donnait le niveau de vie moyen par personne. Il rend désormais un bloc potentiel_depense qui répond à une question plus directe : quelle masse de revenu disponible les habitants de la zone ont-ils, au total et par ménage — et quelle part votre activité peut-elle théoriquement en capter.

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"}'
"potentiel_depense": {
  "unites_consommation": 525972,
  "revenu_disponible_estime": 14450034991,
  "revenu_disponible_par_menage": 39882,
  "coefficient": null,
  "potentiel_theorique": null
}

À 15 minutes en voiture du centre de Lyon : 39 882 € de revenu disponible estimé par ménage et par an. Le coefficient est le vôtre : la part du revenu disponible que votre secteur capte, entre 0 et 1 ; passez-le dans la requête ("coefficient": 0.15) et potentiel_theorique vaut le revenu multiplié par ce coefficient — ici environ 2,17 milliards d'euros par an ; avec 0,048, le repère du guide pour la restauration, environ 160 € par ménage et par mois. Sans coefficient, comme ci-dessus, potentiel_theorique vaut null et le reste du bloc est rendu quand même.

Comment c'est calculé, pour que vous puissiez le refaire. Le carroyage donne la somme des niveaux de vie, pas le revenu : le niveau de vie est le revenu du ménage divisé par ses unités de consommation. Nous reconstituons donc les unités de consommation de la zone (1 par ménage, 0,5 par personne de 14 ans et plus supplémentaire, 0,3 par enfant) à partir des ménages et des tranches d'âge, et multiplions le niveau de vie moyen par ce nombre. Sommer les niveaux de vie sans cette étape aurait surestimé la masse d'environ 40 % sur cet exemple.

Ce que ce n'est pas. Une estimation : niveau de vie écrêté par l'INSEE, revenus 2021, ménages ordinaires seulement, unités de consommation reconstituées. Et surtout, pas une prévision de chiffre d'affaires : une partie des dépenses se fait hors de la zone, et la zone reçoit des gens qui n'y habitent pas. C'est une masse théorique à comparer entre zones, pas un chiffre à mettre dans un compte de résultat.

Quel coefficient passer. Le guide donne une table de repères par fonction de consommation, calculée depuis les comptes nationaux 2024 de l'INSEE (structure de la dépense des ménages, épargne retirée), et la nomenclature complète en 151 lignes. L'API renvoie votre coefficient tel quel et ne le corrige jamais.

Plan Growth au minimum, un appel compté par zone, comme avant ; aucun champ existant ne bouge.

Guide : https://trustydata.fr/docs/zone-de-chalandise.html#potentiel, repères https://trustydata.fr/docs/zone-de-chalandise.html#potentiel-reperes, limites https://trustydata.fr/docs/zone-de-chalandise.html#potentiel-limites.

Disponible depuis la version 1.13 de la plateforme. Quel coefficient utilisez-vous pour votre secteur, et d'où vient-il ? Les repères du guide sont nationaux ; vos retours les affineront.