Quand vous hésitez entre plusieurs adresses, ou que vous ajoutez un point
de vente à un réseau existant, la question n'est pas seulement « combien
d'habitants dans chaque zone ? » mais « combien de ces habitants sont déjà
couverts par une autre de mes zones ? ». Une nouvelle route y répond :
POST /zone/compare.
Vous envoyez de 2 à 10 zones, chacune décrite comme sur /zone/stats — une
durée de trajet, un rayon ou un contour, avec son propre centre — et un
identifiant si vous le souhaitez. La réponse rend, pour chaque zone,
exactement le bloc de /zone/stats (population, profil, CSP, potentiel),
plus deux choses que vous ne pouvez pas calculer sans les carreaux :
exclusif— la population, les ménages et le potentiel que la zone est seule à couvrir, hors de tout chevauchement avec les autres zones de la requête, etpart_population, la part de la zone que cela représente ;chevauchements— pour chaque paire de zones qui se recouvrent, ce que les deux comptent deux fois.
S'y ajoute classement : vos identifiants triés sur le critère de votre
choix — population par défaut, population_exclusive, potentiel_theorique
ou potentiel_exclusif (les deux derniers demandent un coefficient,
appliqué à toutes les zones).
curl -s -X POST "https://api.trustydata.app/services/v1/zone/compare" \
-H "Authorization: Bearer VOTRE_CLE" -H "Content-Type: application/json" \
-d '{
"zones": [
{"id": "part-dieu", "adresse": "Place Charles Béraudier 69003 Lyon", "duree": 10, "mode": "auto"},
{"id": "bellecour", "lat": 45.7578, "lon": 4.8320, "duree": 10, "mode": "auto"},
{"id": "villeurbanne", "adresse": "Gratte-Ciel, Villeurbanne", "rayon": 3}
],
"coefficient": 0.048,
"critere": "potentiel_exclusif"
}'
Trois candidats à Lyon, classés sur le potentiel exclusif : Bellecour, 364 582 habitants dont 156 964 qu'aucune autre zone ne couvre (43,1 %) ; Part-Dieu, 441 009 habitants mais 51 484 exclusifs seulement (11,7 %) ; Villeurbanne, 244 600 habitants, 55 515 exclusifs (22,7 %). Les deux isochrones se recouvrent largement : 207 618 habitants sont comptés à la fois dans Part-Dieu et dans Bellecour. La zone la plus peuplée n'est pas celle qui apporte le plus.
Comment l'exclusif est calculé. Comme « la zone moins l'union de toutes les autres », en une passe sur les carreaux — jamais comme « total moins les paires » : à trois zones et plus, un triple recouvrement serait retranché deux fois. Les sommes restent pondérées par la part de chaque carreau dans chaque région.
Ce qu'il faut savoir avant d'intégrer :
- plan Growth au minimum ; un appel compté, quel que soit le nombre de
zones (code de service
ZONE_COMPARE) ; - de 2 à 10 zones — au-delà, la réponse ne tiendrait plus dans la seconde, découpez ;
- une zone inatteignable rend des zéros, n'entre dans aucune paire et se classe dernière ;
- quand une zone précise est fautive,
detailest un objet qui la nomme :{"code": "portee_ambigue", "zone": "bellecour"}; quand c'est la requête entière, une chaîne comme sur/zone/stats; - ni le contour des exclusifs ni celui des intersections ne sont rendus, seulement leurs chiffres ;
- la mention
attribution(INSEE, IGN, et OpenStreetMap dès qu'une zone est une isochrone) est à reproduire avec tout chiffre affiché.
Guide : https://trustydata.fr/docs/zone-de-chalandise.html#comparer et
https://trustydata.fr/docs/zone-de-chalandise.html#comparer-regles —
référence POST /zone/compare : https://trustydata.fr/docs/reference.html.
Disponible depuis la version 1.14 de la plateforme. Un réseau de plus de dix points de vente, un critère composite, le contour des zones exclusives : si c'est ce qu'il vous manque, dites-le nous par la page de contact.