ESRI ArcGIS Pro

Accessing OS Vector Tile API via ESRI ArcGIS Pro

ESRI ArcGIS Pro is a desktop geographic information system (GIS) application that allows users to maintain, visualise and analyse spatial data.

The instructions that follow demonstrate how to connect to OS Vector Tile API using ESRI ArcGIS Pro.

What you need

  • OS Vector Tile API added to an API project in the OS Data Hub with an API Key. See Getting started with an API project for more information.

  • ESRI ArcGIS Pro (version 3.0 or later)

Connecting to the API

1

Set up a connection

Once a new project with a new map has been set up, select Map > Add Data > From Path.

ESRI ArcGIS Pro UI.
ESRI ArcGIS Pro UI.

2

Add an API URL and set up custom parameters

In the Add Data From Path dialog:

  • Path: Enter the URL for OS Vector Tile API, excluding the API Key. For example, https://api.os.uk/maps/vector/v1/vts.

  • Service type: Select Vector Tile Service

ESRI ArcGIS Pro Add Data From Path dialog.
ESRI ArcGIS Pro Add Data From Path dialog.
  • Select Custom request parameters and enter the following:

Parameter
Value

srs

The required coordinate reference system – 27700 or 3857

key

[Insert your OS API Key here]

  • Click Add.

ESRI ArcGIS Pro Add Data From Path dialog with custom request parameters set.
ESRI ArcGIS Pro Add Data From Path dialog with custom request parameters set.

The layer will then display in the Contents panel and the data will display on the map:

ESRI ArcGIS Pro UI showing OS Vector Tiles API in the map area.
ESRI ArcGIS Pro UI showing OS Vector Tile API in the map area.

Add a custom style

1

Find a style

Once you have an existing OS Vector Tile API connection, go to the OS-Vector-Tile-API Stylesheets Repo in GitHub and select the required style file.

2

Get a Style URL

With the custom stylesheet file open:

  • Click Raw (a new window will open).

  • Copy the URL to link to the style JSON file.

A  style file open on GitHub with the Raw button highlighted.
GitHub UI with a custom stylesheet file open and the Raw button highlighted
3

Set up a Style URL connection

In ESRI ArcGIS Pro, follow steps 1 and 2 from the Connecting to the API section to set up a connection to the OS Vector Tile API using the custom style URL in the path field.

ESRI ArcGIS Pro Add Data From Path dialog with custom request parameters set.
ESRI ArcGIS Pro Add Data From Path dialog with custom request parameters set.

Publishing a custom base map to ESRI ArcGIS Online

1

Share Web Map

Once a connection to the OS Vector Tile API has been set up and you've signed into your ArcGIS Online account within ArcPro, select Share > Web Map.

ArcGIS Pro UI's Share to Web Map ribbon
ESRI ArcGIS Pro UI.

In the Share As Web Map panel:

  • Complete the relevant details.

  • Click Share.

2

View in ESRI ArcGIS Online

Once the web map has been successfully shared, this will be available in your ArcGIS Online account under My content:

ESRI ArcGIS Online account with OS Vector Tile Web Map shared.
ESRI ArcGIS Online account UI with OS Vector Tile Web Map shared.
3

Add a custom base map

Open the OS Vector Tile API web map in the map viewer and select Layers.

  • Click on the '' button for the Vector Tile Layer.

  • Select Move to basemap.

ArcGIS Online Map Viewer with greyscale base map
ESRI ArcGIS Online Map Viewer with a greyscale basemap.

Last updated

Was this helpful?