> 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/data-demonstrators/addressing-and-location-demonstrators/addressbase-premium.md).

# AddressBase Premium

A Lightning Talk

## AddressBase Premium product overview

* AddressBase Premium is part of the AddressBase Product range, and provides the most data, giving the most detailed view of an address and its life cycle​.
* It has approximately 42 million address records covering England, Wales and Scotland, and 100 million cross references to Valuation Office Agency (VOA) data, OS MasterMap Topography Layer, and OS Highways Network Layer​.
* AddressBase Premium uses the Unique Property Reference Number (UPRN) as its unique identifier to link the data together​.

<div><figure><img src="https://3774974716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzIfdYInJITdcxaLLMhlD%2Fuploads%2Fgit-blob-d04cf09741539aa968196510fbc0cc27df8f6e14%2Faddressbase-premium-triangle.png?alt=media" alt="How AddressBase Premium relates to the other AddressBase products"><figcaption><p>How AddressBase Premium relates to the other AddressBase products</p></figcaption></figure> <figure><img src="https://3774974716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzIfdYInJITdcxaLLMhlD%2Fuploads%2Fgit-blob-5420c4adb749bfd2fd5ace9b8511cc0d3c1fc548%2Faddressbase-premium-unique-identifiers.png?alt=media" alt="diagram of Unique identifiers in AddressBase Premium"><figcaption><p>Unique identifiers in AddressBase Premium</p></figcaption></figure></div>

## AddressBase Premium Key Features

AddressBase Premium provides a more detailed view of an address. It contains approximately 42 million addresses and a range of information relating to the lifecycle of an address.

As well as providing all the approved addresses within AddressBase Plus, AddressBase Premium contains provisional address (proposed planning developments), historic address (demolished properties or properties where the address has changed) and alternate forms of an address are also supplied to include alternate languages and variations on the official address to provide a comprehensive view of addresses with Great Britain.

The product is provided in a relational database model which can all be linked via the UPRN and USRN. The Basic Land and Property Unit (BLPU) table contains key information about the address such as the coordinate values and lifecycle. Links can be made for each BLPU to the classification of the address, information about the street the address resides on and cross reference to multiple OS products and third-party datasets.

<figure><img src="https://3774974716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzIfdYInJITdcxaLLMhlD%2Fuploads%2F7OL8lxRZqtTDmtLLe7tj%2FPicture1.png?alt=media&amp;token=55a17bcc-62e5-49a7-b091-5ddb2913bba0" alt=""><figcaption></figcaption></figure>

## Where does AddressBase Premium data come from?

<figure><img src="https://3774974716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzIfdYInJITdcxaLLMhlD%2Fuploads%2Fgit-blob-276e0299dfdf27dd7f77249668cc3ea535d7f5ae%2Faddressbase-plus-source.png?alt=media" alt="The relationship between the five data providers and Geoplace"><figcaption><p> The relationship between the five data providers and Geoplace (click to enlarge)</p></figcaption></figure>

## AddressBase Premium data attribution

* <mark style="color:purple;">Table</mark>: Application Cross Reference is a lookup table between AddressBase Premium UPRN and the unique identifiers of other relevant third-party data.
* <mark style="color:purple;">Spatial Geometry</mark>: Basic Land and Property Unit (BLPU) is a point feature defined as a real-world object that is an ‘area of land’, ‘property’, or ‘structure’ of fixed location.
* <mark style="color:purple;">Table</mark>: Main Classification contains the address use classification code which defines the use of the BLPU​.
* <mark style="color:purple;">Table</mark>: Delivery Point Address contains the Royal Mail address used when delivering mail​.
* <mark style="color:purple;">Table</mark>: Local Property Identifier (LPI) contains a more detailed description of the BLPU. Each BLPU can have more than one LPI, but will only have one ‘current’ with any others classed as ‘historic’​.
* <mark style="color:purple;">Table</mark>: Organisation contains the ‘non-domestic’ occupier name of the BLPU​.
* <mark style="color:purple;">Spatial Geometry</mark>: Street is a line feature defined as a way or thoroughfare providing a right of way on foot, cycle, or by motor vehicle, or access to more than one property​.
* <mark style="color:purple;">Table</mark>: Street Descriptor contains more detail about the street feature such as street name, locality, town name.

## AddressBase Premium Local Authority data

The Local Land and Property Gazetteer is a database created and managed by Local Authorities where the Unique Property Reference Number (UPRN) is created and assigned to land and property within their district​.

