Installation

These instructions detail how to install the OS Power BI Map Visual.

Installing the OS Power BI Map Visual is straightforward and requires only a few steps.

Installing the OS Power BI Map Visual

1

Download the visual

The visual is open source and can be downloaded for free from the OS GitHub repository. Download the .pbiviz file of the latest release from this page.

2

Click the three small dots under the Visualizations pane in Power BI

The context menu should provide options to import or remove a visual from Power BI.

Importing a visual using the OS Maps plugin from the Power BI Visualizations pane.

3

Click Import a visual from a file from the right-click context menu

The file explorer should open to allow you to navigate to the folder containing the .pbiviz file.

4

Select the .pbiviz file

Once you have downloaded the .pbiviz file from the Releases page of the OS GitHub repository, select the file from the relevant folder, then click OK to import it into the app.

After installing the visual, click the OS icon and add it to a report. When you add a visual to a report, you’ll be presented with a landing page:

The OS Power BI Map Visual landing page.

Linking the OS Power BI Map Visual to the OS Maps API

Rendering a basemap requires an OS Maps API Key, available from the OS Data Hub. If you already have access to the OS Data Hub, skip to the Adding an OS basemap page; otherwise, sign up for access to the OS Data Hub using the instructions below.

Signing up for the OS Data Hub

For Public Sector Geospatial Agreement (PSGA) Members:

• Register via the appropriate Public Sector Plan on the OS Data Hub.

• You’ll need to be invited by the administrator of your organisation’s OS Data Hub account. (It’s usually someone in your GIS / Geospatial Team). If you can’t find your OS Data Hub Administrator or want to know their contact details, please contact [e-mail] or your OS Account Manager.

For individuals and commercial organisations:

• Register via an OS Open Data plan on the OS Data Hub to use the OS Maps API for free.

Please note that the maximum zoom levels will be capped for maps using the free OS OpenData plan. The maximum zoom levels will incur a cost as they are classed as Premium data. A Premium data toggle is present within the visual to control this, so you can choose whether to use Premium data or stick to free OS OpenData.

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.

• Users requiring maps without restrictions will require a Premium OS data licence. This can be acquired via an OS Partner.