---
title: "Use to request map tiles in vector or raster format."
method: GET
path: "/map/tile"
---

# Use to request map tiles in vector or raster format.

`GET /map/tile`

The `Get Map Tiles` API enables users to request map tiles in either vector or
raster formats, typically for integration into a map control or SDK. Supported
tile types include Azure Maps road tiles and real-time Weather Radar tiles. By
default, the Azure Maps [Web SDK](/azure/azure-maps/about-azure-maps#web-sdk)
uses vector tiles for rendering its web map control.

> [!Important]
>
> When using the **Get Map Tile** API, you must also call the [Get Map Attribution](/rest/api/maps/render/get-map-attribution) API to retrieve the required map data attribution text.
>
> The returned attribution must be displayed wherever tiles retrieved from **Get Map Tile** are rendered, including in third-party map controls or custom rendering implementations.

## 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
- `zoom` integer, required
- `x` integer, required
- `y` integer, required
- `timeStamp` string, date-time
- `tileSize` '256' | '512'
- `language` string
- `view` 'AE' | 'AR' | 'BH' | 'IN' | 'IQ' | 'JO' | 'KW' | 'LB' | 'MA' | 'OM' | 'PK' | 'PS' | 'QA' | 'SA' | 'SY' | 'US' | 'YE' | 'Auto' | 'Unified'

## Headers

- `x-ms-client-id` string

## Response `200`

The request has succeeded.

- string, byte

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (1.0) `040a85473ebc` — 3 breaking, 1 warning, 3 info
  - added the new required `query` request parameter `x`
  - added the new required `query` request parameter `y`
  - added the new required `query` request parameter `zoom`
  - the optional response header `Content-Type` removed for the status `200`
  - …3 more
- **2026-07-13** (1.0) `1ab2ac2b6f77` — 1 info
  - endpoint added
- **2026-07-13** (1.0) `4299ecc0f4e6` — 1 breaking, 2 info
  - added the new required `query` request parameter `tilesetId`
  - api operation id `RenderV2_GetMapTile` removed and replaced with `Render_GetMapTile`
  - added the new optional `query` request parameter `tileSize`
- **2026-07-13** (1.0) `6e9de8c6e9f5` — 1 warning
  - deleted the `query` request parameter `tilesetId`
- **2021-07-20** (1.0) `25770d6f2de7` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/maps-render/changes/map/tile/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)