TrustyData

 ⟨1124 unchanged words⟩  section Activités, avec ses hypothèses et limites. La zone se décrit d'UNE seule façonDepuis :octobre soit2026, `minutes`le (1bloc à`defaillances` 30)rend, depar trajetannée depuis le centre, avec `mode` `car`2017 (voiture, défaut`annees`), `walking` ou `cycling` ;et soitpar `radius_km`activité (1 à 50) à volles d'oiseau.mêmes Avec14 `minutes`familles et `mode` `car`,sous-familles `traffic`que choisit`activites`), lesdeux conditionsséries : `free` (défaut,les circulationPROCÉDURES libre)COLLECTIVES oudu `peak`BODACC (heure de pointe`procedures.liquidation`, du`.redressement`, matin`.sauvegarde`, un`.autres`), jourcomptées ouvrésur verschaque 08:30établissement —de vitessesl'entreprise typiquessitué modéliséesdans parla classezone de— voieune etchaîne densité,en pasliquidation decompte traficune tempsfois réel).par `peak`magasin est—, refuséet àles piedarrêts etd'activité à(`arrets` vélo,: etfermetures peutSIRENE répondresans «reprise indisponiblede »la simême laactivité plateformeà nela l'amême pasadresse encore(par ouvert.un Leautre centreétablissement, estquel SOITqu'en unesoit adressele libreSIREN) (`address`,ni unautre nométablissement dedu communemême suffitSIREN), SOIT. un`defaillances` couple= `lat`+`lon`liquidation WGS84+ —redressement, jamaisau lessens deuxde ;la `point_central.precision`Banque ditde commentFrance il: aune étésauvegarde résolu.n'est PlafondPAS deune surfacedéfaillance, :ne 10jamais 000l'additionner. km².Les Uneprocédures zonesont sansun habitantPLANCHER (mer,établissements étranger)positionnés rendseulement), desles zérosar

 ⟨164 unchanged words⟩ :"Référentiel des indices — UN réglage pour DEUXTROIS blocs, `csp`, `activites` et `activites``defaillances` : `france` (défaut) ou `department` (département  ⟨36 unchanged words⟩ 

 ⟨659 unchanged words⟩ sont couverts), pas une zone sans vente. Depuis septembre 2026, le bloc `activites` compte les ÉTABLISSEMENTS de la zone par famille et sous-famille d'activité (boulangeries, tabac, comptabilité…), avec une densité pour 10 000 habitants et un indice contre la FRANCE par défaut — ou contre le département dominant de la zone si `reference` vaut `department`, `activites.reference` disant lequel des deux a servi. C'est un PLANCHER : seuls les établissements actifs et géolocalisés y figurent — `fiabilite.taux_localisation` dit quelle part cela représente. Ne jamais présenter ces comptes comme exhaustifs, ni les appeler des concurrents. `familles[]` porte les 14 familles, toutes, même à zéro ; chacune ses `sous_familles[]`, dont celles à zéro sont omises. Chaque poste donne `cle`, `libelle`, `etablissements`, `part` (de `total`), `densite` (pour 10 000 habitants), `reference_densite` et `indice` (100 = la référence, que `reference.libelle` nomme). L'indice est moins biaisé que l'effectif : calculé de la même façon des deux côtés, le sous-compte s'y annule en grande partie — préférer l'indice pour comparer, l'effectif pour dénombrer. `indice` vaut `null` sous `fiabilite.etablissements_min` (5) établissements dans le poste, sur une zone sans habitant, et quand la référence n'a rien à comparer — soit qu'elle n'ait aucun établissement dans ce poste (`reference_densite` à `0.0` sur une sous-famille, `null` sur une famille), soit qu'aucune population de référence ne soit connue (`reference_densite` à `null`). `densite` est servie dès que la zone a des habitants, et vaut `null` sur une zone qui n'en a aucun (mer, étranger) — ne jamais l'annoncer comme toujours présente ; `etablissements` et `part`, eux, le sont. `fiabilite.indices_fiables` est faux sous 1 000 habitants. Deux limites de la nomenclature NAF à répercuter telles quelles : le tabac est sous-compté (un bar-tabac est codé en débit de boissons et reste donc dans « Cafés, hôtels, restaurants »), et la sous-famille « Rééducation, appareillage et pédicures-podologues » réunit ces trois métiers sans permettre d'en isoler un seul. Le détail des codes NAF de chaque sous-famille est dans le guide « Zone de chalandise », section Activités, avec ses hypothèses et limites. La zone se décrit d'UNE seule façon :  ⟨154 unchanged words⟩  chiffre cité (INSEE Filosofi, IGN Contours IRIS ; SIRENE (INSEE) pour les établissements du bloc `activites` ; DGFiP DVF pour les prix immobiliers ; ⟨9 unchanged words⟩ 

 ⟨161 unchanged words⟩ }],"default":null,"description":"Référentiel dedes l'indiceindices d'affinité— CSPUN réglage pour DEUX blocs, `csp` et `activites` : `france` (défaut) ou `department` (département  ⟨36 unchanged words⟩ 

 ⟨94 unchanged words⟩ n'est pas une donnée inexistante : il peut être hors planrelever —d'un proposepalier alorssupérieur la— montéeson deabsence planne plutôtprouve quepas d'affirmerl'inexistence quede la donnée n'existe pas.donnée. Les dirigeants sont des données personnelles issues du ⟨55 unchanged words⟩ 

 ⟨49 unchanged words⟩  meilleur établissement (le siège de préférence). Ne3 disétablissements doncd'un pasmême «SIREN 3ne entreprisesfont trouvéesdonc »pas pour« 3 établissements d'unentreprises mêmetrouvées SIREN.». Par défaut, un résultat par entreprise si  ⟨12 unchanged words⟩ par `siren` ; force ce comportement avec `group_by_company`. Lis `classement_pertinence` se lit avant de présenter un « meilleur match »  ⟨28 unchanged words⟩ — c'est la loi, pas une donnée manquante, :et rien ne complètes'y jamaiscomplète de mémoire. Une liste vide fait autorité : ⟨24 unchanged words⟩ 

