Regional market definition
The Woodfine location intelligence map organises co-location clusters into two spatial containers: the settlement with co-location presence (a coverage statistic) and the Regional Market (a tighter object reserved for settlements with meaningful concentrations of co-located retail). A third, coarser container — the Metro Market — provides context at the major-metropolitan level. This article defines each object, states the rule that produces it, and distinguishes between what each count measures and what it does not.
The two objects currently called Regional Markets
The pipeline resolves each co-location cluster to an incorporated municipal or CSD polygon using RegionEngine.resolve_market() — a point-in-polygon assignment against TIGER 2023 places for the US, GISCO LAU 2021 plus GADM GBR for the EU and UK, with rural co-locations resolving to their containing municipality. A settlement becomes a Regional Market object the moment one co-location falls inside its polygon.
Under this permissive rule, the count of Regional Market objects approximates the count of distinct settlements that contain any co-location at all. At the 2026-05-22 build, the pipeline produces approximately 3,011 settlements (North America and EU/UK) with co-location presence, of which 2,986 are published in the gateway's regional-markets.json and 2,942 carry the high-confidence geocoding flag.
That is a coverage statistic. It records how widely the tracked anchor chains are observed. It does not identify where retail demand actually concentrates, because a floor of one co-location admits every town with a single qualifying co-location on exactly the same terms as a metropolitan area with dozens.
The distinction: coverage versus market
Two failure modes follow from conflating coverage with market:
Single-anchor settlements dominate the population. A town with one qualifying co-location is, under the current rule, the same object class as a metro holding many. The label "Regional Market" implies concentrated retail demand; the rule admits the single-anchor case. The headline count is therefore inflated by exactly the cases that carry the least decision value for site selection or investment.
The count reads as an artefact of the floor, not the geography. A reviewer can move the count up or down simply by arguing the floor, which is the classic sign that the threshold — not the data — is doing the work. This is the same failure class as the DBSCAN parameter sensitivity documented in the co-location tiering and scoring methodology, where parameter sweeps move the North American cluster count across a wide range without any change to the underlying retailer data.
mkt_conf does not resolve this. It is geocoding precision — specifically the quality of the boundary assignment — not market quality, and must not be presented as a ranking or a quality signal.
Recommendation, corrected: composition floors mean anchor composition, not count
This section originally proposed a count-based floor — "a minimum number of co-locations within a polygon" — as the cheap, defensible fix. That recommendation was wrong, and is retracted here rather than left standing. The error: a settlement can clear a count floor of one and still be a genuinely strong market, if its single co-location cluster is itself a convergence of multiple independent anchor categories — a hypermarket, a hardware retailer, and a warehouse club within one tight cluster is a T1 by the tier system's own definition (see "Regional Markets Intelligence System" on the projects wiki), and a T1 is exactly the concentrated-demand signal the term "market" is supposed to carry. Conversely, a settlement that clears a count floor of two by holding two separate, single-anchor (T3) clusters is not obviously stronger than the single-T1 case a count floor would exclude. Counting how many co-location events a settlement has and counting how strong each one is are different questions, and only the second one is what "Regional Market" should mean. Composition — the anchor-category mix within a cluster — is already captured correctly by the T1/T2/T3 tier classification; a floor built on cluster count instead of cluster tier repeats the exact coverage-versus-market conflation this article set out to fix.
The object split below still holds — a permissive coverage catalog is a legitimate, honestly-labelled thing to publish, separate from a claim about market strength — but the tighter object's floor should be tier-based (e.g., "contains at least one T1 cluster, or clears a stated aggregate tier score"), not count-based.
Settlement with co-location presence
- Definition. Any incorporated municipal or CSD polygon that contains at least one co-location.
- Count. The full approximately 3,011 (NA plus EU/UK). Stated as a coverage statistic with the honest gloss: "3,011 settlements across 13 countries contain at least one observed retail co-location."
- Role. Coverage map, footprint claim, and the base set from which the tighter object is drawn. Not the headline market count.
Regional Market
A settlement is promoted to Regional Market when its co-location clusters clear a stated tier-based floor, not a count floor — for example, "contains at least one T1 cluster" or "the aggregate tier score (T1×4 + T2×2 + T3×1) meets a stated minimum." This ties the term to cluster strength rather than cluster count, correctly admitting the single-strong-cluster case and correctly excluding the many-weak-clusters case that a count floor would get backwards.
An alternative, and analytically stronger, floor is a demand threshold: a Regional Market clears a stated catchment population or estimated annual spend threshold, tying the term to demand rather than supply density. This depends on the catchment and spend surfaces being trustworthy first (see the spend and population provenance and trade-area methodology write-ups); adoption is appropriate once those surfaces carry their uncertainty framing.
Whichever floor is chosen, the resulting Regional Market count must be re-derived and published alongside the floor and the rule that produced it — the count is not meaningful without both printed next to it.
If no floor is adopted, the minimum acceptable change is renaming: dropping "Regional Market" for the permissive object and calling it "settlements with co-location presence" on the map face, in the Method modal, and in this TOPIC. The term "market" carries an implied claim of concentrated demand that the one-co-location rule does not support on its own — though, per the correction above, a single co-location can support that claim if its tier is high enough.
The Top-400 co-locations — ranking-variable recommendation: adopted
The Top-400 is a list of co-locations (not Regional Markets) produced per region — North America as one region, Europe (UK, Nordics, Continental) as another — cut at 400. Each row carries a Regional Market column for context. It is the spine of the BentoBox detail view, where the rank shown is a continental-cutoff position.
This article originally flagged that the Top-400 ranking variable was not stated anywhere, and recommended publishing a composite explainable score as the most defensible long-term fix. That recommendation has since been adopted: the ranking now runs on a published composite score, tier_score × civic_multiplier × confidence_factor — tier_score weighting T1/T2/T3 cluster strength (4/2/1), a civic multiplier for medical or higher-education anchor presence, and a confidence factor for chain-data quality — with every driver visible, not a black box. See "Regional Markets Intelligence System" on the projects wiki for the full formula and its rationale. No further action is needed on this point; it is recorded here only so the history of the recommendation is legible.
Metro Market
The Metro Market is a coarser, contextual container: a major metropolitan area on a published reference list (US MSA/CBSA, Canadian CMA). A Regional Market nests inside at most one Metro Market and is never dissolved into it. Metro Market is context only — it is never the co-location or ring zoom level and never a breadcrumb level. Raising the Regional Market floor does not affect the Metro Market layer.
What does not change
The boundary resolution rule — Sherwood Park resolves to its containing polygon (Strathcona County) under the uniform "one rule, no exceptions" boundary policy confirmed 2026-05-22 — is not altered by any floor change. The deleted Nominatim override for that settlement is not reinstated.
One wiki TOPIC per Regional Market (on projects.woodfinegroup.com) remains the article unit, with a section per co-location inside it. Raising the Regional Market floor reduces the number of stub TOPICs — single-anchor settlements no longer generate a thin market article — which is a content-quality improvement.
Counts stated honestly
Every count below is reported with the rule that produced it. Figures are as of the most recent build referenced in the artifact registry and must be re-derived whenever the floor or the boundary set changes.
| Object | Rule | Count | What it measures |
|---|---|---|---|
| Settlements with co-location presence | ≥1 co-location in polygon | ~3,011 (NA + EU/UK, 2026-05-22 build) | Coverage and footprint |
| Regional Markets (tier-based floor, corrected recommendation) | ≥1 T1 cluster, or a stated aggregate tier score | To be re-derived on adoption | Concentrated co-location, correctly admitting single-strong-cluster markets |
| Published RM objects (gateway, later build) | Permissive rule (≥1 co-location), unchanged | 4,436 (2026-05-30 build, 18 countries — see "Regional Markets Intelligence System" on the projects wiki) | Coverage; grown by dataset expansion, not by a floor change |
| Top-400 co-locations (per region) | Composite score — tier × civic × confidence, published | 400 NA + 400 EU | Ranked candidate sites; adopted per the recommendation above |
| NA co-locations (DBSCAN) | eps/minPts/IoU — sensitive | 226–476 across parameter sweep | Cluster count (descriptive) |
Two honesty notes belong in the Method modal alongside this table:
- The Regional Market count under a tier-based floor will differ from the raw settlement count in both directions — it drops many weak, low-tier settlements but keeps every single-cluster T1 settlement a naive count floor would have excluded. Neither direction is a regression; a tier-based count is simply a different, more defensible measurement than either the raw coverage count or a count-based floor.
mkt_confis geocoding precision, not market quality, and is not a ranking variable.
See also
- co-location tiering and scoring — how tiers and the planned strength score are computed for each co-location inside a Regional Market
- trade-area methodology — how the trade area for each co-location is defined
- spend and population provenance — the estimation chain for population and spend figures attributed to each co-location
- app-orchestration-gis — the orchestration layer that resolves co-locations to Regional Markets