UPRNs can be assigned a hierarchal Parent or Child status if there are multiple UPRNs that share a relationship with each other (E.g. The whole block of flats (Parent UPRN), each flat within the block (Child UPRN).

Each UPRN is linked to a Unique Street Reference Number (USRN) which is held in a different database called the Local Street Gazetteer (LSG)​.

The LSG is managed by the Highway Authority for that area, and they create the USRN.

AddressBase Premium includes the different UPRN types (Provisional, In Use, and Historic) that the Local Authorities assign during different stages of the UPRN and includes tertiary/quaternary level property classifications.

<figure><img src="https://3774974716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzIfdYInJITdcxaLLMhlD%2Fuploads%2Fgit-blob-54d576d355ddf3d5098faa101ca4b25d4cd88802%2Faddressbase-plus-la-data.png?alt=media" alt="diagram of AddressBase Premium Local Authority data" width="563"><figcaption></figcaption></figure>

## AddressBase Premium Royal Mail data​

The Postcode Address File (PAF) database is managed by Royal Mail​

A Unique Delivery Point Reference Number (UDPRN) is created for each PAF and references a specific delivery point​

The PAF has its own Delivery Point Address which may differ from the address held in the LLPG, because it specifically identifies the location in where the property will receive mail

<figure><img src="https://3774974716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzIfdYInJITdcxaLLMhlD%2Fuploads%2Fgit-blob-944872cff1749bab28223f75bd611bae032cd44f%2Faddressbase-plus-rm-data.png?alt=media" alt="diagram of AddressBase Premium Royal Mail data"><figcaption></figcaption></figure>

## AddressBase Premium Valuation Office Agency data​

The Valuation Office Agency (VOA) data is for properties that are non-domestic, and pay business rates​.

When a business reports to the VOA it gives details such as name of the business, the nature of the business, floorspace of the premises. From these details the ‘Organisation’ data is collected​.

The VOA will assign the property on the non-domestic rating list a Special Category code (SCat code) which is a code used by the VOA to classify a property’s business use. There are over 350 SCat codes in use each reference a Sector, and a Sub-sector use classification​.

<figure><img src="https://3774974716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzIfdYInJITdcxaLLMhlD%2Fuploads%2Fgit-blob-cd5f28190c6bead9a7e6998a08924f07d8cd99ac%2Faddressbase-plus-voa-data.png?alt=media" alt="diagram of AddressBase Premium Valuation Office Agency data" width="375"><figcaption></figcaption></figure>

## AddressBase Premium Ordnance Survey data​

AddressBase Premium includes additional data from OS MasterMap Topography layer e.g. Ponds, Electrical Sub Stations, Post Boxes, Public Telephones​.

AddressBase Premium also includes additional data from OS MasterMap Highways Network, identifying footpaths and roads recorded in the LSG.

<figure><img src="https://3774974716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzIfdYInJITdcxaLLMhlD%2Fuploads%2Fgit-blob-e18dd0d3b9443f36f86361b824773ff48227ca49%2Faddressbase-plus-os-data.png?alt=media" alt="diagram of AddressBase Premium Ordnance Survey data" width="188"><figcaption></figcaption></figure>

## Why are there more LPIs than UPRNs?

An LPI is given to a UPRN to give more detail on the land or property, and information which will form its official address.

Where a UPRN is fixed for that land or property, an LPI captures the name and use and can therefore change.

A change to the name, number, use, or classification will result in a new LPI being created, and the old one made historic.

<figure><img src="https://3774974716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzIfdYInJITdcxaLLMhlD%2Fuploads%2Fq7R8gOhuAKDcoWCWaevG%2Fimage.png?alt=media&amp;token=6d36cbde-e1ce-4332-b152-79e51a8ba7cf" alt=""><figcaption><p>Examples of multiple LPIs for one property</p></figcaption></figure>

<figure><img src="https://3774974716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzIfdYInJITdcxaLLMhlD%2Fuploads%2FPZDVGfPKTNkCJXjCKot7%2Fimage.png?alt=media&amp;token=19c41349-1147-485b-bd5c-34604caec80f" alt=""><figcaption><p>Examples of multiple LPIs for one property</p></figcaption></figure>

There can be multiple LPIs to each UPRN, and there can be multiple UPRNs to each delivery point address (DPA). A Delivery Point Address is defined as a property that receives deliveries from Royal Mail.

<figure><img src="https://3774974716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzIfdYInJITdcxaLLMhlD%2Fuploads%2FuyFhInjEeqH4Cic6AYYb%2Fimage.png?alt=media&amp;token=0ab9c38d-b843-4d67-a2fe-2d1356802d4a" alt=""><figcaption><p>Examples of multiple LPIs for one DPA</p></figcaption></figure>

## Lifecycle of a UPRN

<figure><img src="https://3774974716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzIfdYInJITdcxaLLMhlD%2Fuploads%2Fgit-blob-e379b195f11425eea6393629137e25c26c936f55%2Faddressbase-uprn-planning-process.png?alt=media" alt="Flow diagram of the address lifecycle and which organisation is involved at each stage" width="563"><figcaption></figcaption></figure>

UPRNs can be created for lots of different reasons. There is no one set trigger, other than there is a need to reference the pin-pointed location. However, the UPRN is a critical component to the planning process, and are most commonly created for this purpose​ during the Outline Planning stage of the image above.

There can be varying data quality across UPRN data because their level of management is dependent on their Local Authority. GeoPlace set certain standards for Local Authorities to follow to ensure a good level of data management, and to achieve consistency​.

A UPRN will be made historic when the building no longer exists. For example if two flats are made in to one. The two existing UPRNs of the flats will be made historic, and a new UPRN given to the new merged property. The historic UPRNs still exist in the dataset as archived records​.

However, in the OS NGD data it is being published at the original, more granular level.

## Useful Links

* [Sign up to OS Data Hub](https://www.osdatahub.os.uk)​
* [AddressBase Premium Technical Specification](https://docs.os.uk/os-downloads/products/addresses-and-names-portfolio/addressbase-premium/addressbase-premium-technical-specification)
* [AddressBase Premium Islands Technical Specification](https://docs.os.uk/os-downloads/products/addresses-and-names-portfolio/addressbase-premium-islands/addressbase-premium-islands-technical-specification)
* [AddressBase core Principles](https://docs.os.uk/os-downloads/products/addresses-and-names-portfolio/addressbase-fundamentals)
* [AddressBase tools and support](https://www.ordnancesurvey.co.uk/products/addressbase#technical)​
* [The UPRN Lifecycle​](https://static.geoplace.co.uk/downloads/The-UPRN-lifecycle-V3-2015.pdf)

​This content has been developed from what was originally a Lightning Talk PowerPoint slide set. These slides are available to PSGA members to view and download from the [PSGA members area of the OS website](https://auth.ordnancesurvey.co.uk/my.policy)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.os.uk/more-than-maps/data-demonstrators/addressing-and-location-demonstrators/addressbase-premium.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
