> For the complete documentation index, see [llms.txt](https://docs.os.uk/os-apis/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.os.uk/os-apis/accessing-os-apis/os-maps-api/layers-and-styles.md).

# Layers and styles

The following page describes the zoom levels and data products available for the two projections used by the OS Maps API, plus the four styles available for the maps: Outdoor, Road, Light and Leisure.

OS Maps API is available as EPSG:27700 (British National Grid which is applicable just for GB) and EPSG:3857 (Web Mercator which is a global coordinate system).

The API includes four OS styles: Outdoor, Road, Light (in both 27700 and 3857), and Leisure (in 27700).

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden></th><th data-hidden></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><h4>Outdoor</h4></td><td>A general-purpose map designed to show the natural features of the landscape clearly.</td><td></td><td></td><td><a href="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2FA4hLgflvsQ9YllfRvWwS%2FOutdoor.png?alt=media&amp;token=50e77633-a131-4b34-8038-0105286b55d4">Outdoor.png</a></td></tr><tr><td><h4>Road</h4></td><td>A transport-focused style that makes the road network easy to identify and follow.</td><td></td><td></td><td><a href="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2F2IRogRT3eXpV81KeUi0f%2FRoad.png?alt=media&amp;token=b0f8553c-e738-4622-b269-77b15073feb1">Road.png</a></td></tr><tr><td><h4>Light</h4></td><td>A clean, understated map with a light colour palette to provide geographic context without competing with information displayed on top of the map.</td><td></td><td></td><td><a href="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2FlBgiXZCWu8NzBB8qV6n5%2FLight.png?alt=media&amp;token=23d8b851-d346-40b5-8f5a-f0e46add44ae">Light.png</a></td></tr><tr><td><h4>Leisure</h4></td><td>Access to our iconic colour raster cartographic products from small to large scale mapping. </td><td></td><td></td><td><a href="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2FP6gZVRa8Ny92KoagSDzg%2FLesiure.png?alt=media&amp;token=b7aafb2a-5f4c-47bf-9c36-d0eadd948e11">Lesiure.png</a></td></tr></tbody></table>

These styles can be accessed through API requests by referencing the following style names:

<table data-search="false"><thead><tr><th width="200.40533447265625">Style Name</th><th width="229.7115478515625">Style</th><th width="167.67254638671875">Coordinate Reference System (CRS)</th></tr></thead><tbody><tr><td><code>3857</code></td><td>Outdoor</td><td>EPSG:3857</td></tr><tr><td><code>27700</code></td><td>Outdoor</td><td>EPSG:27700</td></tr><tr><td><code>Road-3857</code></td><td>Road</td><td>EPSG:3857</td></tr><tr><td><code>Road-27700</code></td><td>Road</td><td>EPSG:27700</td></tr><tr><td><code>Light-3857</code></td><td>Light</td><td>EPSG:3857</td></tr><tr><td><code>Light-27700</code></td><td>Light</td><td>EPSG:27700</td></tr><tr><td><code>Blackwhite-3857</code></td><td>Black and White</td><td>EPSG:3857</td></tr><tr><td><code>Blackwhite-27700</code></td><td>Black and White</td><td>EPSG:27700</td></tr></tbody></table>

## Tile Cache Zoom Levels

The tables below describe the data that is available at each zoom level for both coordinate reference systems (CRS). Open layers are available to all users of the API regardless of which Data Hub plan is used, at no cost. Premium layers use detailed OS MasterMap content and require the appropriate product access and licensing. Check your OS Data Hub plan and product access before designing an application around these levels.&#x20;

### Web Mercator - EPSG:3857

The outdoor, road and light styles table below shows the resolution (meters per pixel) and scale of the zoom levels within the EPSG:3857 tile matrix set. The scale is calculated at a DPI of 96. The table also shows which zoom levels are OS OpenData, and which levels are Premium data.

The zoom levels start at 7 to fit in with the industry standard initial zoom layer. This improves the interoperability of this tile matrix set with third party tools and applications.

#### Outdoor, Road and Light Styles

<table data-search="false"><thead><tr><th width="100.162109375">Zoom Level</th><th width="117.5675048828125">Resolution</th><th width="116.4234619140625">Scale</th><th width="132.044921875">Data Licence</th><th width="281.786376953125">Data Product</th></tr></thead><tbody><tr><td>7</td><td>1 223</td><td>1:4 622 324</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>8</td><td>611</td><td>1:2 311 162</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>9</td><td>306</td><td>1:1 155 581</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>10</td><td>153</td><td>1:577 791</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>11</td><td>76</td><td>1:288 895</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>12</td><td>38</td><td>1:144 448</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>13</td><td>19</td><td>1:72 224</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>14</td><td>9.6</td><td>1:36 112</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>15</td><td>4.8</td><td>1:18 056</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>16</td><td>2.4</td><td>1:9 028</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>17</td><td>1.2</td><td>1:4 514</td><td>Premium data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-mastermap-topography-layer">MasterMap Topography</a> blended with <a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>18</td><td>0.60</td><td>1:2 257</td><td>Premium data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-mastermap-topography-layer">MasterMap Topography</a></td></tr><tr><td>19</td><td>0.30</td><td>1:1 128</td><td>Premium data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-mastermap-topography-layer">MasterMap Topography</a></td></tr><tr><td>20</td><td>0.15</td><td>1:564</td><td>Premium data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-mastermap-topography-layer">MasterMap Topography</a></td></tr></tbody></table>

### British National Grid - EPSG:27700

The outdoor, road and light styles and leisure styles tables and below show the resolution (meters per pixel) and scale of the zoom levels within the EPSG:27700 tile matrix sets. The scale is calculated at a DPI of 96. The tables also show which zoom levels are OS OpenData, and which levels are Premium data.

The zoom levels for the EPSG:27700 tile matrix set starts at 0 rather than at level 7, which is used for the EPSG:3857 tile matrix set. The range of resolutions and scales is comparable across both tile matrix sets. This means EPSG:27700 zoom level 0 is similar to EPSG:3857 zoom level 7.

#### Outdoor, Road and Light Styles

<table data-search="false"><thead><tr><th width="100.28228759765625">Zoom Level</th><th width="117.6036376953125">Resolution</th><th width="116.288330078125">Scale</th><th width="132.0181884765625">Data Licence</th><th width="281.79193115234375">Data Product</th></tr></thead><tbody><tr><td>0</td><td>896.0</td><td>1:3 386 450</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>1</td><td>448.0</td><td>1:1 693 225</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>2</td><td>224.0</td><td>1:846 612</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>3</td><td>112.0</td><td>1:423 306</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>4</td><td>56.0</td><td>1:211 653</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>5</td><td>28.0</td><td>1:105 827</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>6</td><td>14.0</td><td>1:52 913</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>7</td><td>7.0</td><td>1:26 457</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>8</td><td>3.5</td><td>1:13 228</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>9</td><td>1.75</td><td>1:6 614</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>10</td><td>0.875</td><td>1:3 307</td><td>Premium data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-mastermap-topography-layer">MasterMap Topography</a> blended with <a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack">Open Zoomstack</a></td></tr><tr><td>11</td><td>0.4375</td><td>1:1 654</td><td>Premium data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-mastermap-topography-layer">MasterMap Topography</a></td></tr><tr><td>12</td><td>0.21875</td><td>1:827</td><td>Premium data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-mastermap-topography-layer">MasterMap Topography</a></td></tr><tr><td>13</td><td>0.109375</td><td>1:413</td><td>Premium data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-mastermap-topography-layer">MasterMap Topography</a></td></tr></tbody></table>

#### Leisure Style

<table data-search="false"><thead><tr><th width="100.28228759765625">Zoom Level</th><th width="117.6036376953125">Resolution</th><th width="116.288330078125">Scale</th><th width="132.0181884765625">Data Licence</th><th width="281.79193115234375">Data Product</th></tr></thead><tbody><tr><td>0</td><td>896.0</td><td>1:3 386 450</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/gb-overview-maps">GB Overview Maps</a></td></tr><tr><td>1</td><td>448.0</td><td>1:1 693 225</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/miniscale">Miniscale</a></td></tr><tr><td>2</td><td>224.0</td><td>1:846 612</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/miniscale">Miniscale</a></td></tr><tr><td>3</td><td>112.0</td><td>1:423 306</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/1-250-000-scale-colour-raster">1:250 000 Scale Colour Raster</a></td></tr><tr><td>4</td><td>56.0</td><td>1:211 653</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/1-250-000-scale-colour-raster">1:250 000 Scale Colour Raster</a></td></tr><tr><td>5</td><td>28.0</td><td>1:105 827</td><td>Open data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/1-50-000-scale-colour-raster">1:50 000 Scale Colour Raster</a></td></tr><tr><td>6</td><td>14.0</td><td>1:52 913</td><td>Premium data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/1-50-000-scale-colour-raster">1:50 000 Scale Colour Raster</a></td></tr><tr><td>7</td><td>7.0</td><td>1:26 457</td><td>Premium data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/1-25-000-scale-colour-raster">1:25 000 Scale Colour Raster</a></td></tr><tr><td>8</td><td>3.5</td><td>1:13 228</td><td>Premium data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/1-25-000-scale-colour-raster">1:25 000 Scale Colour Raster</a></td></tr><tr><td>9</td><td>1.75</td><td>1:6 614</td><td>Premium data</td><td><a href="https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/1-25-000-scale-colour-raster">1:25 000 Scale Colour Raster</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.os.uk/os-apis/accessing-os-apis/os-maps-api/layers-and-styles.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.