AddressBase Premium structure

AddressBase Premium is structured as a series of relational tables. The data structure is described by means of unified modeling language (UML) class diagrams and accompanying tables containing text.

The AddressBase Premium product is constructed as per the following UML diagrams on this page.

Model overview for CSV and GeoPackage

This diagram shows the relationships between each of the record types and their foreign keys.

UML model overview diagram of AddressBase Premium for CSV and GPKG

A UML model of AddressBase Premium in CSV and GPKG formats can be seen in the diagram below. In the UML diagram, feature types from the Ordnance Survey product specification are orange and data types are purple.

record_identifier and pro_order are not included in GPKG format.

UML model showing AddressBase Premium feature types and data types

Model overview for GML

The diagram below shows a high-level data model representing the GML AddressBase Premium data model. This diagram shows the relationships between each of the record types and their foreign keys.

UML model overview diagram of AddressBase Premium for GML

The diagram below is a UML model of AddressBase Premium in GML format; feature types from the Ordnance Survey product specification are orange and data types are purple.

UML model showing AddressBase Premium feature types, enumerations and code lists for the GML supply

Table Descriptions

Street – record identifier 11

• Definition: A way or thoroughfare providing a right of way on foot, by cycle or by motor vehicle, or access to more than one property.

• Description: This record assigns a Unique Street Reference Number (USRN) to each street and holds the start and end coordinates of the street feature with information about surface type and classification.

Street Descriptor – record identifier 15

• Definition: A descriptive identifier providing additional information about the street feature.

• Description: This record holds information about locality, town name and street name.

Basic Land and Property Unit (BLPU) – record identifier 21

• Definition: A BLPU is defined as a real-world object that is an ‘area of land, property or structure of fixed location having uniform occupation, ownership or function’.

• Description: A real-world object that is of interest and within scope of the CLASS_SCHEME.

Application Cross Reference – record identifier 23

• Definition: Application cross reference links to third-party identifiers.

• Description: AddressBase Premium application cross references contain a lookup between the AddressBase Premium UPRN and the unique identifiers of other relevant datasets.

Land and Property Identifier (LPI) – record identifier 24

• Definition: An LPI is a structured entry that identifies a BLPU.

• Description: A simple identifier or description for the object. The richness of the data structure within AddressBase Premium provides the facility to describe a BLPU by more than one LPI.

Delivery Point Address – record identifier 28

• Definition: A Delivery Point Address is defined as a property that receives deliveries from Royal Mail.

• Description: The structure of this address is taken from Royal Mail Postcode Address File (PAF) and other supplementary data files.

Successor Record – record identifier 30

• Definition: This record holds references to a UPRN and to any replacement UPRN, for example, if a building is split into two sub-buildings; the sub-building UPRNs will be referenced in the successor record.

• Description: This record holds information about a UPRN and the UPRNs of the records that succeed that record.

Organisation – record identifier 31

• Definition: A structured entry identifying the name of the current non-domestic occupier of the BLPU.

• Description: This record holds information about the organisation of the record.

Classification – record identifier 32

• Definition: A structured entry that provides the code for the type of BLPU and the classification scheme from which the code is taken.

• Description: This record holds the classification of a property and allows one to search upon the use of a feature.

Table descriptions - CSV only

The following are contained within CSV only:

Header – record identifier 10

• Definition: A structured entry that provides key information about the source, time and supply mechanism of the AddressBase Premium file.

Metadata – record identifier 29

• Definition: A structured entry providing metadata information such as the gazetteer owner, scope and character sets.

Trailer – record identifier 99

• Definition: A structured entry which terminates the file. This includes information on the record counts, and next volume number.

Table descriptions - GML only

The following are contained within GML only:

EntityWithLifeCycle

• Definition: This feature holds the lifecycle information about the data type record.

FeatureWithLifeCycle

• Definition: This feature holds the lifecycle information about the whole feature.

AddressBaseSupplySet

• Definition: This feature is formally known as the GML feature collection and is used to define a collection of features.