🔃Getting started with data packages

Step-by-step instructions on how to create new data packages, find and download existing ones, and delete data packages.

Adding a data package to your OS Select+Build recipe allows you to select the area, format, and update frequency to receive for your data.

The following sub-sections on this page cover:

Creating data packages

Finding and downloading existing data packages

Deleting data packages

Viewing Order Summary files

🔃 How do I create a new data package?

Once you've created a recipe, you'll then need to create a data package against it to receive your OS NGD data.

YouTube video showing how to create a recipe using OS Select+Build, add filters to the recipe, then create a data package to receive your OS NGD data. (Creating data packages is discussed around seven minutes into the video.)

To create a new OS NGD data package:

1

Log into your OS Data Hub account

Click Login on the OS Data Hub menu bar to log into your account.

Screenshot showing the OS Data Hub homepage.

2

Navigate to the OS Data Hub workspace

Select Data from the menu bar to view your workspace.

3

Navigate to the OS Select+Build Recipe Library

Choose Downloads > OS Select+Build Recipe Library from the left hand side secondary navigation menu. You will then be taken to your organisation's OS Select+Build Recipe Library.

Screenshot of the OS Select+Build Recipe Library screen in the OS Data Hub.

4

Find the recipe you plan to add a data package against

In your OS NGD Select+Build Recipe Library, scroll or search for the recipe you wish to create a data package against, select that recipe, then click the Add data package button.

5

Add details to the data package

Add the following details to your data package under Add a data package in the secondary navigation menu:

• Give your data package a name.

• Choose the area you want to receive your data for: Either 'All of Britain or Predefined Area' (this means you receive data and it will not be refined by location) or 'Draw a polygon / upload a file / use an OS polygon' (to select a smaller area for your data to be provided for).

• Select the desired coordinate reference system.

• Select a file format: CSV or GeoPackage.

• Select the updates you want: Either not required or COU (Change-Only Update) frequency. There is also an option to select a one-off snapshot of a current or past date.

• Set your initial supply date.

6

Finish creating the data package

Click the Create data package button.

Screenshot showing an example of adding a data package to a recipe using OS Select+Build in the OS Data Hub.

You will receive an email confirming that your data package is being created and another one when your new data package is ready to download.

Please note:

• When you order data through OS Select+Build, the data package/s you receive will be provided at a feature type level. Each feature type you order will be available to download as a .zip file. Currently, grouped files are not available for OS NGD data packages.

• Single or multiple data packages can be created from a single defined recipe. Creating multiple data packages from a single recipe is useful if you want to select a different file format or area of interest for a recipe.

• The Annual Full Supply order frequency option will not be available for a data package containing one (or more) of the new feature types or new data schema versions of existing feature types released in March and / or September of the current year. If you select an Annual Full Supply frequency for your OS NGD data order in OS Select+Build, we will provide you with the data as it was on 01 January of the current year. This means if a new feature type or a new data schema version of an existing feature type was released after 01 January and you order either of these as part of your Annual Full Supply, you will receive an empty data package for the newly released feature type / new data schema version of an existing feature type. The data for the new feature type / new data schema version of an existing feature type will then be included in your supply on the next 01 January after the release, after which point, data packages containing one of these feature types will no longer contain blank files.

How do I find and download an existing data package?

All OS NGD, OS OpenData and OS Premium data packages created and ordered by your organisation will be catalogued in your Data Packages list in the OS Data Hub.

To find and download an existing data package:

1

Log into your OS Data Hub account

Click Login on the OS Data Hub menu bar to log into your account.

Screenshot showing the OS Data Hub homepage.

2

Navigate to the OS Data Hub workspace

Select Data from the menu bar to view your workspace.

3

Navigate to Data packages

Choose Downloads > Data packages from the secondary navigation menu. You will then be taken to your data package list.

4

Find the data package you're looking for

Scroll through the list to find a particular data package or use the search bar to search by data package name, data package number, or product name.

Screenshot showing an example of the Data packages list screen in the OS Data Hub.

Data packages linked to an OS NGD recipe

Data packages linked to an OS NGD recipe can be identified by their prefix of 'OS NGD Recipe' against the recipe name in the Product column in the Data packages list.

Screenshot showing an example of the 'OS NGD Recipe' prefix.

5

Download the desired data package

• Once you have found the data package you want from the list, click the Download button in the Status column.

• You are now within the Data package summary screen, where you can view and download files. Under 'Individual file downloads' in the bottom left-hand side of your screen, you will see a .zip file for every feature type in your data package order. Click on a file to download it.

What is the Order Summary file?

Feature types downloaded via OS Select+Build will be supplied with an Order Summary File, a small JSON manifest that provides key metadata about the supplied file. You can use this file to validate the data to ensure the currency, record counts (feature counts), schema version, feature name and coordinate reference system (CRS) match your expected order.

The following file naming convention will be applied to each Order Summary File you receive:

• collection_featuretype_orderSummary.json

For example, the file name for the Building Line Feature Type Order Summary File would look like this:

• bld_fts_buildingline_orderSummary.json

The example below shows the information an Order Summary File contains:

{
 "featureName": "bld-fts-buildingline",
 "crs": "http://www.opengis.net/def/crs/EPSG/0/27700",
 "schemaVersion": "1.0",
 "validFromDate": null,
 "validToDate": "2023-03-01",
 "recordCount": 202653
}

The following table provides a brief description of each field:

Field	Description	Use
featureName	The feature type delivered in this order.	Validate the downloaded feature against your recipe.
crs	The coordinate reference system used for your supply.	Validate the coordinate reference system against the CRS selected for your recipe.
schemaVersion	The OS NGD data schema version provided for the feature.	Coordinate data schema updates with changes to your data.
validFromDate	The start date of coverage for this supply.	Validate the currency of your data to ensure the earliest date aligns with the expected supply window for your order frequency.
validToDate	The end date of coverage for this supply.	Validate the currency of your data to ensure the latest date aligns with the expected supply window for your order frequency.
recordCount	The total number of records delivered in the file.	Check that delivered entries match the number of records expected for your download.

How do I delete a data package?

To delete an existing OS NGD data package:

1

Log into your OS Data Hub account

Click Login on the OS Data Hub menu bar to log into your account.

Screenshot showing the OS Data Hub homepage.

2

Navigate to the OS Data Hub workspace

Select Data from the menu bar to view your workspace.

3

Navigate to Data packages

Choose Downloads > Data packages from the secondary navigation menu. You will then be taken to your data package list.

4

Find the data package you are looking for

Scroll through the list to find a particular data package or use the search bar to search by data package name, data package number, or product name.

Screenshot showing an example of the Data packages list screen in the OS Data Hub.

Data packages linked to an OS NGD recipe

Data packages linked to an OS NGD recipe can be identified by their prefix of 'OS NGD Recipe' against the recipe name in the Product column in the Data packages list.

Screenshot showing an example of the 'OS NGD Recipe' prefix.

5

Delete the package from the data packages summary screen

• Click the Package options dropdown in the top right-hand side of your screen.

• Click Delete package.

Screenshot showing an example of a Data package summary screen in the OS Data Hub with the Package options dropdown open.

A warning pop up will appear.

• Click the Delete package button in the pop up.