# ArcMap

ArcMap is a geographic information system (GIS) application that is part of Esri's ArcGIS suite of geospatial software. It is used primarily to view, edit, create, and analyse geospatial data.

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

## What you need?

* ArcMap 10.5 or later
* [Data Interoperability Tools extension](https://desktop.arcgis.com/en/arcmap/latest/extensions/data-interoperability/installing-the-data-interoperability-extension.htm) for ArcMap
* A preloaded base map, for example, [os-maps-api](https://docs.os.uk/os-apis/accessing-os-apis/os-maps-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" %}
We used ArcMap 10.5 to create these instructions.
{% endhint %}

{% hint style="warning" %}
To access the OS Features API with ArcMap, you must first install the [Data Interoperability Tools extension](https://desktop.arcgis.com/en/arcmap/latest/extensions/data-interoperability/installing-the-data-interoperability-extension.htm).
{% endhint %}

1. Start ArcMap and open Arc Toolbox. Select the *Data Interoperability Tools* *> Quick Import*.

   <figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-549fc201fb0ce3b242a14c9b676315f978f5a7ee%2Fimage.png?alt=media" alt="ArcMap UI showing Arc Toolbox Data Interoperability Tools > Quick Import option"><figcaption></figcaption></figure>
2. In the Quick Import dialog, select *Input Dataset* and then select *More Formats* in the Format field dropdown.

   <figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-a2bf6658c855ee706d8cac9c8fb376d647ab25df%2Fimage%20(37).png?alt=media" alt="ArcMap Quick Import dialog showing Specify Data Source sub-dialog"><figcaption></figcaption></figure>
3. In the FME Reader Gallery dialog, select *WFS (Web Feature Service)* and then click *OK*. Additional formats may be available if you have a licence for the full extension. Our example uses the free version of the Data Interoperability Tools extension.\_

   <figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-05382fede5b7bae8209c9e881d36ff5ed54a2e99%2Fimage%20(38).png?alt=media" alt="ArcMap FME Reader Gallery dialog"><figcaption></figcaption></figure>
4. In the Specify Data Source dialog, enter the full OS Features API URL (including the OS key in the Dataset field and then click *Parameters*.

   <figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-14a17deea4eb9abe01151589b7aa226f7356c651%2Fimage%20(39).png?alt=media" alt="ArcMap Specify Data Source dialog"><figcaption></figcaption></figure>
5. On the next screen, click ... (three dots) next to the Constraints > Feature Types field.

   <figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-c76d70c48096a30a510c1b33fe621592d89ec696%2Fimage%20(40).png?alt=media" alt="ArcMap Parameters dialog showing Constraints > Feature Types field"><figcaption></figcaption></figure>
6. In the Select Feature Types dialog, select the data layers you want to add 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-0be40ed38c2815f5bf0f2d1f2926e3760e2a2714%2Fimage.png?alt=media" alt="ArcMap Select Feature Types dialog"><figcaption></figcaption></figure>
7. Click *OK* in each of the remaining open dialogs to close them.
8. In the Quick Import dialog, in Output Staging GeoDatabase select a location to save the exported Geodatabase.

   <figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-58e3f2e2ee5cb27c8b9f4ae6c1ece74a731ce3f6%2Fimage.png?alt=media" alt="ArcMap Quick Import dialog showing Output Staging GeoDatabase field"><figcaption></figcaption></figure>
9. The exported Geodatabase with the selected data layers 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-fb01ddb5ca3848a08a467fd5fde76be90246900c%2Fimage.png?alt=media" alt="ArcMap Catalog showing exported Geodatabase with the selected data layers"><figcaption></figcaption></figure>
10. You can now add the data to the map by dragging a data layer onto the map view. You can also do this by clicking Add Data, navigating to the Geodatabase and then selecting the desired layers.
11. You can style the WFS data in the same way as file-based vector data.

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