# Cadcorp SIS

The Cadcorp Spatial Information System (Cadcorp SIS) is an integrated family of geospatial products comprising desktop, web, and developer applications.

Cadcorp SIS Desktop and Cadcorp SIS Desktop Express (free) connects directly to the Ordnance Survey Data Hub through dedicated wizards.

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

## What you need?

* Cadcorp SIS Desktop or Cadcorp SIS Desktop Express (free) version 9 or later
* 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" %}
We used Cadcorp SIS Desktop Express version 9.0.2275 to create these instructions
{% endhint %}

1. Start Cadcorp SIS Desktop. In the opening window, select *Blank Map* or a map template with pre-defined base mapping in the Map Templates area.

   <figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-2ee5c7da1b4c8a204881125e62e3428dd974f9d1%2Fimage.png?alt=media" alt="Cadcorp SIS Desktop UI showing map template options"><figcaption></figcaption></figure>
2. Navigate to *Home > Add Overlay* to launch the Add Overlay wizard.

   <figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-ecdf1602850c1efa07580e28e94a54d61312150c%2Fimage.png?alt=media" alt="Cadcorp SIS Desktop UI showing Home > Add Overlay navigation option"><figcaption><p>Cadcorp SIS Desktop UI showing Home > Add Overlay navigation option</p></figcaption></figure>
3. In the Overlay Types dialog, navigate to *Ordnance Survey (GB) > OS (GB) Data Hub* and then click *Next*.

   <figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-8fdf4c2801d19f8827b90714011a3d36146c28bb%2Fimage%20(11).png?alt=media" alt="Cadcorp SIS Desktop Overlay Types dialog"><figcaption></figcaption></figure>
4. In the OS (GB) Data Hub dialog:
   * If you do NOT have an API key, select the OS Features API, click *Next* and then select *Yes* in the confirmatory dialog that opens. This will use the standard Cadcorp API Key. Note this key restricts your access to free open data and you will not be able to access Premium features.

     <figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-2adfde8e07d5c0cfdad1b20ac65eca2ce833bc12%2Fimage.png?alt=media" alt="Cadcorp SIS Desktop OS (GB) Data Hub dialog"><figcaption></figcaption></figure>
   * If you have an API key, select the *OS Features API,* enter your key in the API Key field, check the *Premium Plan* option and then click *Next*.

     <figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-9c6a91133592c60111470c8555bce803cd8e44c3%2Fimage.png?alt=media" alt="Cadcorp SIS Desktop OS (GB) Data Hub dialog highlighting API Key and Premium Plan fields"><figcaption></figcaption></figure>
5. In the OS Data Hub Features API Products and Feature Types dialog:
   * **Left** box: Select the OS Features API product you want to add to the map. When you do this a list of available feature types for the selected layer display in the Feature Types box (right box).
   * **Right** box: Select the feature types you want to add in the right box by deselecting the feature types you do not require.. All features are selected by default.
   * **Theme**: Select the style for the map in the dropdown. This option is only applicable to some\_ OS Features API layers\_.
   * **Local cache/One-off import**: Select an option to either store locally or download as one-off import.
   * **Filtering**: You can also optionally load features within a specific area of interest (as opposed to the extent of the current map window). See [Defining your area of interest using a polygon](#defining-your-area-of-interest-using-a-polygon) below for instructions.
6. Click *Finish* to add the layer 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-120cda6a5751bec0a037bc7fb26e6a7611fe8c0e%2Fimage.png?alt=media" alt="Cadcorp SIS Desktop OS Data Hub Features API Products and Feature Types dialog"><figcaption></figcaption></figure>
7. The selected features will load within the current map extent. As a best practice, we recommend that you keep the number of features to a minimum.

   <figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-542a84e959365a531b469ad1852db8de87425ec1%2Fimage.png?alt=media" alt="Cadcorp SIS Desktop UI showing OS Features API Data on the map"><figcaption></figcaption></figure>

### Defining your area of interest using a polygon

As an alternative to loading feature to the extent of the current map window, you can use the filtering options available in the OS Data Hub Features API Products and Feature Types dialog (step 5 above).

To do this follow all steps in the instructions above, with the following exceptions:

* Before launching the Add Overlay wizard (step 2 above), select the polygon feature on the map for your area of interest.
* In the OS Data Hub Features API Products and Feature Types dialog (step 5 above), additionally set filtering options in the Filtering area:
  * **Spatial**: Select *Spatial test with current item extent*. If you prefer a different spatial test , select ‘Spatial test with current item’, and this will activate the Spatial test dropdown menu where you can select your spatial test of choice.

    <figure><img src="https://4043944746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoEzqrBzRGoJw7nQyLj1W%2Fuploads%2Fgit-blob-73a68db1acaaf562a34ba0139268dd83507fcd01%2Fimage.png?alt=media" alt="Cadcorp SIS Desktop OS Data Hub Features API Products and Feature Types dialog Highlighting Filtering options"><figcaption></figcaption></figure>
