Building Part

Polygon feature representing either a complete separate building, or part of a larger building where internal divisions exist from ground to roof level which can be identified externally. Examples of Building Part features include a multi-storey car park, a castle or a windmill.

Temporal filtering

The earliest and latest dates on which you can request a one-off snapshot of a date in the past for the data schema versions available for this feature type are detailed in the following table:

Data schema version

Earliest date

Latest date

1.0

29 September 2022

Ongoing

2.0

25 September 2024

Ongoing

Please see Data schema versioning for more information about versioning in the OS NGD Buildings Theme.

Feature type attributes

The following sub-sections provide details about the attributes included with this feature type, their data types in the different output formats and other important metadata about them.

osid

Primary identifier for the feature. The OSID is a Globally Unique Identifier (GUID) and requires no centralised authority to ensure uniqueness. Note that the same OSID can occur in more than one feature type when a single feature is represented multiple times in the OS NGD.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Max Length: 36
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

toid

Topographic identifier (TOID) of the feature, as published in the OS MasterMap suite of products.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 20
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

versiondate

Date when the version was last updated.

Data Types: String (GeoJSON), Date (GPKG), Date (CSV)
Nullable: false
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

versionavailablefromdate

The date this version of the feature became the latest version.

Data Types: String (GeoJSON), DateTime (GPKG), DateTime (CSV)
Nullable: false
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

versionavailabletodate

The date this version of the feature was superseded by an update or ceased to exist.

Data Types: String (GeoJSON), DateTime (GPKG), DateTime (CSV)
Nullable: true
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

firstdigitalcapturedate

Represents the date on which a feature was first digitised by Ordnance Survey.

Data Types: String (GeoJSON), Date (GPKG), Date (CSV)
Nullable: true
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

changetype

The type of change that generated a new version of the feature.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Code List Name: changetypevalue
Max Length: 50
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0,

geometry

Geometry for the feature.

Data Types: Geometry (GeoJSON), Geometry (GPKG), WKT (CSV)
Nullable: false
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Geometry Type: Polygon

geometry_area_m2 (formerly geometry_area)

This attribute was called geometry_area in data schema version 1.0 and was renamed geometry_area_m2 from version 2.0 onward.

The measured area of the geometry in square metres.

Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)
Nullable: false
Precision: 15
Scale: 3
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: No
Data Schema Version: 2.0

geometry_evidencedate

The date on which the latest evidence was gathered to make an update if required. For example, the date of collection by a surveyor or third party information received.

Data Types: String (GeoJSON), Date (GPKG), Date (CSV)
Nullable: true
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

geometry_updatedate

Date when the attribute was last updated.

Data Types: String (GeoJSON), Date (GPKG), Date (CSV)
Nullable: false
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

geometry_source

The source organisation who provided the data.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0

geometry_capturemethod

Indication of the method used to capture or produce the data.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Code List Name: capturemethodvalue
Max Length: 25
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

theme

The OS NGD theme to which this feature belongs.

