territories

`GET /territories/{id}/{version}/layers/{addr}/{file}`: a content-addressed layer blob, streamed with a strong BLAKE3 ETag, single-range `Range` support and immutable cache headers.

Unlike the small metadata routes, layer blobs are ~1 GB each, so they are byte-metered against the calling identity's monthly download allowance ([DownloadMeter]). Provisional keys are blocked (403); operator (admin) keys, which carry no identity, are not metered.

get/territories/{id}/{version}/layers/{addr}/{file}

Request

  • Base URL: https://api.mapmap.ai
  • URL: https://api.mapmap.ai/territories/{id}/{version}/layers/{addr}/{file}
  • Auth: one of:
    • HTTP bearer
    • API key in query parameter api_key

Path parameters

idstring required

Territory id

versionstring required

Published package version

addrstring required

Blob address: 16 lowercase hex chars of the layer's BLAKE3

filestring required

Blob file name, e.g. valhalla.tar.zst

Response

The layer blob (tar + zstd)

Changes

No recorded changes to this operation across all 1 revision of this API.