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, et part_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, detail est 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.