# Data supply

## Supply options

### DVD supply for an area of interest <a href="#id-3.1.1_dvd_supply_for_an_area_of_interest" id="id-3.1.1_dvd_supply_for_an_area_of_interest"></a>

When you receive an order via hard media (DVD), the following files will be supplied if the supply is not a Managed Great Britain Set (MGBS):

* Data
* Doc
* Order\_Details.txt

Within the Data directory, data files will be found in their compressed format.

A text file called Label Information can be found within the Doc directory. This file is a replica of the information on the DVD should you need to reproduce or reprint this.

The Order\_Details.txt provides information about the supply, including supply type, format, dates of order, currency and change. It also contains a list of all the zipped folders contained in the Data directory.

### DVD supply of Managed Great Britain Sets <a href="#id-3.1.2_dvd_supply_of_managed_great_britai" id="id-3.1.2_dvd_supply_of_managed_great_britai"></a>

The following files will be supplied when you receive an order of a Managed Great Britain Set (MGBS) via hard media (DVD):

* Data
* Doc
* Order\_Details.txt

Within the Data directory, data files will be found in their compressed format.

A text file called Label Information can be found within the Doc directory. This file is a replica of the information on the DVD should you need to reproduce or reprint this.

The Order\_Details.txt file provides information about the supply, including supply type, format, dates of order, currency and change. It also contains a list of all the zipped folders contained in the Data directory.

### Secure File Transfer Protocol <a href="#id-3.1.3_secure_file_transfer_protocol" id="id-3.1.3_secure_file_transfer_protocol"></a>

With a Secure File Transfer Protocol (SFTP) order, the same information is supplied as in [DVD supply for an area of interest](#id-3.1.1_dvd_supply_for_an_area_of_interest), but the file names will be slightly different, reflecting the SFTP order number.

### Download <a href="#id-3.1.4_download" id="id-3.1.4_download"></a>

The AddressBase Premium and AddressBase Premium Islands products are available as online downloads for customers who have signed up to the Public Sector Plan on the OS Data Hub. From October 2021, Premium Plan members will be able to download AddressBase Premium and AddressBase Premium Islands data from the OS Data Hub. Data can be downloaded in various formats.

<details>

<summary>Download instructions</summary>

Public Sector Plan members should use the following instructions to download the products from the OS Data Hub:

1. Sign in to your PSGA organisation account on [OS Data Hub](https://osdatahub.os.uk/).
2. Click *Download* on the top navigation bar. You will be taken to the *Premium Data Downloads* catalogue.
3. Search and select the premium product you want.
4. Click the *Add data package* button.
5. Enter a data package name. We suggest using a name that will help you easily identify the data package later. Data package names don’t have to be unique.\\

   {% hint style="info" %} A data package is a downloadable file or group of files containing the product data you want to receive. There can be more than one version of a data package when new product updates are available to download.\
   \
   To download (order) data, you create a data package in the OS Data Hub for the product you want, and specify the area, format and update cycle. Once the system has fulfilled the data package, you can download it from the data package list, under Data packages on the left menu in your OS Data Hub account. {% endhint %}6. Choose your area. For user-defined areas, draw your area of interest (AOI) using the drawing tools or upload a polygon to the map from the polygon library.
6. Select *file format*. We show only the available file formats for that selection.
7. Select *updates*. We show only the available updates for that selection.
8. Click the *Create data package* button.
9. The confirmation page tells you the data package is being created, with options to *Add another data package* or click to *view the data package status* in the data package list. You will also receive a confirmation email when a data package is created.
10. The data package list displays all the data packages for your organisation. Once a data package has been fulfilled, the status will change from *Available soon* to *Download*. You will also receive an email when the data package is ready to download.
11. Click the *Download* button to open the data package and download the zip file(s).\\

    <figure><img src="/files/eTfJHkyB9PL6ERD3wMJJ" alt="Download button in OS Data Hub"><figcaption><p>Download button in OS Data Hub</p></figcaption></figure>

</details>

## File naming <a href="#id-3.2_file_naming" id="id-3.2_file_naming"></a>

The data is supplied as chunked files that cover your selected area. These files are named according to the convention shown in the following sub-sections.

When you open your data, you will see a series of zip folders:

### Non-geographic chunks <a href="#id-3.2.1_non-geographic_chunks" id="id-3.2.1_non-geographic_chunks"></a>

For a MGBS supply of CSV and GML, you will see a single zip folder when you receive your download data. On opening the data link folder, you will see a series of separate unzipped files.

For example:

* `AddressBasePremium_FULL_2011-07-29_001_csv.zip` (full supply of CSV) or
* `AddressBasePremium_COU_2011-07-29_001_gml.zip` (COU supply of GML)

For a MGBS supply of GeoPackage, you will see a single zip folder when you receive your download data. On opening the data link folder, you will see a single unzipped file.

For example:

* `AddressBasePremium_FULL_2011-07-29_001_gpkg.zip` (full supply of GPKG)

### Geographic chunks <a href="#id-3.2.2_geographic_chunks" id="id-3.2.2_geographic_chunks"></a>

When you receive your geo-chunked download data for CSV and GML, you will see a series of zipped folders on opening the data.

For example:

* `AddressBasePremium_FULL_2011-07-29_TQ2020_csv.zip` (full supply of CSV) or
* `AddressBasePremium_COU_2011-07-29_TQ2020_gml.zip` (COU supply of GML)

When you receive your geo-chunked download data for GPKG, you will see a single zipped folder on opening the data.

For example:

* `AddressBasePremium_FULL_2011-07-29_001_gpkg.zip` (full supply of GPKG)

## Unzipping the data <a href="#id-3.3_unzipping_the_data" id="id-3.3_unzipping_the_data"></a>

The GML, GPKG and CSV data are supplied in a compressed form (ZIP). Some software can access these files directly, while other software will require it to be unzipped.

To unzip the zipped data files (`.zip` extension), you can use an unzipping utility included with most modern operating systems. Alternatively, open-source zipping/unzipping software can be downloaded from the Internet such as 7-Zip.

When the files are unzipped, they are ready for use and will appear as follows:

#### Non-geographic chunks <a href="#id-3.3.1_non-geographic_chunks" id="id-3.3.1_non-geographic_chunks"></a>

* `AddressBasePremium_FULL_2020-02-11_001.csv`
* `AddressBasePremium_ISL_FULL_2020-02-18_001.gml`
* `AddressBasePremium_FULL_2020-02-18_001.gpkg`

#### Geographic chunks <a href="#id-3.3.2_geographic_chunks" id="id-3.3.2_geographic_chunks"></a>

* `AddressBasePremium_2011-07-29_NC4040.csv`

For GPKG supply, one GPKG will be supplied which will contain all the tiles:

* `AddressBasePremium_FULL_2020-02-18_001.gpkg`


---

# Agent Instructions: 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/os-downloads/products/addresses-and-names-portfolio/addressbase-premium/addressbase-premium-getting-started-guide/data-supply.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.