GIS orchestration application
app-orchestration-gis is the stateless spatial analytics engine that performs linear-geometry calculations and coordinate mapping to produce the Woodfine co-location rankings and the interactive map at gis.woodfinegroup.com. The application holds no canonical data — it operates as a pure function from cleansed cluster files to ranked geo-tiles, so a lost instance can be re-provisioned by pointing a fresh process at the immutable Totebox data layer with no state migration. It runs on os-orchestration and composes with Business clustering and Places filtering to produce its input datasets.
Tier Assignment
The engine assigns every cluster one of four tiers by testing it against the retail co-location tier methodology — composition, catchment-population rank, civic support, and non-overlap with stronger neighboring clusters. Tier assignment is a pass/fail classification against fixed gates, not a composite numeric score.
Tile Generation
The engine compiles scored output into vector tile assets for delivery to the interactive map:
- Vector tiles: PMTiles format for client-side rendering without a dedicated tile server [pmtiles-spec]
- Rendering: MapLibre GL JS processes the tiles client-side at high performance [maplibre-gl-js]
- Visual tiers: Spatial convergence across anchor categories (primary, hardware, warehouse, civic) maps to the four-tier visual classification on the map surface, per the tier methodology above
Stateless Architecture
The application holds no canonical data. It operates as a pure function: cleansed cluster files enter, ranked geo-tiles exit. If the application instance is lost, the entire analytics environment can be re-provisioned by pointing a fresh instance at the immutable data layer — no state migration required.
See also
- Location intelligence substrate — the rendering layer that serves tiles produced by this engine
- Business clustering — the clustering service that groups POI data into co-location clusters
- Places filtering — the places filtering service that prepares cleansed input data
- Retail co-location tier methodology — the tier methodology implemented by the engine
- Location intelligence platform — the platform article covering the full GIS deployment