---
title: "Use to get metadata for a tileset."
method: GET
path: "/map/tileset"
---

# Use to get metadata for a tileset.

`GET /map/tileset`

The Get Map Tileset API allows users to request metadata for a tileset.

## Query parameters

- `api-version` string, required
- `tilesetId` 'microsoft.base' | 'microsoft.base.labels' | 'microsoft.base.hybrid' | 'microsoft.terra.main' | 'microsoft.base.road' | 'microsoft.base.darkgrey' | 'microsoft.base.labels.road' | 'microsoft.base.labels.darkgrey' | 'microsoft.base.hybrid.road' | 'microsoft.base.hybrid.darkgrey' | 'microsoft.imagery' | 'microsoft.weather.radar.main' | 'microsoft.weather.infrared.main' | 'microsoft.traffic.absolute' | 'microsoft.traffic.absolute.main' | 'microsoft.traffic.relative' | 'microsoft.traffic.relative.main' | 'microsoft.traffic.relative.dark' | 'microsoft.traffic.delay' | 'microsoft.traffic.delay.main' | 'microsoft.traffic.reduced.main' | 'microsoft.traffic.incident', required

## Headers

- `x-ms-client-id` string

## Response `200`

The request has succeeded.

- MapTileset — Metadata for a tileset in the TileJSON format.
  - `tilejson` string — Describes the version of the TileJSON spec that is implemented by this JSON object.
  - `name` string — A name describing the tileset. The name can contain any legal character. Implementations SHOULD NOT interpret the name as HTML.
  - `description` string — Text description of the tileset. The description can contain any legal character. Implementations SHOULD NOT interpret the description as HTML.
  - `version` string — A semver.org style version number for the tiles contained within the tileset. When changes across tiles are introduced, the minor version MUST change.
  - `attribution` string — Copyright attribution to be displayed on the map. Implementations MAY decide to treat this as HTML or literal text. For security reasons, make absolutely sure that this field can't be abused as a vector for XSS or beacon tracking.
  - `template` string — A mustache template to be used to format data from grids for interaction.
  - `legend` string — A legend to be displayed with the map. Implementations MAY decide to treat this as HTML or literal text. For security reasons, make absolutely sure that this field can't be abused as a vector for XSS or beacon tracking.
  - `scheme` string — Default: "xyz". Either "xyz" or "tms". Influences the y direction of the tile coordinates. The global-mercator (aka Spherical Mercator) profile is assumed.
  - `tiles` string[] — An array of tile endpoints. If multiple endpoints are specified, clients may use any combination of endpoints. All endpoints MUST return the same content for the same URL. The array MUST contain at least one endpoint.
  - `grids` string[] — An array of interactivity endpoints.
  - `data` string[] — An array of data files in GeoJSON format.
  - `minzoom` integer — The minimum zoom level.
  - `maxzoom` integer — The maximum zoom level.
  - `bounds` number[] — The maximum extent of available map tiles. Bounds MUST define an area covered by all zoom levels. The bounds are represented in WGS:84 latitude and longitude values, in the order left, bottom, right, top. Values may be integers or floating point numbers.
  - `center` number[] — The default location of the tileset in the form [longitude, latitude, zoom]. The zoom level MUST be between minzoom and maxzoom. Implementations can use this value to set the default location.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (1.0) `040a85473ebc` — 1 info
  - added the new optional `header` request parameter `x-ms-client-id`
- **2026-07-13** (1.0) `4299ecc0f4e6` — 1 breaking, 1 info
  - added the new required `query` request parameter `tilesetId`
  - api operation id `RenderV2_GetMapTileset` removed and replaced with `Render_GetMapTileset`
- **2026-07-13** (1.0) `6e9de8c6e9f5` — 1 info
  - endpoint added
- **2021-07-20** (1.0) `25770d6f2de7` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/maps-render/changes/map/tileset/get.md)

---

[API](https://skmtc.dev/azure/apis/maps-render.md) · [All operations](https://skmtc.dev/azure/apis/maps-render/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/maps-render/revisions/040a85473ebc/schema)