Data Types: Array (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Code List Name: themevalue
Max Length: 40
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

description

A single descriptive value intended for a quick understanding of what the feature represents.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Code List Name: buildingpartdescriptionvalue
Max Length: 50
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0

description_evidencedate

The date on which the latest evidence was gathered to make an update if required. For example, the date of collection by a surveyor or third party information received.

Data Types: String (GeoJSON), Date (GPKG), Date (CSV)
Nullable: true
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

description_updatedate

Date when the attribute was last updated.

Data Types: String (GeoJSON), Date (GPKG), Date (CSV)
Nullable: false
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

description_source

The source organisation who provided the data.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0

description_capturemethod

Indication of the method used to capture or produce the data.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Code List Name: capturemethodvalue
Max Length: 25
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

oslandcovertiera

A high-level description of the land cover; more detail is provided in the OS Land Cover Tier B attribute.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Code List Name: buildingpartoslandcovertieravalue
Max Length: 15
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

oslandcovertierb

A detailed description of the land cover type. Up to five distinct land cover types can be applied.

The max length specified below is the maximum length of 1 permissible value. This attribute can have up to 5 permissible values.

Data Types: Array (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Code List Name: buildingpartoslandcovertierbvalue
Max Length: 25
Multiplicity: [1..5]
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

oslandcover_evidencedate

The date on which the latest evidence was gathered to make an update if required. For example, the date of collection by a surveyor or third party information received.

Data Types: String (GeoJSON), Date (GPKG), Date (CSV)
Nullable: true
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

oslandcover_updatedate

Date when the attribute was last updated.

Data Types: String (GeoJSON), Date (GPKG), Date (CSV)
Nullable: false
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

oslandcover_source

The organisation that provided the information.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0

oslandcover_capturemethod

Indication of the method used to capture or produce the data.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Code List Name: capturemethodvalue
Max Length: 25
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

oslandusetiera

A high-level description of the main activity that takes place at the location or that the feature supports.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Code List Name: oslandusetieravalue
Max Length: 50
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0

oslandusetierb

A detailed description of the main activity that takes place at the location or that the feature supports.

The max length specified below is the maximum length of 1 permissible value. This attribute can have up to 2 permissible values.

Data Types: Array (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Code List Name: oslandusetierbvalue
Max Length: 200
Multiplicity: [0..2]
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

oslanduse_evidencedate

The date on which the latest evidence was gathered to make an update if required. For example, the date of collection by a surveyor or third party information received.

Data Types: String (GeoJSON), Date (GPKG), Date (CSV)
Nullable: true
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

oslanduse_updatedate

Date when the attribute was last updated.

Data Types: String (GeoJSON), Date (GPKG), Date (CSV)
Nullable: false
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

oslanduse_source

The organisation that provided the information.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0

oslanduse_capturemethod

Indication of the method used to capture or produce the data.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Code List Name: capturemethodvalue
Max Length: 25
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

height_absoluteroofbase_m (formerly absoluteheightroofbase)

This attribute was called absoluteheightroofbase in data schema version 1.0 and was renamed height_absoluteroofbase_m from version 2.0 onward.

The height, above datum, of the base of the roof, that is, where the roof intersects the building walls.

Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)
Nullable: true
Precision: 5
Scale: 1
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: No
Data Schema Version: 2.0

height_relativeroofbase_m (formerly relativeheightroofbase)

This attribute was called relativeheightroofbase in data schema version 1.0 and was renamed height_relativeroofbase_m from version 2.0 onward.

The difference in height between the intersection of the external building walls and the underlying ground surface and the base of the roof of the building.

Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)
Nullable: true
Precision: 4
Scale: 1
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: No
Data Schema Version: 2.0

height_absolutemax_m (formerly absoluteheightmaximum)

This attribute was called absoluteheightmaximum in data schema version 1.0 and was renamed height_absolutemax_m from version 2.0 onward.

The height, above datum, of the highest point of the building; this could include a chimney or other structure on a building.

Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)
Nullable: true
Precision: 5
Scale: 1
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 2.0

height_relativemax_m (formerly relativeheightmaximum)

This attribute was called relativeheightmaximum in data schema version 1.0 and was renamed height_relativemax_m from version 2.0 onward.

The difference in height between the intersection of the external building walls and the underlying ground surface and the highest point on the building.

Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)
Nullable: true
Precision: 4
Scale: 1
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: No
Data Schema Version: 2.0

height_absolutemin_m (formerly absoluteheightminimum)

This attribute was called absoluteheightminimum in data schema version 1.0 and was renamed height_absolutemin_m from version 2.0 onward.

The height, above datum, of the underlying ground surface.

Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)
Nullable: true
Precision: 5
Scale: 1
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 2.0

height_confidencelevel (formerly heightconfidencelevel )

This attribute was called heightconfidencelevel in data schema version 1.0 and was renamed height_confidencelevel from version 2.0 onward.

The confidence in the quality of the height attributes for the building or structure expressed in qualitative terms.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Code List Name: builtstructureheightconfidencevalue
Max Length: 15
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

height_evidencedate

The date on which the latest evidence was gathered to make an update if required. For example, the date of collection by a surveyor or third party information received.

Data Types: String (GeoJSON), Date (GPKG), Date (CSV)
Nullable: true
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

height_updatedate

Date when the attribute was last updated.

Data Types: String (GeoJSON), Date (GPKG), Date (CSV)
Nullable: true
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

height_source

The organisation that provided the information.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0

associatedstructure

Indicates whether the feature is part of a larger structure and the nature of the structure, for example, a dam, bridge or breakwater.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Code List Name: compoundstructuredescriptionvalue
Max Length: 25
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

isobscured

An indicator that the feature is at ground level but lies below another feature represented in the data. For example, a road with a bridge over it will have the attribute set to 'True'.

Data Types: Boolean (GeoJSON), Integer (GPKG), String (CSV)
Nullable: false
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

physicallevel

The relative relationship of the feature to ground surface level, where ground surface level is the lowest identifiable level that is not underground.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Code List Name: physicallevelvalue
Max Length: 15
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

capturespecification

Indicates the capture specification used by OS when capturing the feature. This could either be Urban, Rural or Moorland.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Code List Name: capturespecificationvalue
Max Length: 10
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0

containingsitecount

