UK Data AtlasAPI

Download all tiles

Every tile for a boundary release in a single PMTiles file. Host it on a CDN, or use it offline.

get
/map-resources/{geography}/{release}.pmtiles

Path parameters

  • geographystringrequired

    A geography type id, e.g. constituency or ward.

  • releasestringrequired

    A boundary release id, e.g. 2024-07-uk-bgc, or latest for the geography's newest release: the one /boundary-releases:resolve chooses for the furthest date. A response to latest names the release it read in Content-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 with 409 and the releases that could be newest.

Query parameters

  • Rangestringoptional

    One byte range of the file, as bytes=start-end, bytes=start- or bytes=-length. This is how a PMTiles client reads an archive: the header, then a directory, then only the tiles it needs. Several ranges in one request are not supported and get the whole file, as does an If-Range that no longer matches the ETag. Files stored gzipped (the GeoJSON downloads) are always sent whole.

Returns

string

The PMTiles archive.

When it goes wrong

  • 404No resource matches that identity.
  • 416The range starts past the end of the file. Content-Range gives the file's length as bytes */length.
  • 503The referenced build artifact has not been built yet.

Every error has the same shape. See Errors for how to handle them.

Technical notes

Show the precise behaviour

Every tile of the resource in a single PMTiles v3 file, for an offline map, a CDN or a warehouse. Its SHA-256 is the contentHash the descriptor publishes, so a drawing made from it can be tied to the Atlas release that produced it. It can also be read in place: the archive honours byte-range requests, so a map library such as MapLibre with the pmtiles protocol can draw from this URL directly, fetching only the tiles in view.