Short-lived signed URLs for the vector basemap, plus terrain tiles for Outdoor-style contour lines.
Terrain DEM tile (for Outdoor-style contour lines).
Raw elevation tiles that power the Outdoor style's contour lines. The @rijwind/sdk Map wires these up automatically when you use MapStyle.OUTDOOR. Integrating without the SDK? Point a contour generator such as maplibre-contour at this URL (Terrarium encoding, max zoom 12) and pass your key as ?key= — contour generators run in a web worker and can't send an Authorization header, so the key rides the query string (use an origin-restricted key). Tiles are Terrarium-encoded WebP.
Quota cost: free — terrain tiles are part of the map session, billed once when the session opens (see /tiles/v1/token).
path Parameters
zZoom level (0–12).
xTile column.
yTile row (an optional .webp/.png suffix is accepted).
Terrain DEM tile (for Outdoor-style contour lines). › Responses
Terrarium-encoded WebP terrain tile.
Sign a tile-server URL.
Returns a short-lived, IP-bound signed URL for the vector basemap. Feed it to MapLibre's pmtiles:// protocol handler. Pass a stable session id (one per map instance) so background URL refreshes within the session are billed once — the @rijwind/sdk tile-session helper manages this for you.
Quota cost: 1 unit per tile session; refreshes within the same session are free. Omit session to be billed per request instead.
query Parameters
sessionStable, client-minted identifier for the map instance (e.g. a UUID, [A-Za-z0-9_-], ≤128 chars). The first token for a session is billed 1 unit; subsequent tokens for the same session within the session window are free. Omit to be billed per request.
Sign a tile-server URL. › Responses
Signed URL.
expiresAtUnix timestamp (seconds) when the signature expires.
terrainUrlSigned URL for the optional terrain (elevation) archive — feed it to a
MapLibre raster-dem source with encoding: "terrarium" for hillshade
or 3D terrain. Shares this session's expiry; refresh both together.
Rendering terrain is part of the same tile session, so it adds no quota
cost.
urlSigned URL ready to feed to MapLibre's pmtiles:// protocol handler.