styles

`GET /styles/{spec}`: a compiled MapLibre style.

spec is <id>@<version>.json for an immutable version (cached forever) or <id>.json for the latest (60 s TTL).

With ?api_key=snk_…, the house basemap source is served as this gateway's keyed TileJSON instead of the keyless tiles CDN, which refuses browser pages outside mapmap.ai and localhost. The key is stamped the same way the /tiles documents stamp it, so a website that loads a hosted style with its key renders the basemap. Without a key in the query the body is exactly as before.

get/styles/{spec}

Request

  • Base URL: https://api.mapmap.ai
  • URL: https://api.mapmap.ai/styles/{spec}
  • Auth: none declared

Path parameters

specstring required

<id>@<version>.json (immutable) or <id>.json (latest)

Query parameters

api_keystring

Optional. When given, the basemap source points at this gateway's keyed tiles (/tiles/{territory}/tiles.json?api_key=…) so the style renders on any website. The style itself stays public.

renderstring

static: the variant the static-map renderer loads, with every customer source (a theme's sources) and the layers drawing from them removed, so a server-side render never requests a customer host. The removed ids are in the X-MapMap-Customer-Sources-Skipped header and metadata["mapmap:customer_sources_skipped"]. Omitted, the style is served as published.

Response

The compiled MapLibre style (spec v8)

object required

Changes

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