# Adding an OS basemap

Follow the steps below to add an OS basemap:

{% stepper %}
{% step %}

### Create a project on the OS Data Hub

Once logged in to the [OS Data Hub website](https://osdatahub.os.uk/), select Data from the main menu, then select APIs > API Projects from the secondary navigation menu, then click the *Create a new project* button.

<figure><img src="https://1897589978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNpJpLP8RROUaWVQo5ea%2Fuploads%2FObb6iX9fis9vSIfXlXCC%2Fimage%20(9).png?alt=media&#x26;token=c678c855-4e29-4fc3-935a-d9f7986a6b46" alt="A screenshot of the OS Data Hub projects page showing the &#x27;Create a new project&#x27; button in the upper right hand corner"><figcaption><p>Creating a new project in the OS Data Hub.</p></figcaption></figure>
{% endstep %}

{% step %}

### Name your project

For this example, the project has been named 'Power BI'.<br>

<figure><img src="https://1897589978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNpJpLP8RROUaWVQo5ea%2Fuploads%2FufnqFWsNzQNViO6RZpvb%2F4.png?alt=media" alt="A screenshot of the create project naming dialog box showing a text box and instructions for naming your OS Data Hub project."><figcaption><p>Naming a project dialog in the OS Data Hub.</p></figcaption></figure>
{% endstep %}

{% step %}

### Add an API to the project

Select *OS Maps API* from the available OS APIs, then click the *Add to project* button on the right-hand side of the view.

<figure><img src="https://1897589978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNpJpLP8RROUaWVQo5ea%2Fuploads%2FvYGamnUnCo0m7SfeOq2N%2F5.png?alt=media" alt="A screenshot of the OS Maps API available to be added to the project, shown in the OS Data Hub view."><figcaption><p>Selecting an API to add to a project in the OS Data Hub.</p></figcaption></figure>

{% endstep %}

{% step %}

### Copy the project API Key for use in Power BI

Navigate to the project page and open the project that was recently created for Power BI. The project view will have a project API Key available. Copy this API Key to the clipboard.

<figure><img src="https://1897589978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNpJpLP8RROUaWVQo5ea%2Fuploads%2FYfkBCoOCQ32laBfJ7KHf%2F6.jpeg?alt=media" alt="A screenshot of part of the project view of the OS Data Hub. An example API key is shown."><figcaption><p>An example of a project API Key in the project view of the OS Data Hub.</p></figcaption></figure>

{% endstep %}

{% step %}

### Paste the OS Maps API Key into the OS Maps for Power BI Visual

Within the OS Visual setting menu in Power BI, open the Visualizations pane and navigate to Format visual > Map Settings. The first entry of the Map Settings menu is an input text box called 'OS API Key’. Paste in your project API Key from the OS Data Hub into this text box.&#x20;

*Once your project API Key has been added, an OS basemap should render automatically.*<br>

<figure><img src="https://1897589978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNpJpLP8RROUaWVQo5ea%2Fuploads%2Fim01Y6P9upl8DdkN2ri8%2F7.png?alt=media" alt="Map Settings menu in the Visualizations pane of Power BI showing the text box where you can enter an API Key."><figcaption><p>Map Settings menu in the Visualizations pane of Power BI. </p></figcaption></figure>

{% hint style="warning" %}

### Using Premium data

#### Public Sector Organisations / PSGA (Public Sector Geospatial Agreement) Members

If you want to fully zoom into the map, please make sure that the ‘Use Premium data’ toggle setting located beneath the OS API Key input box (in the Visualizations pane) is switched to *On*. If you registered on the OS Data Hub using a Public Sector Plan account (i.e. you are a PSGA Member), then there is **no additional charge for using Premium data**.

#### Non-PSGA Members

For non-PSGA Members using the free OS OpenData plan, please note that the maximum zoom levels will incur a cost as they are classed as Premium data. You should ensure that the ‘Use Premium data’ toggle setting located beneath the OS API Key input box (in the Visualizations pane) is switched to *Off*.

For more information on which zoom levels are OS OpenData and which are Premium data for the OS Maps API, please see the tables on the [OS Maps API Layer and Styles page](https://docs.os.uk/os-apis/accessing-os-apis/os-maps-api/layers-and-styles).
{% endhint %}
{% endstep %}
{% endstepper %}