Structure
Polygon feature representing a manmade construction that is not a building. Examples include a mast, a chimney, and a crane.
Temporal filtering
The earliest date on which you can request a one-off snapshot of a date in the past for data in this feature type is 29 September 2022.
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
The measured area of the geometry in square metres.
Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)
Nullable: false
Precision: 15
Scale: 6
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: No
Data Schema Version: 1.0
🆕geometry_area_m2
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: structuredescriptionvalue
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:
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 OSLandCoverTierB attribute.
Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Code List Name: structureoslandcovertieravalue
Max Length: 15
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
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.
Please note: 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: true
Code List Name: structureoslandcovertierbvalue
Max Length: 100
Multiplicity: [0..5]
OS NGD API – Features Filterable: Yes
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: Yes
OS Select+Build Filterable: Yes
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.
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
absoluteheightroofbase
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: 6
Scale: 2
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
relativeheightroofbase
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: 6
Scale: 2
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
absoluteheightmaximum
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: 6
Scale: 2
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
relativeheightmaximum
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: 6
Scale: 2
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
absoluteheightminimum
The height, above datum, of the underlying ground surface.
Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)
Nullable: true
Precision: 6
Scale: 2
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
heightconfidencelevel
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 the date third party information was 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
name1_text
Name assigned to identify the feature.
Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 254
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
name1_language
The language type associated with name1. The valid values are defined in the LanguageValue code list.
Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Code List Name: languagevalue
Max Length: 3
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
name1_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 the date third party information was 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
name1_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
name1_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
name2_text
The alternative language name assigned to identify the feature.
Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 254
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
name2_language
The language type associated with name2. The valid values are defined in the LanguageValue code list.
Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Code List Name: languagevalue
Max Length: 3
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
name2_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 the date third party information was 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
name2_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
name2_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
istidal
An indicator that the feature lies within the foreshore, that is, within an area that is affected by normal tides in England and Wales or Spring Tides in Scotland.
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
ishistoric
An indicator that the feature is considered to be historic. For Ordnance Survey purposes, historic is defined as existing artificial features of a date not later than AD 1714, together with very important sites of battlefields and natural features connected with important historical events. Exceptionally, features and sites of a date later than AD 1714 may be indicated with 'isHistoric' if they are of national importance.
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
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
operationalstatus
An indicator of whether the feature is currently performing its original function.
Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Code List Name: operationalstatusvalue
Max Length: 10
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
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
Last updated