# 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](https://docs.os.uk/os-apis/core-concepts/getting-started-with-an-api-project "mention") for more information
* ESRI ArcGIS Pro (version 3.0 or later)

## Connecting to the API

{% stepper %}
{% step %}
**Set up a connection**

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

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-e907466d8c49991f2c7b2c945b16aae02edf7ed5%2FArcPro%20Add%20Data%20From%20Path.png?alt=media" alt="ESRI ArcGIS Pro UI."><figcaption><p>ESRI ArcGIS Pro UI.</p></figcaption></figure>
{% endstep %}

{% step %}
**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

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-8e2f84ac0b6c108a0d59eef8cc69349db739c066%2FArcPro%20Add%20connection%20no%20custom%20parameters%20.png?alt=media" alt="ESRI ArcGIS Pro Add Data From Path dialog."><figcaption><p>ESRI ArcGIS Pro Add Data From Path dialog.</p></figcaption></figure>

* Select *Custom request parameters* and enter the following:

<table><thead><tr><th width="170">Parameter</th><th>Value</th></tr></thead><tbody><tr><td>srs</td><td>The required coordinate reference system – <code>27700</code> or <code>3857</code></td></tr><tr><td>key</td><td>[Insert your OS API Key here]</td></tr></tbody></table>

* Click *Add*.

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-a42ef759a54e778d7db70214b4a3fc906bc7727e%2FArcPro%20Add%20connection%20.png?alt=media" alt="ESRI ArcGIS Pro Add Data From Path dialog with custom request parameters set."><figcaption><p>ESRI ArcGIS Pro Add Data From Path dialog with custom request parameters set.</p></figcaption></figure>

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

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-cf35bff47ec8e854d156dc4ee5aef0a97fdb9300%2FArcPro%20Render%20VT%20Layer.png?alt=media" alt="ESRI ArcGIS Pro UI showing OS Vector Tiles API in the map area."><figcaption><p>ESRI ArcGIS Pro UI showing OS Vector Tile API in the map area.</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Add a custom style

{% stepper %}
{% step %}
**Find a style**

Once you have an existing OS Vector Tile API connection, go to the [OS-Vector-Tile-API Stylesheets Repo in GitHub](https://github.com/OrdnanceSurvey/OS-Vector-Tile-API-Stylesheets) and select the required style file.
{% endstep %}

{% step %}
**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.

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-7de40f234d84d943ffec9cabe08a701f4294ade6%2FQGIS%20Get%20Style%20URL.png?alt=media" alt="A  style file open on GitHub with the Raw button highlighted."><figcaption><p>GitHub UI with a custom stylesheet file open and the Raw button highlighted</p></figcaption></figure>
{% endstep %}

{% step %}
**Set up a Style URL connection**

In ESRI ArcGIS Pro, follow steps 1 and 2 from the [#connecting-to-the-api](#connecting-to-the-api "mention") section to set up a connection to the OS Vector Tile API using the custom style URL in the path field.

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-15a522b135f0e79abb6587c8a50ba52b997ca041%2FArcPro%20Add%20connection%20-%20Custom%20style.png?alt=media" alt="ESRI ArcGIS Pro Add Data From Path dialog with custom request parameters set."><figcaption><p>ESRI ArcGIS Pro Add Data From Path dialog with custom request parameters set.</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Publishing a custom base map to ESRI ArcGIS Online

{% stepper %}
{% step %}
**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.

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-bfdda28f1837c06db136a4346152bbbf6e9179b6%2FArcPro%20-%20Share%20Web%20Map.png?alt=media" alt="ArcGIS Pro UI&#x27;s Share to Web Map ribbon"><figcaption><p>ESRI ArcGIS Pro UI.</p></figcaption></figure>

In the Share As Web Map panel:

* Complete the relevant details.
* Click *Share*.
  {% endstep %}

{% step %}
**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*:

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-10e87f9240e3a0e2abfb25b21d91ad3fd968c2a9%2FArcPro%20-%20Share%20Web%20Map%20-%20my%20content.png?alt=media" alt="ESRI ArcGIS Online account with OS Vector Tile Web Map shared."><figcaption><p>ESRI ArcGIS Online account UI with OS Vector Tile Web Map shared.</p></figcaption></figure>
{% endstep %}

{% step %}
**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.

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-e01b227a8f6598f274aa94a4bc6d52b91ef18327%2FArcPro%20-%20Share%20Web%20Map%20-base%20map.png?alt=media" alt="ArcGIS Online Map Viewer with greyscale base map"><figcaption><p>ESRI ArcGIS Online Map Viewer with a greyscale basemap.</p></figcaption></figure>
{% endstep %}
{% endstepper %}