---
title: "Retrieve the definition of the specified tiling scheme (tile matrix set)."
method: GET
path: "/tileMatrixSets/{tileMatrixSetId}"
tags: ["Tiling Schemes"]
---

# Retrieve the definition of the specified tiling scheme (tile matrix set).

`GET /tileMatrixSets/{tileMatrixSetId}`

## Request

- Base URL: `https://app.chloris.earth` (the document declares no server; this is the origin it was published from)
- URL: `https://app.chloris.earth/tileMatrixSets/{tileMatrixSetId}`
- Auth: API key in query parameter `access_token`
- TypeScript: <https://skmtc.dev/chloris/apis/chloris-geospatial-s-dynamic-tiler/docs/tileMatrixSets/:tileMatrixSetId/get.ts> (a function with typed inputs; its response is checked against the schema)

OGC Specification: http://docs.opengeospatial.org/per/19-069.html#_tilematrixset

## Path parameters

- `tileMatrixSetId` 'CDB1GlobalGrid' | 'CanadianNAD83_LCC' | 'EuropeanETRS89_LAEAQuad' | 'GNOSISGlobalGrid' | 'LINZAntarticaMapTilegrid' | 'NZTM2000Quad' | 'UPSAntarcticWGS84Quad' | 'UPSArcticWGS84Quad' | 'UTM31WGS84Quad' | 'WGS1984Quad' | 'WebMercatorQuad' | 'WorldCRS84Quad' | 'WorldMercatorWGS84Quad', required: Identifier for a supported TileMatrixSet.

## Response `200`

Successful Response

- TileMatrixSet: Tile Matrix Set Definition A definition of a tile matrix set following the Tile Matrix Set standard. For tileset metadata, such a description (in `tileMatrixSet` property) is only required for offline use, as an alternative to a link with a `http://www.opengis.net/def/rel/ogc/1.0/tiling-scheme` relation type. ref: https://github.com/opengeospatial/2D-Tile-Matrix-Set/blob/master/schemas/tms/2.0/json/tileMatrixSet.json
  - `title` string, nullable: Title of this tile matrix set, normally used for display to a human
  - `description` string, nullable: Brief narrative description of this tile matrix set, normally available for display to a human
  - `keywords` string[], nullable: Unordered list of one or more commonly used or formalized word(s) or phrase(s) used to describe this tile matrix set
  - `id` string, nullable: Tile matrix set identifier. Implementation of 'identifier'
  - `uri` string, nullable: Reference to an official source for this tileMatrixSet
  - `orderedAxes` string[], nullable: Ordered list of names of the dimensions defined in the CRS
  - `crs` union, required: CRS model. Ref: https://github.com/opengeospatial/ogcapi-tiles/blob/master/openapi/schemas/common-geodata/crs.yaml Code generated using https://github.com/koxudaxi/datamodel-code-generator/
    - string
    - CRSUri: Coordinate Reference System (CRS) from URI.
      - `uri` string, uri, required: Reference to one coordinate reference system (CRS) as URI
    - CRSWKT: Coordinate Reference System (CRS) from WKT encoded as PROJJSON Object.
      - `wkt` object, required: An object defining the CRS using the JSON encoding for Well-known text representation of coordinate reference systems 2.0
    - CRSRef: CRS from referenceSystem.
      - `referenceSystem` object, required: A reference system data structure as defined in the MD_ReferenceSystem of the ISO 19115
  - `wellKnownScaleSet` string, uri, nullable: Reference to a well-known scale set
  - `boundingBox` TMSBoundingBox: Bounding box ref: https://github.com/opengeospatial/2D-Tile-Matrix-Set/blob/master/schemas/tms/2.0/json/2DBoundingBox.json
    - `lowerLeft` unknown[], required: A 2D Point in the CRS indicated elsewhere
      - unknown
    - `upperRight` unknown[], required: A 2D Point in the CRS indicated elsewhere
      - unknown
    - `crs` union: CRS model. Ref: https://github.com/opengeospatial/ogcapi-tiles/blob/master/openapi/schemas/common-geodata/crs.yaml Code generated using https://github.com/koxudaxi/datamodel-code-generator/
      - string
      - CRSUri: Coordinate Reference System (CRS) from URI.
        - `uri` string, uri, required: Reference to one coordinate reference system (CRS) as URI
      - CRSWKT: Coordinate Reference System (CRS) from WKT encoded as PROJJSON Object.
        - `wkt` object, required: An object defining the CRS using the JSON encoding for Well-known text representation of coordinate reference systems 2.0
      - CRSRef: CRS from referenceSystem.
        - `referenceSystem` object, required: A reference system data structure as defined in the MD_ReferenceSystem of the ISO 19115
    - `orderedAxes` string[], nullable: Ordered list of names of the dimensions defined in the CRS
  - `tileMatrices` TileMatrix[], required: Describes scale levels and its tile matrices
    - `title` string, nullable: Title of this tile matrix, normally used for display to a human
    - `description` string, nullable: Brief narrative description of this tile matrix set, normally available for display to a human
    - `keywords` string[], nullable: Unordered list of one or more commonly used or formalized word(s) or phrase(s) used to describe this dataset
    - `id` string, required: Identifier selecting one of the scales defined in the TileMatrixSet and representing the scaleDenominator the tile. Implementation of 'identifier'
    - `scaleDenominator` number, required: Scale denominator of this tile matrix
    - `cellSize` number, required: Cell size of this tile matrix
    - `cornerOfOrigin` 'topLeft' | 'bottomLeft': The corner of the tile matrix (_topLeft_ or _bottomLeft_) used as the origin for numbering tile rows and columns. This corner is also a corner of the (0, 0) tile.
    - `pointOfOrigin` unknown[], required: Precise position in CRS coordinates of the corner of origin (e.g. the top-left corner) for this tile matrix. This position is also a corner of the (0, 0) tile. In previous version, this was 'topLeftCorner' and 'cornerOfOrigin' did not exist.
      - unknown
    - `tileWidth` integer, required: Width of each tile of this tile matrix in pixels
    - `tileHeight` integer, required: Height of each tile of this tile matrix in pixels
    - `matrixWidth` integer, required: Width of the matrix (number of tiles in width)
    - `matrixHeight` integer, required: Height of the matrix (number of tiles in height)
    - `variableMatrixWidths` VariableMatrixWidth[], nullable: Describes the rows that has variable matrix width
      - `coalesce` integer, required: Number of tiles in width that coalesce in a single tile for these rows
      - `minTileRow` integer, required: First tile row where the coalescence factor applies for this tilematrix
      - `maxTileRow` integer, required: Last tile row where the coalescence factor applies for this tilematrix

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/chloris/apis/chloris-geospatial-s-dynamic-tiler.md) - [All operations](https://skmtc.dev/chloris/apis/chloris-geospatial-s-dynamic-tiler/llms.txt) - [OpenAPI document](https://skmtc.dev/chloris/apis/chloris-geospatial-s-dynamic-tiler/revisions/8c654362f5b5?raw)