Site
Last updated
Last updated
Polygon feature which represents the recognisable extent of certain types of function or activity. Examples include a caravan site, a university, and a railway centre.
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 |
|---|---|---|
Please see Data schema versioning for more information about versioning in the OS NGD Land Use Theme.
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.
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
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
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
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
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
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 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
Geometry Type: MultiPolygon
This attribute is called geometry_area in data schema version 1.0 and has been 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
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
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
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
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
The OS NGD theme to which this feature belongs.
Data Types: String (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
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: sitedescriptionvalue
Max Length: 50
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
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
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
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
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
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
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 4 permissible values.
Data Types: Array (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Code List Name: oslandusetierbvalue
Max Length: 200
Multiplicity: [0..4]
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
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
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
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
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
The name of the main party operating the site, currently limited to information on universities and railway stations.
Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 99
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 2.0
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
The language of name1, provided as a 3-digit ISO 639-2 code ('eng, 'cym', 'gla').
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
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
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
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
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
The language of name2, provided as a 3-digit ISO 639-2 code ('eng, 'cym', 'gla').
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
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
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
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
The confidence in the quality of the geometry for the extent of a site or named area.
Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Code List Name: siteextentdefinitionvalue
Max Length: 30
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
This attribute is called primaryuprn in data schema version 1.0 and has been renamed matcheduprn from version 2.0 onward.
The Unique Property Reference Number (UPRN) of the Address record considered most likely to represent the same Site. Where no Address record can be identified unambiguously, then no UPRN is provided.
Data Types: Integer (GeoJSON), Integer (GPKG), Integer (CSV)
Nullable: true
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0
A description of how the matchedUPRN has been identified.
Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Code List Name: matchedurpnvalue
Max Length: 40
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0
An alternative land use classification that uses a code defined in the Address/BS7666 schema. The value is derived by analysis of the attribution of NGD Address information that falls within the extent of the Site. Where the addresses within a Site contain differing primary level classifications, 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
The description of the highest (least detailed) level of an alternative land use classification as defined in the Address/BS7666 schema. The value is derived by analysis of the attribution of NGD Address information that falls within the extent of the Site. Where the addresses within a Site contain differing primary level classifications, 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
The description of the second level of an alternative land use classification as defined in the Address/BS7666 schema. The value is derived by analysis of the attribution of NGD Address information that falls within the extent of the Site. Where the addresses within a Site contain 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
A description of how consistent the Address Classification recorded as addressLandUse_classificationCode, addressLandUse_primaryDescription and addressLandUse_secondaryDescription is when compared to the OS land use attribution of the Site. Where address_classificationsource is either ‘Child Address’ or ‘Multiple Addresses’ the classification correlation analysis is only carried out to the level of classification provided (Primary or Secondary), but where address_classificationsource is 'Matched UPRN’ the correlation analysis is carried out to the lowest level the address is classified to.
Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Code List Name: classificationcorrelationvalue
Max Length: 30
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0
A description of the derivation of the Address Classification recorded as addressLandUse_classificationCode, addressLandUse_primaryDescription and addressLandUse_secondaryDescription.
Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Code List Name: addressclassificationsourcevalue
Max Length: 20
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0
The total number of NGD addresses of any type that lie within the extent of the Site geometry.
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
The total number of NGD addresses that have a primary classification of ‘Residential’ that lie within the extent of the Site geometry.
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
The total number of NGD addresses that have a primary classification of ‘Commercial’ that lie within the extent of the Site geometry.
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
The total number of NGD addresses that do not have a primary classification of either ‘Residential’ or ‘Commercial’ that lie within the extent of the Site geometry.
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
An alternative land use classification that uses a code defined in the National Land Use Database schema.
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
A description of the highest (least detailed) level of National Land Use Database classification.
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
A description of the most detailed level of National Land Use Database classification.
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
The identifier of the NGD Building feature recognised as the principal building at the Site.
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
The state of the Site 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
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
A cross reference table mapping Site to Address. 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.
Unique Property Reference Number (UPRN) of the Address features that lie within the extent of the Site geometry.
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
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
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
The type of relationship that has been formed between the source and target features, for example, Within or Same As.
Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Code List Name: relationshiptypevalue
Max Length: 15
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 2.0
1.0
04 October 2022
Ongoing
2.0
25 September 2024
Ongoing