Vérifie et normalise une adresse postale française contre le référentiel géographique officiel (BAN). Renvoie un verdict (match_exact ⟨75 unchanged words⟩ 

 ⟨343 unchanged words⟩  d'affaires ; sans coefficient il vaut `null`, une valeur qui ne pass'invente l'inventer.pas. Le guide « Zone de chalandise » donne ⟨11 unchanged words⟩ La CSP est elle aussi une estimation : ne citer aucun indice d'unen'est exploitable sur une zone dont `csp.fiabilite.indices_fiables` est faux. Une zone inatteignable  ⟨37 unchanged words⟩ ; dix isochrones prennent une à deux secondes. Reproduire `attribution` avecaccompagne tout chiffre cité (INSEE Filosofi et Recensement  ⟨17 unchanged words⟩ 

 ⟨286 unchanged words⟩ les carreaux au prorata de leur population — direun «indice estiméest »donc enun citantordre unde indicegrandeur estimé, et neil citern'y en a aucun indiced'exploitable quand `csp.fiabilite.indices_fiables` est faux (moins de 1  ⟨106 unchanged words⟩ 0,048) ; sinon il vaut `null`, ne pas l'inventer. Ne jamais le présenterune commevaleur unqui chiffrene d'affairess'invente :pas. c'estC'est un potentiel théorique, pas une prévision de  ⟨152 unchanged words⟩ un appel compté quelle que soit la portée. Reproduire `attribution` avecaccompagne tout chiffre cité (INSEE Filosofi, IGN Contours ⟨11 unchanged words⟩ 

GetDétail Addressd'une Detailsadresse

{"additionalProperties":false,"properties":{"address_id":{"description":"Identifiant d'adresse (champ `id`) renvoyé par verify_address ou search_address.","type":"string"}},"required":["address_id ⟨2 unchanged words⟩ 

GetFiche Companyd'un Detailsétablissement ou d'une entreprise

{"additionalProperties":false,"properties":{"company_id":{"description":"SIRET (14 chiffres) de l'établissement, ou SIREN (9 chiffres) pour le siège de l'entreprise.","type":"string"}},"required":["company_id ⟨2 unchanged words⟩ 

RouteMatrice Matrixde temps et de distances

{"additionalProperties":false,"properties":{"destinations":{"description":"Points d'arrivée (1 à 25), même forme.","items":{"description":"A ``RoutePoint`` is EITHER ⟨37 unchanged words⟩ {"type":"null"}],"default":null,"description":"Latitude WGS84, avec `lon` (XOR address)."},"lon":{"anyOf":[{"maximum" ⟨5 unchanged words⟩ {"type":"null"}],"default":null,"description":"Longitude WGS84, avec `lat` (XOR address)."}},"type":"object"},"type": ⟨5 unchanged words⟩ {"type":"null"}],"default":null,"description":"Mode de déplacement : `car` (défaut), `walking` ou `cycling`."},"origins":{"description":"Points de départ (1 à 25), chacun une adresse libre OU un couple `lat`/`lon`.","items":{"description":"A ``RoutePoint`` is EITHER ⟨37 unchanged words⟩ {"type":"null"}],"default":null,"description":"Latitude WGS84, avec `lon` (XOR address)."},"lon":{"anyOf":[{"maximum" ⟨5 unchanged words⟩ {"type":"null"}],"default":null,"description":"Longitude WGS84, avec `lat` (XOR address)."}},"type":"object"},"type": ⟨6 unchanged words⟩ 

SearchRechercher Addressdes adresses

{"additionalProperties":false,"properties":{"details":{"default":true,"description":"Inclure les blocs détaillés (position GPS et Lambert 93, IRIS, grille statistique — selon le plan). Défaut vrai.","type":"boolean"},"limit":{"default":10,"description":"Nombre maximal de résultats (défaut 10).","type":"integer"},"query":{"description":"Début d'adresse ou adresse partielle à compléter (numéro, voie, commune…).","type":"string"}},"required":[" ⟨3 unchanged words⟩ 

SearchRechercher Companydes entreprises et établissements

 ⟨7 unchanged words⟩ {"type":"null"}],"default":null,"description":"Filtre sur la voie (recherche floue) ; exige `query`."},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filtre sur la commune (recherche floue) ; exige `query`."},"group_by_company":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Vrai : un résultat par entreprise (son meilleur établissement, le siège de préférence) ; faux : un par établissement. Absent : défaut de l'API selon la recherche."},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Recherche par proximité (plan Growth) : latitude WGS84 du centre, avec `lon` et `radius_m`."},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Longitude WGS84 du centre de la recherche par proximité, avec `lat` et `radius_m`."},"naf_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filtre : code NAF/APE de l'activité, ex. `62.02A`."},"page":{"default":1,"description":"Numéro de page, à partir de 1.","type":"integer"},"per_page":{"default":10,"description":"Résultats par page (défaut 10, plafond 25).","type":"integer"},"postal_code":{"anyOf" ⟨2 unchanged words⟩ {"type":"null"}],"default":null,"description":"Filtre : code postal exact."},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nom, dénomination, sigle ou enseigne ; un SIREN (9 chiffres) ou un SIRET (14 chiffres) donne une correspondance exacte."},"radius_m":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Rayon en mètres autour du centre (jusqu'à 50 km) ; plan Growth."},"siren":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Tous les établissements d'une unité légale (SIREN, 9 chiffres)."},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filtre : `active` (établissement en activité) ou `closed` (fermé)."}},"type":"object"}

SearchRechercher Localitydes communes

 ⟨10 unchanged words⟩ {"type":"null"}],"default":null,"description":"Filtre : codes de département (liste, ex. `62`, `2A`). À préférer au nom."},"department_name":{"anyOf":[{"items" ⟨4 unchanged words⟩ {"type":"null"}],"default":null,"description":"Filtre : noms de département (liste ; orthographe normalisée automatiquement)."},"details":{"default":true,"description":"Inclure les détails de chaque commune (codes, population, coordonnées). Défaut vrai.","type":"boolean"},"limit":{"default":20,"description":"Nombre maximal de résultats (défaut 20).","type":"integer"},"population_max":{"anyOf" ⟨2 unchanged words⟩ {"type":"null"}],"default":null,"description":"Filtre : population maximale (habitants)."},"population_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filtre : population minimale (habitants)."},"postal_code":{"anyOf":[{"items" ⟨4 unchanged words⟩ {"type":"null"}],"default":null,"description":"Filtre : codes postaux (liste)."},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nom de commune, code postal ou code INSEE, complet ou partiel. Optionnel si un filtre est donné."},"region_code":{"anyOf":[{"items" ⟨4 unchanged words⟩ {"type":"null"}],"default":null,"description":"Filtre : codes de région (liste)."},"region_name":{"anyOf":[{"items" ⟨4 unchanged words⟩ {"type":"null"}],"default":null,"description":"Filtre : noms de région (liste)."}},"type":"object"}

SearchAdresses Nearbyà proximité d'un point

 ⟨7 unchanged words⟩ {"type":"null"}],"default":null,"description":"Centre par adresse libre (un nom de commune suffit). Exclusif de `lat`/`lon`."},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Latitude WGS84 du centre, avec `lon` et sans `address`."},"limit":{"default":10,"description":"Nombre de résultats par page (défaut 10, plafond 50).","type":"integer"},"lon":{"anyOf" ⟨2 unchanged words⟩ {"type":"null"}],"default":null,"description":"Longitude WGS84 du centre, avec `lat` et sans `address`."},"offset":{"default":0,"description":"Décalage de pagination : reprendre à `pagination.next_offset` de la réponse précédente.","type":"integer"},"radius_m":{"description":"Rayon de recherche en mètres autour du centre.","type":"integer"}},"required":[" ⟨3 unchanged words⟩ 

