# ArcGIS Pro

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

These instructions demonstrate how to integrate and apply the OS Features API into ArcGIS Pro in order to produce a series of topography layers based on our latest OS MasterMap Topography layer data.

## What you need?

* ArcGIS Pro 2.3.3 to 3.4
* A preloaded base map, for example, [os-maps-api](https://docs.os.uk/os-apis/accessing-os-apis/os-maps-api "mention") or [os-vector-tile-api](https://docs.os.uk/os-apis/accessing-os-apis/os-vector-tile-api "mention")
* OS Features API URL and 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

## Instructions

{% hint style="info" %}

#### ArcGIS Pro version numbers

* We used ArcGIS Pro 2.3.3 to create these instructions.
* The instructions work for ArcGIS Pro 2.3.3 to 3.3.
* If using ArcGIS Pro 3.4, at Step 6 you'll need to follow the alternative instructions noted in the grey hint box.
* The instructions don't work for ArcGIS Pro 3.5. We are currently investigating this issue with ERSI.
  {% endhint %}

1. Open ArcGIS Pro. On the opening window, create a new project with a new map.

   <figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-16e4fa790455fec75af64b0b723e687b23fd2b6e%2FMaps-Pro-1.png?alt=media" alt="ArcGIS Pro UI opening window"><figcaption></figcaption></figure>
2. Give your project a name and save it to a folder of your choice.
3. ArcGIS Pro will load one of the standard template maps. The map may look similar to the example below. This depends on which mapping template is selected by default.

   <figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-9f6d77c0eb7fa951d33da62b75c39c113090f0b4%2FMaps-Pro-2.png?alt=media" alt="ArcGIS Pro UI showing default map"><figcaption></figcaption></figure>
4. Ensure that the Catalog tab is selected. You will need the Catalog window shortly.

   <figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-bcac90c6cac30ba7664839ab0cf041e08076a2b2%2FMaps-Pro-3.png?alt=media" alt="ArcGIS Pro UI Catalog tab"><figcaption></figcaption></figure>
5. To access the OS Features service from the OS Data Hub, navigate to *Insert* > *Connections* and then select *New WFS Server* in the dropdown.

   <figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-7b413a3725124f782079a1a6ce5fd07dd281e770%2Fimage.png?alt=media" alt="ArcGIS Pro showing Insert > Connections > New WFS Server option"><figcaption></figcaption></figure>
6. In the Add WFS Server Connection dialog:
   * **Server URL**: Add the OS Features API URL, excluding the key.
   * **Custom request parameters**: Click the down-arrow display the table.
     * **Parameter** column: Enter *key* (lower case).
     * **Value** column: Enter your API Key.
   * Click *OK*.

     <figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-b2387bed6fec75e2575a5c246daa9424d25a9311%2Fimage.png?alt=media" alt="ArcGIS Pro Add WFS Server Connection dialog"><figcaption></figcaption></figure>

{% hint style="info" %}

#### Alternative instructions for Step 6 for those using ArcGIS Pro 3.4 only

Please note, if you are using ArcGIS Pro 3.4, then you'll most likely have to enter your API Key in the Server URL field (<https://api.os.uk/features/v1/wfs?key=yourkeyhere>), leave the Custom request parameters fields blank, then click *OK* for Step 6\_.
{% endhint %}

7. The WFS connection will now display in the Catalog panel.

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-5b28bb1e06602a502c1cb1cf46f97fe45c5561e0%2Fimage.png?alt=media" alt="ArcGIS Pro Catalog showing Project > Servers > WFS on api.os.uk.wfs options"><figcaption></figcaption></figure>

8. To add the data to the map view, navigate to *Map > Add Data > Data – Add data to the map*.

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-6c02b0e5ee3c46a9f34e01fee537f3811a4fb11d%2Fimage.png?alt=media" alt="ArcGIS Pro UI showing Map > Add Data > Data - Add data to the map navigation option"><figcaption></figcaption></figure>

9. In the Add Data dialog, select the layer(s) you want and click *OK*.

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-dc9b461027d2a35d77b065361348a10ad8a46349%2Fimage.png?alt=media" alt="ArcGIS Pro Add Data dialog"><figcaption></figcaption></figure>

10. The data should now display in the Map area. Use the standard zoom controls to zoom into the area required.

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-249a405832e17121284e1128689ec5017286459a%2Fimage.png?alt=media" alt="ArcGIS Pro UI showing OS Features API data in the Map area"><figcaption></figcaption></figure>