Technical specification

This technical specification explains the content of the OS Vector Tile API and the methods that you can use to call it.

If you are not familiar with the OS Vector Tile API please read the overview documentation before proceeding.

Core concepts

This specification does not cover core concepts that apply to all Ordnance Survey APIs.

Please read the following pages to learn more about OS API core concepts:

API reference

OS Vector Tile API has three main endpoints:

Service metadata
Styling
Tile request

OS Vector Tile API is currently 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 maps are available as raw information presented using compressed packets of geographic data using the Protocolbuffer Binary Format (.pbf). This provides users optimised maps which render quickly on the web and offer a slick mapping experience.

Service Metadata

Service Metadata for OS Vector Tiles API

GEThttps://api.os.uk/maps/vector/v1/vts

Authorization

Query parameters

Response

Retrieves Service Metadata for OS Vector Tiles API

Body

currentVersionnumber

namestring

capabilitiesstring

typestring

defaultStylesstring

tilesarray of string

exportTilesAllowedboolean

initialExtentExtent (object)

fullExtentExtent (object)

minScalenumber

maxScalenumber

tileInfoTileInfo (object)

maxzoominteger

minLODinteger

maxLODinteger

resourceInfoobject

serviceItemIdstring

maxExportTilesCountinteger

Request

const response = await fetch('https://api.os.uk/maps/vector/v1/vts', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "currentVersion": 0,
  "name": "text",
  "capabilities": "text",
  "type": "text",
  "defaultStyles": "text",
  "tiles": [
    "text"
  ],
  "exportTilesAllowed": false,
  "initialExtent": {
    "xmin": 0,
    "ymin": 0,
    "xmax": 0,
    "ymax": 0,
    "spatialReference": {
      "wkid": 0,
      "latestWkid": 0
    }
  },
  "fullExtent": {
    "xmin": 0,
    "ymin": 0,
    "xmax": 0,
    "ymax": 0,
    "spatialReference": {
      "wkid": 0,
      "latestWkid": 0
    }
  },
  "minScale": 0,
  "maxScale": 0,
  "tileInfo": {
    "rows": 0,
    "cols": 0,
    "dpi": 0,
    "format": "text",
    "origin": {
      "x": 0,
      "y": 0
    },
    "spatialReference": {
      "xmin": 0,
      "ymin": 0,
      "xmax": 0,
      "ymax": 0,
      "spatialReference": {
        "wkid": 0,
        "latestWkid": 0
      }
    },
    "lods": [
      {
        "level": 0,
        "resolution": 0,
        "scale": 0
      }
    ]
  },
  "maxzoom": 0,
  "minLOD": 0,
  "maxLOD": 0,
  "resourceInfo": {
    "styleVersion": 0,
    "tileCompression": "text",
    "cacheInfo": {
      "storageInfo": {
        "packetSize": 0,
        "storageFormat": "text"
      }
    }
  },
  "serviceItemId": "text",
  "maxExportTilesCount": 0
}

Styles

Discover compatible stylesheets

GEThttps://api.os.uk/maps/vector/v1/vts/resources/styles

Authorization

Query parameters

Response

Retrieves compatible stylesheets

Body

version*integer

sprite*string

glyphs*string

sources*object

layers*array of object

Request

const response = await fetch('https://api.os.uk/maps/vector/v1/vts/resources/styles', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "version": 0,
  "sprite": "text",
  "glyphs": "text",
  "layers": [
    {
      "id": "text",
      "type": "text",
      "source": "text",
      "source-layer": "text",
      "filter": [
        "text"
      ],
      "minzoom": 0,
      "maxzoom": 0
    }
  ]
}

Discover compatible stylesheets for a data overlay

GEThttps://api.os.uk/maps/vector/v1/vts/{layer-name}/resources/styles

Authorization

Path parameters

layer-name*enum

The name of the data overlay.

boundariesgreenspacesiteswaterhighwayspaths

Query parameters

Response

Returns compatible stylesheets for a data overlay.

Body

version*integer

sprite*string

glyphs*string

sources*object

layers*array of object

Request

const response = await fetch('https://api.os.uk/maps/vector/v1/vts/{layer-name}/resources/styles', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "version": 0,
  "sprite": "text",
  "glyphs": "text",
  "layers": [
    {
      "id": "text",
      "type": "text",
      "source": "text",
      "source-layer": "text",
      "filter": [
        "text"
      ],
      "minzoom": 0,
      "maxzoom": 0
    }
  ]
}

Tile Request

Access and download data for a specific tile

GEThttps://api.os.uk/maps/vector/v1/vts/tile/{z}/{y}/{x}.pbf

Authorization

Path parameters

z*integer (int32)

Zoom level

y*integer (int32)

Y coordinate

x*integer (int32)

X coordinate

Query parameters

Response

Tile data retrieved successfully

Body

string (binary)

Request

const response = await fetch('https://api.os.uk/maps/vector/v1/vts/tile/{z}/{y}/{x}.pbf', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

binary

Access and download data for a specific tile from a data overlay

GEThttps://api.os.uk/maps/vector/v1/vts/{layer-name}/tile/{z}/{y}/{x}.pbf

Authorization

Path parameters

layer-name*enum

The name of the data overlay.

boundariesgreenspacesiteswaterhighwayspaths

z*integer (int32)

Zoom level

y*integer (int32)

Y coordinate

x*integer (int32)

X coordinate

Query parameters

Response

Tile data retrieved successfully

Body

string (binary)

Request

const response = await fetch('https://api.os.uk/maps/vector/v1/vts/{layer-name}/tile/{z}/{y}/{x}.pbf', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

binary

PreviousCreate a web application using the OS Vector Tile API NextOS Features API

Last updated 7 months ago