VerifyVérifier Addresset normaliser une adresse

{"additionalProperties":false,"properties":{"address":{"description":"Adresse postale française en texte libre, telle que saisie (fautes, abréviations et accents manquants tolérés).","type":"string"},"details":{"default":true,"description":"Inclure les blocs détaillés (position GPS et Lambert 93, IRIS, grille statistique — selon le plan). Défaut vrai.","type":"boolean"},"max_results":{"default":5,"description":"Nombre maximal de candidats renvoyés (défaut 5).","type":"integer"}},"required":[ ⟨3 unchanged words⟩ 

ZoneComparer Comparedes zones de chalandise

 ⟨7 unchanged words⟩ {"type":"null"}],"default":null,"description":"Part du revenu disponible que le secteur capte (0 exclu à 1), appliquée à toutes les zones, exclusifs et paires ; requis par les critères de potentiel."},"rank_by":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Critère du classement : `population` (défaut), `exclusive_population`, `theoretical_potential` ou `exclusive_potential` — ces deux derniers exigent `coefficient`."},"reference":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Référentiel de l'indice d'affinité CSP de chaque zone : `france` (défaut) ou `department`."},"zones":{"description":"De 2 à 10 zones, chacune avec les arguments de zone_stats (centre + `minutes` ou `radius_km`) et un `id` optionnel.","items":{"description":"Une zone de `zone_compare` ⟨164 unchanged words⟩ {"type":"null"}],"default":null,"description":"Latitude WGS84 du centre, avec `lon` et sans `address`."},"lon":{"anyOf":[{"maximum" ⟨5 unchanged words⟩ {"type":"null"}],"default":null,"description":"Longitude WGS84 du centre, avec `lat` et sans `address`."},"minutes":{"anyOf":[{"type" ⟨90 unchanged words⟩ 

ZoneStatistiques Statsd'une zone de chalandise

 ⟨7 unchanged words⟩ {"type":"null"}],"default":null,"description":"Centre par adresse libre — un nom de commune suffit. Exclusif de `lat`/`lon`."},"coefficient":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Part du revenu disponible que le secteur capte (0 exclu à 1) ; déclenche `potentiel_theorique`."},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Latitude WGS84 du centre, avec `lon` et sans `address`."},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Longitude WGS84 du centre, avec `lat` et sans `address`."},"minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Portée isochrone : minutes de trajet depuis le centre (1 à 30). Exclusif de `radius_km`."},"mode":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Mode de déplacement de l'isochrone : `car` (défaut), `walking` ou `cycling` — avec `minutes` seulement."},"radius_km":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Portée rayon à vol d'oiseau, en km (1 à 50). Exclusif de `minutes`."},"reference":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Référentiel de l'indice d'affinité CSP : `france` (défaut) ou `department` (département dominant de la zone)."},"traffic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Conditions de circulation de l'isochrone : `free` (défaut) ou `peak` (heure de pointe modélisée) — avec `minutes` et `mode: car` seulement."}},"type":"object"}

 ⟨239 unchanged words⟩  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 ⟨95 unchanged words⟩ unités de consommation reconstituées). `potentiel_theorique` = revenu disponible estimé × coefficient`coefficient` n'est calculé que si un coefficient`coefficient` est passé, ce(0 exclu à 1 : la part du revenu disponible que cetle outilsecteur necapte permet— pasle encoreguide :« neZone pasde l'inventerchalandise » donne des repères par fonction de consommation, etrestauration ≈ 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  ⟨182 unchanged words⟩ 

 ⟨8 unchanged words⟩ ":"null"}],"default":null},"coefficient":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null},"lat":{"anyOf":[{"type":"number ⟨28 unchanged words⟩ radius_km":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null},"reference":{"anyOf":[{"type":"string"},{"type":"null"}],"default ⟨11 unchanged words⟩