Installation

These instructions detail how to install OS Maps for Power BI Visual.

Installing OS Maps for Power BI Visual is straightforward and requires only a few steps. You should have received a link to Dropbox that contains a .pbiviz file with the name of your organisation on it. The .pbiviz file contains the visual that you'll import into Power BI.

Installing OS Maps for Power BI Visual

1

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.

2

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.

3

Select the .pbiviz file

Select the OS Maps for Power BI Visual 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:

OS Visual landing page.

Linking the Power BI 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 customers (i.e. 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.

Premium OS data licence for internal business use

Customers shouldn’t sign up for an OS Premium Data Plan directly on the OS Data Hub to use the OS Maps for Power BI Visual for internal business use, as this is not covered under the plan's licence.