Skip to content

API — Tiles

The OGC API — Tiles surface. Serves the exact same collections as the Features API, but pre-pyramided as vector tiles (MVT) for map rendering. If you want the picture, use Tiles. If you want the data, use Features.

Tile matrix sets

A TileMatrixSet is a named pyramid scheme (projection + zoom levels + tile grid). ADAM ships with 13 of them, including:

  • WebMercatorQuad — the web standard, consumed by MapLibre, Mapbox, Leaflet, Google Maps, OSM. Use this unless you have a specific reason not to.
  • WorldCRS84Quad — global maps in EPSG:4326
  • UTM31WGS84Quad — regional UTM-based workflows
  • CDB1GlobalGrid — defence/CDB integrations
  • ...and 9 others

GET /tileMatrixSets

Lists all supported matrix sets.

GET /tileMatrixSets/{tileMatrixSetId}

Full definition of a single matrix set — zoom levels, tile dimensions, origin, CRS.

Vector tiles per collection

Every collection can be served as tiles on any supported matrix set.

GET /collections/{collectionId}/tiles

Lists the tilesets available for a collection (one per matrix set).

GET /collections/{collectionId}/tiles/{tileMatrixSetId}

Tileset metadata: bounds, zoom range, format, links to tiles and descriptors.

GET /collections/{collectionId}/tiles/{tileMatrixSetId}/{z}/{x}/{y}

A single vector tile.
Format MVT — application/vnd.mapbox-vector-tile
Addressing XYZ (standard web-map convention)
Empty tiles Return 204 No Content or an empty body

Ready-to-consume descriptors

For client integration without writing custom wiring, the API exposes two JSON descriptors:

GET /collections/{collectionId}/tiles/{tileMatrixSetId}/tilejson.json

A TileJSON document. Feed it directly to MapLibre or Mapbox as a vector source — no hand-rolled URL template needed.

GET /collections/{collectionId}/tiles/{tileMatrixSetId}/style.json

A Mapbox/MapLibre-compatible StyleJSON with sensible defaults (basemap + the collection rendered on top). Use as the full map style for a one-line preview.

See Display on a Map for full MapLibre recipes.

Built-in HTML map

For instant visual checks without writing a single line of code:

GET /collections/{collectionId}/tiles/{tileMatrixSetId}/map.html

This opens a live interactive map of the collection. Ideal for sharing a quick link to a colleague, or for sanity-checking a filter/collection pair.

Live references