A count of the number of Land Use Sites the feature lies within.

Data Types: Integer (GeoJSON), Integer (GPKG), Integer (CSV)
Nullable: false
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

smallestsite_siteid

The identifier of the smallest Land Use Site feature that the topographic area feature lies within.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 36
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

smallestsite_landusetiera

A high-level description of the main activity that takes place at the location of the smallest Land Use Site feature the feature lies within, if any.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Code List Name: oslandusetieravalue
Max Length: 50
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

smallestsite_landusetierb

A more detailed description of the main activity that takes place at the location of the smallest Land Use Site feature the feature lies within, if any.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Code List Name: oslandusetierbvalue
Max Length: 200
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

largestsite_landusetiera

A high-level description of the main activity that takes place at the location of the largest Land Use Site feature the feature lies within, if any.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Code List Name: oslandusetieravalue
Max Length: 50
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

largestsite_landusetierb

A more detailed description of the main activity that takes place at the location of the largest Land Use Site feature the feature lies within, if any.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Code List Name: oslandusetierbvalue
Max Length: 200
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

nlud_code

An alternative land use classification that uses a code defined in the National Land Use Database schema. Populated in the first instance from the land use of the largest Land Use Site (if any) that the feature lies within, and if that does not apply, then by any land use implicit in the nature of the feature itself.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 4
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

nlud_orderdescription

A description of the highest (least detailed) level of an alternative land use classification as defined in the National Land Use Database schema. Populated in the first instance from the land use of the largest Land Use Site (if any) that the feature lies within, and if that does not apply, then by any land use implicit in the nature of the feature itself.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 30
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

nlud_groupdescription

A description of the second level of an alternative land use classification as defined in the National Land Use Database schema. Populated in the first instance from the land use of the largest Land Use Site (if any) that the feature lies within, and if that does not apply, then by any land use implicit in the nature of the feature itself.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 40
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

address_classificationcode

An alternative land use classification that uses a code defined in the Address/BS7666 schema. Populated only where local authority address information lies within a Land Use Site that the feature also falls within. The value is derived by analysis of the attribution of Address information that falls within the extent of the smallest Land Use Site that the feature lies within. Where the address information within the extent of the Site contains differing primary level classifications, then no Address Code value is provided.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 2
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

address_primarydescription

The description of the highest (least detailed) level of an alternative land use classification as defined in the Address/BS7666 schema. Populated only where local authority address information lies within a Land Use Site that the feature also falls within. The value is derived by analysis of the attribution of Address information that falls within the extent of the smallest Land Use Site that the feature lies within. Where the address information within the extent of the Site contains differing primary level classifications, then a value of ‘Mixed’ is applied.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

address_secondarydescription

The description of the second level of an alternative land use classification as defined in the Address/BS7666 schema. Populated only where local authority address information lies within a Land Use Site that the feature also falls within. The value is derived by analysis of the attribution of Address information that falls within the extent of the smallest Land Use Site that the feature lies within. Where the address information within the extent of the Site contains differing secondary level classifications, then no value is provided.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

lowertierlocalauthority_gsscode

The unique identifier of the Lower Tier Local Authority administrative area provided by the Office for National Statistics that the Topographic feature lies within. Where a Topographic area falls into more than one Lower Tier Local Authority, then it will be assigned to the Lower Tier Local Authority that the majority of its area lies within. Where a Topographic area falls outside any Lower Tier Local Authority (for example, an offshore feature), then no code will be provided.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 10
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

lowertierlocalauthority_count

The total number of Lower Tier Local Authority administrative areas the feature lies within. Where a feature falls within more than one LTLA and the resultant subdivided areas are either less than 10% of original total area or are less than 2 square metres in area then the count excludes these smaller subdivided areas from the value provided.

Data Types: Integer (GeoJSON), Integer (GPKG), Integer (CSV)
Nullable: false
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

status

The state of the feature in relation to either its physical condition or the activity the feature is intended to support.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Code List Name: statusvalue
Max Length: 20
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

status_updatedate

Date when the attribute was last updated.

Data Types: String (GeoJSON), Date (GPKG), Date (CSV)
Nullable: true
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

Site Reference

A cross reference table mapping Building Part to Site. The following sub-sections provide details about the attributes included in this cross reference table, their data types in the different output formats, and other important metadata about them.

siteid

The identifier for the Site feature.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Max Length: 36
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

buildingpartid

The identifier for the Building Part feature.

Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Max Length: 36
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

buildingpartversiondate

The date this version of the feature entered the OS National Geographic Database.

Data Types: String (GeoJSON), Date (GPKG), Date (CSV)
Nullable: false
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0

Last updated 2 months ago