Get a vector tile
One Mapbox Vector Tile of boundaries. Each feature carries the area's code, its name and a numeric id. Values aren't baked in, so one set of tiles works for every measure.
/map-resources/{geography}/{release}/tiles/{z}/{x}/{y}.mvtGood to know
- A tile with no areas in it is a
204, which is a normal answer rather than an error. - Colour areas by fetching values for tiles and joining them on
id.
geographystringrequiredA geography type id, e.g.
constituencyorward.releasestringrequiredA boundary release id, e.g.
2024-07-uk-bgc, orlatestfor the geography's newest release: the one/boundary-releases:resolvechooses for the furthest date. A response tolatestnames the release it read inContent-Location. A geography whose newest month holds several releases that differ in more than coverage, or that has a release whose id carries no month, is refused with409and the releases that could be newest.zintegerrequiredZoom level, within the range the descriptor publishes.
xintegerrequiredTile column at this zoom.
yintegerrequiredTile row at this zoom, counted from the north.
Returns
stringThe tile, gzipped.
- 400A query parameter is malformed or its cursor is not valid for this result set.
- 404No resource matches that identity.
- 503The referenced build artifact has not been built yet.
Every error has the same shape. See Errors for how to handle them.
Show the precise behaviourHide the precise behaviour
A Mapbox Vector Tile carrying the boundaries layer, gzipped as the archive stores it. Each feature has the area's code, its name and a stable integer id a renderer can hold state against. Values are not in the tile: one tileset serves every measure, and a value is joined in the renderer. A tile inside the published zooms that covers no area is answered 204, which is an ordinary answer rather than a failure; a zoom the resource does not publish is 404, and a renderer should over-zoom past the last one instead.