> For the complete documentation index, see [llms.txt](https://docs.os.uk/os-apis/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.os.uk/os-apis/accessing-os-apis/os-maps-api/getting-started/arcmap.md).

# ESRI ArcMap

Accessing OS Maps API via ESRI 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.

## What you need

* OS Maps API added to an API project in the OS Data Hub with an API Key; see [Getting started with an API project](/os-apis/core-concepts/getting-started-with-an-api-project.md) for more information
* ESRI ArcMap version 10.5 or later

{% hint style="info" %}
**Note**: We used ArcMap 10.5 to create these instructions.
{% endhint %}

## Instructions

{% stepper %}
{% step %}

#### Set up a connection

Once a new project has been set up, open the Catalog window > *GIS Servers > WMTS Server*.

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-46b6328c869d790c3fabf6213504491b52d815a9%2FMap-ArcMap-1.png?alt=media" alt="ArcMap UI showing Catalog window"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Add OS Map s API

In the Add WMTS Server dialog:

* **URL**: Copy your full OS Maps API WMTS endpoint address from the OS Data Hub and paste it into this field.
* **Other fields**: Leave these as they are. No other information is required.
* Click \_OK.

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-ffaa4e0d3cc2b682b3e967a3f5e3712b7c8f70c6%2FMap-ArcMap-2.png?alt=media" alt="ArcMap Add WMTS Server dialog"><figcaption></figcaption></figure>

*OS Maps API on api.os.uk* will now display in the list of GIS servers in the Catalog window.

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-ff93d2245f07590b529ad6dd5bd82d05aaddbe4d%2FMap-ArcMap-3.png?alt=media" alt="ArcMap Catalog window showing OS Maps API on api.os.uk in GIS Servers"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Adding layers to the map

Click the *Add Data* button

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-4b684db6fcf5ac4fdbe67f58b6404fae8a57609b%2FMap-ArcMap-4.png?alt=media" alt="ArcMap UI showing Add Data button"><figcaption></figcaption></figure>

In the Add Data dialog:

* Browse to the folder where the OS Maps API is located.
* Select your preferred data layer.
* Click \_Add.

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-717de7f43ee8d7d1ba9eb09b2e9300414bf84b97%2FMap-ArcMap-5.png?alt=media" alt="ArcMap Add Data"><figcaption></figcaption></figure>

\_The layer will then display in the map area:

<figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-1efd65d128194411cdf586a8cfbc012ec54b86c6%2FMap-ArcMap-6.png?alt=media" alt="ArcMap UI showing OS Maps API data"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.os.uk/os-apis/accessing-os-apis/os-maps-api/getting-started/arcmap.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.