> For the complete documentation index, see [llms.txt](https://docs.os.uk/more-than-maps/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/more-than-maps/advanced-applications/os-ngd-data-in-dashboards/os-power-bi-map-visual/os-power-bi-map-visual-getting-started-guide/adding-an-os-basemap.md).

# 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](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="/files/4857e19ce723fa8669e5df7571c2ca979622f2e8" 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'.

<figure><img src="/files/06115f6bf0d0b8ace9c1b80e58db50e8613e30ff" 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="/files/df8d9dbf84f7166d5f63f360b72cec8b7244bd71" 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="/files/d9a69fe4570eb686f3ec05a61ff4a55db9b3f950" alt="A screenshot of part of the project view of the OS Data Hub. An example API key is shown."><figcaption><p>A screenshot of part of 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.

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

<figure><img src="/files/8b6db7bf515952215727be0882c7f38eacb76e7f" alt="Map Settings menu in the Visualizations pane of Power BI showing the text box where you can enter an API Key." width="188"><figcaption><p>Map Settings menu in the Visualizations pane of Power BI.</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## 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).


---

# 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:

```
GET https://docs.os.uk/more-than-maps/advanced-applications/os-ngd-data-in-dashboards/os-power-bi-map-visual/os-power-bi-map-visual-getting-started-guide/adding-an-os-basemap.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.