# OS Vector Tile API

OS Vector Tile API is a vector tile service providing detailed Ordnance Survey data as a customisable basemap. It can be used with most web mapping libraries including Mapbox GL JS, Leaflet, OpenLayers and ArcGIS API for JavaScript. Vector Tiles have the benefit of being optimised for use across the internet and are great for building interactive web maps. You can zoom, pan, rotate, tilt and even extrude 3D buildings.

You have a choice between using Ordnance Survey styles or creating your own. You can customise the content and the style to create a map that perfectly meets your needs. Design a map that matches your brand or get creative and add some cartographic flair to your application.

With OS Vector Tile API you can also select and interact with the individual map features.

OS Vector Tile API is available in two projections: 

* British National Grid for GB data
* Web Mercator, which is a global coordinate system

{% hint style="warning" %}

### OS MasterMap Water Network Layer **End of Life (withdrawal)**

The OS MasterMap Water Network Layer product (also referred to as OS MasterMap Networks – Water Layer) reached its End of Life on 31 March 2026 and was removed from the OS Vector Tile API.

Further information on the withdrawal of this product is available on the [OS MasterMap Water Network Layer End of Life documentation page](https://docs.os.uk/os-downloads/resources/product-resources/end-of-life-product-documentation/os-mastermap-water-network-layer).
{% endhint %}

{% hint style="info" %}
**Associated products reaching their End of Life (withdrawal) date**

* The OS Detailed Path Network (DPN) product will become End of Life on 30 September 2026. As of this date, access to the product will be removed from the OS Vector Tile API.
* The OS MasterMap Greenspace Layer product will become End of Life on 31 March 2027. As of this date, access to the product will be removed from the OS Vector Tile API.

Further information on these product withdrawals is available from the [End of Life Product Notices page on the OS Download Products' Documentation site](https://docs.os.uk/os-downloads/resources/product-resources/end-of-life-product-notices).
{% endhint %}

{% tabs %}
{% tab title="Features" %}
**Scalable vector tile mapping**

Provides lightweight, high-resolution vector tile basemaps in different styles and projections for fast rendering in interactive applications.

**Customisable style options**

Access to pre-defined, professional styling which can be customised to meet your own requirements and map designs.

**3D visualisation support**

Allows for tilting and extruding building features.

**Built in data overlays**

Access build in and detailed overlays to add give additional geographic context.
{% endtab %}

{% tab title="Benefits" %}
**Faster performance**

Loads maps quicker than traditional raster-mapping services.

**Up-to-date mapping**

Ensures that users always have access to the most current mapping data.

**Flexible customisation**

Customise the style and content to make your map meet your requirements.

**Interactive mapping**

Improves interactivity by offering high-quality, scalable mapping with direct access to attribution.
{% endtab %}

{% tab title="Summary" %}

* **Format:** Vector tiles
* **Primary Data Source**: [OS Open Zoomstack](https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack) and [OS MasterMap Topography Layer](https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-mastermap-topography-layer)
* **Additional Data Source**: [Boundary-Line](https://docs.os.uk/os-downloads/products/areas-and-zones-portfolio/boundary-line), [OS MasterMap Greenspace Layer](https://docs.os.uk/os-downloads/products/land-and-terrain-portfolio/os-mastermap-greenspace-layer), [OS MasterMap Sites Layer](https://docs.os.uk/os-downloads/products/land-and-terrain-portfolio/os-mastermap-sites-layer), [OS MasterMap Highways Network – Roads](https://docs.os.uk/os-downloads/products/transport-network-portfolio/os-mastermap-highways-network-roads), [OS MasterMap Highways Network – Paths](https://docs.os.uk/os-downloads/products/transport-network-portfolio/os-mastermap-highways-network-paths) and [OS Detailed Path Network](https://docs.os.uk/os-downloads/products/transport-network-portfolio/os-detailed-path-network).
* **Coverage:** Great Britain
* **Update:** 15 working days from each [product refresh date](https://docs.os.uk/os-downloads/resources/product-resources/product-refresh-dates)
  {% endtab %}
  {% endtabs %}

## **Things to remember for OS Vector Tile API**

{% hint style="success" %}
You can:

* Use as a basemap in GIS, web or mobile applications
* View the whole of Great Britain in unrivalled detail
* Seamlessly pan, zoom, pitch and tilt the map
* Overlay your own data to give it geographic context
* Trace over OS MasterMap Topography Layers (Premium data) detailed geometries
* Customise the map style and content to create the map you need
* Access the maps in different projections – British National Grid and Web Mercator
  {% endhint %}

{% hint style="warning" %}
You can't:

* Retrieve all the detailed attribution from OS data
  {% endhint %}

## What's next?

<table data-view="cards"><thead><tr><th></th><th></th><th><select><option value="nm1DxKqO3Qj1" label="GitHub.com" color="blue"></option><option value="kMZeXFjNhVML" label="Labs.os.uk" color="blue"></option></select></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>What data is available?</strong></td><td>A guide to the data available through the OS Vector Tile API.</td><td></td><td><a href="os-vector-tile-api/what-data-is-available">what-data-is-available</a></td></tr><tr><td><strong>Getting started</strong></td><td>The getting started guide explains how to integrate with the OS Vector Tile API in various open GIS software applications.</td><td></td><td><a href="os-vector-tile-api/getting-started">getting-started</a></td></tr><tr><td><strong>Technical specification</strong></td><td>The technical specification explains the content of the OS Vector Tile API and the methods that you can use to call it.</td><td></td><td><a href="os-vector-tile-api/technical-specification">technical-specification</a></td></tr><tr><td><strong>Code examples</strong></td><td>Code examples you can use to display a map using the OS Vector Tile API.</td><td><span data-option="kMZeXFjNhVML">Labs.os.uk</span></td><td><a href="https://labs.os.uk/public/os-data-hub-examples/os-vector-tile-api/vts-3857-basic-map#maplibre-gl-js">https://labs.os.uk/public/os-data-hub-examples/os-vector-tile-api/vts-3857-basic-map#maplibre-gl-js</a></td></tr><tr><td><strong>Stylesheets</strong></td><td>Cartographic stylesheets hosted on GitHub for use with OS Vector Tile API.</td><td><span data-option="nm1DxKqO3Qj1">GitHub.com</span></td><td><a href="https://github.com/OrdnanceSurvey/OS-Vector-Tile-API-Stylesheets">https://github.com/OrdnanceSurvey/OS-Vector-Tile-API-Stylesheets</a></td></tr></tbody></table>


---

# Agent Instructions: 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:

```
GET https://docs.os.uk/os-apis/accessing-os-apis/os-vector-tile-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.