---
title: "Matrix Definition"
method: GET
path: "/data/tile-matrix-sets/{tileMatrixSetId}"
tags: ["Tile Matrix Sets"]
---

# Matrix Definition

`GET /data/tile-matrix-sets/{tileMatrixSetId}`

Return Matrix Definition

## Path parameters

- `tileMatrixSetId` string, required

## Query parameters

- `api-version` string, required

## Response `200`

The request has succeeded.

- TileMatrixSet — https://github.com/opengeospatial/2D-Tile-Matrix-Set/blob/master/schemas/tms/2.0/json/tileMatrixSet.json 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.
  - `title` string — Human-readable title of the tile matrix set
  - `description` string — Brief narrative description of this tile matrix set, normally available for display to a human
  - `keywords` string[] — Unordered list of one or more commonly used or formalized word(s) or phrase(s) used to describe this tile matrix set
  - `id` string — Unique identifier for the tile matrix set
  - `uri` string — URI reference to the official definition
  - `orderedAxes` string[] — Names of the coordinate axes in order
  - `crs` string, required — Coordinate reference system identifier
  - `wellKnownScaleSet` string, uri — URL reference to a standardized scale set
  - `boundingBox` TileMatrixSetBoundingBox — Geographic extent of the tile matrix set expressed in the specified coordinate reference system
    - `lowerLeft` string[], required — Lower-left corner coordinates [x, y] of bounding box
    - `upperRight` string[], required — Upper-right corner coordinates [x, y] of bounding box
    - `crs` string — Coordinate reference system identifier
    - `orderedAxes` string[] — Explicit axis order for the CRS coordinates (e.g., ['x', 'y'])
  - `tileMatrices` TileMatrix[], required — Array of tile matrices at different zoom levels
    - `title` string — Human-readable title of the tile matrix level
    - `description` string — Human-readable description of this tile matrix level
    - `keywords` string[] — Unordered list of one or more commonly used or formalized word(s) or phrase(s) used to describe this dataset
    - `id` string, required — Unique identifier for this tile matrix level, often the zoom level
    - `scaleDenominator` number, float, required — Scale denominator representing the scale of this tile matrix level
    - `cellSize` number, float, required — Size of a pixel in map units at this tile matrix level
    - `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` number[], 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.
    - `tileWidth` integer, required — Pixel width of each tile at this level
    - `tileHeight` integer, required — Pixel height of each tile at this level
    - `matrixWidth` integer, required — Number of tiles horizontally at this matrix level
    - `matrixHeight` integer, required — Number of tiles vertically at this matrix level
    - `variableMatrixWidths` VariableMatrixWidth[] — Describes the rows that has variable matrix width ref: https://github.com/opengeospatial/2D-Tile-Matrix-Set/blob/master/schemas/tms/2.0/json/variableMatrixWidth.json
      - `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

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/orbital-microsoft-planetarycomputer.md) · [All operations](https://skmtc.net/azure/apis/orbital-microsoft-planetarycomputer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/orbital-microsoft-planetarycomputer/revisions/42447be18bc5/schema)