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. Adding the live traffic layer (?traffic=) costs 1 extra unit per session. The response also always carries a buildings block — access to the 3D buildings tilesets, free within the session (the SDK consumes it when 3D buildings are shown).
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.
trafficOpt this session into the live traffic layer: 1/true for every available country, or a comma-separated ISO country list (e.g. NL). Adds a traffic block to the response and 1 unit to the session; refreshes stay free.
Sign a tile-server URL. › Responses
Signed URL.
Access descriptor for the 3D-buildings tilesets. Always included —
rendering 3D buildings is part of the same tile session, so it adds
no quota cost. Compose the per-country tileset URL as
{baseUrl}/{CC}/tileset.json?{query} and append the same query to
every tile it references. Refresh together with the tile URLs.
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.
satelliteBaseUrlSigned URL for the global base imagery archive (raster, z0–7) — ocean bathymetry and polar ice. Layer it BELOW the satellite source: the satellite mosaic covers land only, so this is what fills open water and the poles. Same session, no extra quota cost.
satelliteBesUrlSigned URL for the Caribbean Netherlands aerial archive (raster, z13–21). A separate source from the mainland one — it reaches a deeper zoom — layered the same way. Same session, no extra quota cost.
satelliteNlUrlSigned URL for the high-resolution Netherlands aerial archive (raster, z13–17) — layer it above the global satellite source. Same session, no extra quota cost.
satelliteOceanUrlSigned URL for the water-only overlay (raster, z0–7). Draw it ABOVE the satellite source and fade it out past ~z9: the satellite mosaic covers water poorly, so this renders the sea instead. Same session, no extra quota cost.
satelliteUrlSigned URL for the global satellite imagery archive (raster, z0–13).
Feed it to a MapLibre raster source for the Satellite / Hybrid
styles. Present once satellite imagery is available on the account's
region; rendering it is part of the same tile session, so it adds no
quota cost. Refresh together with the tile URLs.