LogoLogo
OS Docs HomeOS NGDOS APIs OS Download ProductsMore than MapsOS Data Hub
  • OS NGD Documentation
  • INTRODUCTION TO OS NGD
    • Introduction to OS NGD
    • OS NGD Explained
    • OS NGD Key Benefits to Customers
    • OS NGD Sample Data
    • OS NGD Product Viewer Tool
  • GETTING STARTED
    • Getting Started Information
    • OS NGD Fundamentals
      • Terminology and access
      • File formats and naming
      • Data ordering and currency
      • COU supplies
      • Data schema versioning
      • Unique identifiers
      • Coordinate reference systems
      • Attribute information for feature types
    • Downloading with OS Select+Build
      • Getting Started with GeoPackage
        • ArcGIS Pro
        • ArcMap
        • Cadcorp SIS
        • MapInfo Professional
        • QGIS
        • FME
        • GDAL
      • Getting Started with CSV
        • Loading CSV files
        • Processing COUs
      • Getting Started with Attribute Filtering
      • Getting Started with Temporal Filtering
    • Accessing OS NGD APIs
      • Getting started with an API project
      • OS NGD API – Features
        • What data is available?
        • Technical Specification
          • Landing page
          • Conformance
          • Collections
          • Collection
          • Schema
          • Queryables
          • Features
          • Feature
        • Getting Started
          • GIS Software
            • Cadcorp SIS
            • ESRI ArcGIS Online
            • ESRI ArcGIS Pro
            • QGIS
          • Libraries
            • Leaflet
            • MapLibre GL JS
            • OpenLayers
            • Python (Geopandas)
        • Code Examples
      • OS NGD API – Tiles
        • What data is available?
        • Zoom Levels
        • Technical Specification
          • Landing page
          • Conformance
          • Collections
          • Collection
          • Tile Matrix Sets
          • Tiles
          • Styles
        • Getting Started
          • GIS Software
            • Cadcorp SIS
            • QGIS
          • Libraries
            • Leaflet
            • MapLibre GL JS
            • OpenLayers
        • Code Examples
    • Styling OS NGD Data
    • OS NGD Webinars, Tutorials and Case Studies
    • FAQs
  • OS NGD NEWS
    • OS NGD News
    • What's New?
    • Change Log
    • OS NGD Improvements
    • Future OS NGD Data Enhancements
  • Data and Service Status
    • Data and Service Status Information
  • 🆕Live Service Disruption and Planned Maintenance
  • Current Known Data Issues
  • 🆕Resolved Data Issues
  • DATA STRUCTURE
    • Data Structure Information
    • OS NGD Address
      • GB Address
        • Built Address
        • Historic Address
        • Non-Addressable Object
        • Pre-Build Address
        • Street Address
      • Islands Address
        • Built Address
        • Historic Address
        • Non-Addressable Object
        • Pre-Build Address
        • Street Address
      • Related Components
        • Alternate Address
        • Postal Address
        • Other Classification
        • Related Entity
      • Versioning information
      • GB Address Local Custodian Codes
      • Islands Address Local Custodian Codes
    • OS NGD Administrative and Statistical Units
      • Boundaries
        • Boundary High Water Mark
        • Ceremonial County
        • Country
        • Devolved Parliament Constituency
        • Devolved Parliament Electoral Region
        • Electoral Division
        • GLA Assembly Constituency
        • Historic County
        • Historic European Region
        • Lower Tier Local Authority
        • Parish Or Community
        • Polling District
        • Region
        • Regional Authority
        • Upper Tier Local Authority
        • Ward
        • Westminster Constituency
    • OS NGD Buildings
      • Building Features
        • Building
        • 🆕Building Access Location
        • Building Line
        • Building Part
    • OS NGD Geographical Names
      • Named Features
        • 🆕Crowd Sourced Name Point
        • Named Area
        • Named Point
        • Named Road Junction
    • OS NGD Land
      • Land Features
        • Land
        • Land Point
        • Landform
        • Landform Line
        • Landform Point
    • OS NGD Land Use
      • Land Use Features
        • Site
        • Site Access Location
        • ❌Site Routing Point
    • OS NGD Structures
      • Structure Features
        • Compound Structure
        • Field Boundary
        • Structure
        • Structure Line
        • Structure Point
    • OS NGD Transport
      • Routing and Asset Management Information (RAMI)
        • Average And Indicative Speed
        • Highway Dedication
        • Maintenance Area
        • Maintenance Line
        • Maintenance Point
        • Reinstatement Area
        • Reinstatement Line
        • Reinstatement Point
        • Restriction
        • Routing Hazard
        • Routing Structure
        • Special Designation Area
        • Special Designation Line
        • Special Designation Point
      • Transport Features
        • Cartographic Rail Detail
        • Rail
        • Road Line
        • Road Track Or Path
        • 🆕Street Light
      • Transport Network
        • Connecting Link
        • Connecting Node
        • Ferry Link
        • Ferry Node
        • Ferry Terminal
        • Path
        • Path Link
        • Path Node
        • Pavement Link
        • Railway Link
        • Railway Link Set
        • Railway Node
        • Road
        • Road Junction
        • Road Link
        • Road Node
        • Street
        • Tram On Road
    • OS NGD Water
      • Water Features
        • Inter Tidal Line
        • River Basin District Catchment
        • Tidal Boundary
        • Water
        • Water Point
        • Waterbody Catchment
      • Water Network
        • Water Link
        • Water Link Set
        • Water Node
  • Code Lists
    • Code Lists Overview
      • accesstypevalue
      • 🆕accesslevelvalue
      • 🆕accessmodevalue
      • 🆕accessobstructionvalue
      • 🆕accesspurposevalue
      • addressbasepostalvalue
      • addressclassificationsourcevalue
      • addressdescriptionvalue
      • addressstatusvalue
      • addressstreettypevalue
      • associatedstreetdatadescriptionvalue
      • averageandindicativespeeddescriptionvalue
      • basementpresencesourcevalue
      • boundaryhighwatermarkdescriptionvalue
      • boundarytypevalue
      • 🆕buildingaccesslocationdescriptionvalue
      • buildingageperiodvalue
      • buildingagesourcevalue
      • buildingconnectivitytypevalue
      • buildingdescriptionvalue
      • buildinglinedescriptionvalue
      • buildingpartdescriptionvalue
      • buildingpartoslandcovertieravalue
      • buildingpartoslandcovertierbvalue
      • buildingusevalue
      • buildstatusvalue
      • builtstructureheightconfidencevalue
      • capturemethodvalue
      • capturespecificationvalue
      • ceremonialcountydescriptionvalue
      • changetypevalue
      • classificationcorrelationvalue
      • compoundstructuredescriptionvalue
      • connectinglinkdescriptionvalue
      • connectingnodedescriptionvalue
      • constructionmaterialsourcevalue
      • constructionmaterialvalue
      • countryvalue
      • countrydescriptionvalue
      • 🆕crowdsourcednamedescriptionvalue
      • 🆕crowdsourcednamematchtypevalue
      • cyclefacilityvalue
      • dataentitycatalogue
      • dedicationvalue
      • devolvedparliamentconstituencydescriptionvalue
      • devolvedparliamentelectoralregiondescriptionvalue
      • electoraldivisiondescriptionvalue
      • extentoflinkvalue
      • ferrylinkdescriptionvalue
      • ferrynodedescriptionvalue
      • ferryterminaldescriptionvalue
      • fieldboundarydescriptionvalue
      • formofroadnodevalue
      • formofwaytypevalue
      • gaugevalue
      • glaassemblyconstituencydescriptionvalue
      • gssrolevalue
      • hazardtypevalue
      • heightingmethodvalue
      • highwaydedicationnetworkfeaturetypevalue
      • historiccountydescriptionvalue
      • historiceuropeanregiondescriptionvalue
      • intertidallinedescriptionvalue
      • 🆕illuminationvalue
      • junctiontypedescriptionvalue
      • landdescriptionvalue
      • landformdescriptionvalue
      • landformlinedescriptionvalue
      • landformpointdescriptionvalue
      • landoslandcovertieravalue
      • landoslandcovertierbvalue
      • landformvalue
      • landpointdescriptionvalue
      • languagevalue
      • linkdirectionvalue
      • 🆕linkreferenceconfidencevalue
      • lowertierlocalauthoritydescriptionvalue
      • maintenancevalue
      • 🆕matchedfeaturetypengdvalue
      • 🆕matchedthemengdvalue
      • matchstatusvalue
      • classificationcorrelationvalue
      • namedareaextentdefinitionvalue
      • nameddatevalue
      • nameddayvalue
      • namedescriptiongroupvalue
      • namedescriptionvalue
      • namedperiodvalue
      • namedroadjunctiondescriptionvalue
      • namedtimevalue
      • networkfeaturetypevalue
      • 🆕networknodefeaturetypevalue
      • networkoverunderbridgevalue
      • operationalstatevalue
      • operationalstatusvalue
      • oslandusetieravalue
      • oslandusetierbvalue
      • parentboundarydescriptionvalue
      • parentfeaturetypevalue
      • parishorcommunitydescriptionvalue
      • pathdescriptionvalue
      • pathnodedescriptionvalue
      • physicallevelvalue
      • 🆕physicalstatevalue
      • physicallevelvalue
      • pollingdistrictdescriptionvalue
      • positionalaccuracyvalue
      • postcodetypevalue
      • presencevalue
      • raildescriptionvalue
      • raildetaildescriptionvalue
      • railoslandcovertieravalue
      • railoslandcovertierbvalue
      • railwaylinkdescriptionvalue
      • railwaylinksetdescriptionvalue
      • railwaynodedescriptionvalue
      • railwayusevalue
      • regionalauthoritydescriptionvalue
      • regiondescriptionvalue
      • reinstatementtypevalue
      • relationshiptypevalue
      • restrictiontypedescriptionvalue
      • restrictionvalue
      • riverbasindistrictcatchmentdescriptionvalue
      • roadclassificationvalue
      • roaddescriptionvalue
      • roadfunctionvalue
      • roadlinedescriptionvalue
      • roadnodedescriptionvalue
      • roadstructurevalue
      • roadtrackorpathdescriptionvalue
      • roadtrackorpathoslandcovertieravalue
      • roadtrackorpathoslandcovertierbvalue
      • roadwidthconfidencelevelvalue
      • 🆕roofconfidenceindicatorvalue
      • 🆕roofmaterialvalue
      • 🆕roofshapevalue
      • pavementdescriptionvalue
      • sideofroadvalue
      • siteaccesslocationdescriptionvalue
      • sitedescriptionvalue
      • siteextentdefinitionvalue
      • siteroutingpointdescriptionvalue
      • sourceofmeasurevalue
      • specialdesignationtypevalue
      • stakeholdervalue
      • statusvalue
      • streetclassificationvalue
      • streetdescriptionvalue
      • streetgeometrysourcevalue
      • 🆕streetlightdescriptionvalue
      • streetstatevalue
      • streetsurfacevalue
      • streettypevalue
      • structuredescriptionvalue
      • structureoslandcovertieravalue
      • structureoslandcovertierbvalue
      • structurelinedescriptionvalue
      • structurepointdescriptionvalue
      • structuretypevalue
      • structurevalue
      • surfacetypevalue
      • themevalue
      • tidalboundarydescriptionvalue
      • trackrepresentationvalue
      • tramdescriptionvalue
      • 🆕transportfeaturetypevalue
      • uppertierlocalauthoritydescriptionvalue
      • usrnmatchindicatorvalue
      • vehiclequalifiervalue
      • warddescriptionvalue
      • waterbodycatchmentdescriptionvalue
      • waterbodycategoryvalue
      • waterdescriptionvalue
      • wateroslandcovertieravalue
      • wateroslandcovertierbvalue
      • waterlinkdescriptionvalue
      • waterlinkflowdirectionvalue
      • waterlinkgeometrysourcevalue
      • waterlinklevelofdetailvalue
      • waterlinkpermanencevalue
      • waterlinkphysicalcontainmentvalue
      • waterlinkprimacyvalue
      • waterlinksetdescriptionvalue
      • waterlinkwatertypevalue
      • watermarkvalue
      • waternodedescriptionvalue
      • waterpointdescriptionvalue
      • watertypevalue
      • westminsterconstituencydescriptionvalue
      • yesnovalue
  • USING OS NGD DATA
    • OS NGD Buildings
      • Building Feature Type
      • How Building data is created
      • Building attribution
      • Known limitations
      • Summary
    • OS NGD Structures
      • Field Boundary
        • Field Boundary Feature Type
        • How Field Boundary data is created
        • Field Boundary attribution
        • Known limitations
        • Summary
    • OS NGD Transport
      • Pavements
        • Pavement polygons
        • Pavement attribution
        • Pavement Link feature type
      • Trams
        • Tram attribution on Road Link
        • Tram On Road Feature Type
        • Trams in the Rail Network
      • Street Light
        • Known limitations
    • OS NGD Land Cover Enhancements
      • Introduction
      • Habitat mapping
      • Percentage coverage
      • Cross reference table
      • Known limitations
      • Summary
  • EXTRA LINKS
    • Accessibility
    • Data Catalogue
    • Contact Us
    • Copyright
    • PSGA Product Summary
Powered by GitBook
On this page
  • Temporal filtering
  • Feature type attributes
  • osid
  • versiondate
  • versionavailablefromdate
  • versionavailabletodate
  • changetype
  • geometry
  • geometry_area_m2
  • geometry_updatedate
  • theme
  • description
  • description_updatedate
  • physicalstate
  • physicalstate_updatedate
  • buildingpartcount
  • isinsite
  • primarysiteid (formerly primarysite_id)
  • containingsitecount
  • mainbuildingid (formerly mainbuilding_id)
  • mainbuildingid_ismainbuilding (formerly ismainbuilding)
  • mainbuildingid_updatedate (formerly mainbuilding_updatedate)
  • buildinguse
  • buildinguse_oslandusetiera (formerly oslandusetiera)
  • buildinguse_addresscount_total (formerly addresscount_total)
  • buildinguse_addresscount_residential (formerly addresscount_residential)
  • buildinguse_addresscount_commercial (formerly addresscount_commercial)
  • buildinguse_addresscount_other (formerly addresscount_other)
  • buildinguse_updatedate
  • connectivity
  • connectivity_count (formerly connectivitycount)
  • connectivity_updatedate
  • constructionmaterial
  • constructionmaterial_evidencedate
  • constructionmaterial_updatedate
  • constructionmaterial_source
  • constructionmaterial_capturemethod
  • constructionmaterial_thirdpartyprovenance
  • buildingage_period
  • buildingage_year
  • buildingage_evidencedate
  • buildingage_updatedate
  • buildingage_source
  • buildingage_capturemethod
  • buildingage_thirdpartyprovenance
  • basementpresence
  • basementpresence_selfcontained
  • basementpresence_evidencedate
  • basementpresence_updatedate
  • basementpresence_source
  • basementpresence_capturemethod
  • basementpresence_thirdpartyprovenance
  • numberoffloors
  • numberoffloors_evidencedate
  • numberoffloors_updatedate
  • numberoffloors_source
  • numberoffloors_capturemethod
  • height_absolutemin_m
  • height_absoluteroofbase_m
  • height_absolutemax_m
  • height_relativeroofbase_m
  • height_relativemax_m
  • height_confidencelevel
  • height_evidencedate
  • height_updatedate
  • roofmaterial_primarymaterial
  • roofmaterial_solarpanelpresence
  • roofmaterial_greenroofpresence
  • roofmaterial_confidenceindicator
  • roofmaterial_evidencedate
  • roofmaterial_updatedate
  • roofmaterial_capturemethod
  • roofshapeaspect_shape
  • roofshapeaspect_areapitched_m2
  • roofshapeaspect_areaflat_m2
  • roofshapeaspect_areafacingnorth_m2
  • roofshapeaspect_areafacingnortheast_m2
  • roofshapeaspect_areafacingeast_m2
  • roofshapeaspect_areafacingsoutheast_m2
  • roofshapeaspect_areafacingsouth_m2
  • roofshapeaspect_areafacingsouthwest_m2
  • roofshapeaspect_areafacingwest_m2
  • roofshapeaspect_areafacingnorthwest_m2
  • roofshapeaspect_areaindeterminable_m2
  • roofshapeaspect_areatotal_m2
  • roofshapeaspect_confidenceindicator
  • roofshapeaspect_evidencedate
  • roofshapeaspect_updatedate
  • roofshapeaspect_capturemethod
  • Site Reference
  • siteid
  • buildingid
  • buildingversiondate
  • Building Part Reference
  • buildingpartid
  • buildingid
  • buildingversiondate
  • UPRN Reference
  • uprn
  • buildingid
  • buildingversiondate

Was this helpful?

Export as PDF
  1. DATA STRUCTURE
  2. OS NGD Buildings
  3. Building Features

Building

PreviousBuilding FeaturesNextBuilding Access Location

Last updated 1 month ago

Was this helpful?

A new building geometry which represents a single building footprint. This geometry consists of adjoining building parts which have been determined to be part of the same building. When contained in a , adjoining building parts will be represented by a single feature.

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

27 September 2023

Ongoing

2.0

27 March 2024

Ongoing

3.0

25 September 2024

Ongoing

4.0

27 March 2025

Ongoing

Any data temporally filtered earlier than the specified earliest date noted above for the data schema versions may contain data inconsistencies.

Please see 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, 3.0, 4.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, 3.0, 4.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, 3.0, 4.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, 3.0, 4.0

changetype

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

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: false

  • Max Length: 50

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 1.0, 2.0, 3.0, 4.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, 3.0, 4.0

  • Geometry Type: Polygon

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: Yes

  • Data Schema Version: 1.0, 2.0, 3.0, 4.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, 3.0, 4.0

theme

The OS NGD theme to which the feature belongs.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: false

  • Max Length: 40

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 1.0, 2.0, 3.0, 4.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

  • Max Length: 45

  • OS NGD API – Features Filterable: Yes

  • OS Select+Build Filterable: Yes

  • Data Schema Version: 2.0, 3.0, 4.0

description_updatedate

Date when the description 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: 2.0, 3.0, 4.0

The state of the building in relation to its physical condition.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: false

  • Max Length: 20

  • OS NGD API – Features Filterable: Yes

  • OS Select+Build Filterable: Yes

  • Data Schema Version: 4.0

Date when the physical state 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: 4.0

buildingpartcount

Count of building parts within the building.

  • Data Types: Integer (GeoJSON), Integer (GPKG), Integer (CSV)

  • Nullable: false

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 1.0, 2.0, 3.0, 4.0

isinsite

Flag to indicate whether the building is within a Land Use Site.

  • 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, 3.0, 4.0

primarysiteid (formerly primarysite_id)

This attribute was called primarysite_id in data schema versions 1.0 and 2.0, and was renamed primarysiteid from version 3.0 onward.

Identifier of the primary site associated with the building. The primary site is the smallest site which contains the building feature.

  • 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: 1.0, 2.0, 3.0, 4.0

containingsitecount

Count of sites that the building is contained 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: 1.0, 2.0, 3.0, 4.0

mainbuildingid (formerly mainbuilding_id)

This attribute was called mainbuilding_id in data schema versions 1.0 and 2.0, and was renamed mainbuildingid from version 3.0 onward.

Populated if the feature is not the main building. Can be used to identify the main building within the same site.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 36

  • OS NGD API – Features Filterable: Yes

  • OS Select+Build Filterable: No

  • Data Schema Version: 1.0, 2.0, 3.0, 4.0

mainbuildingid_ismainbuilding (formerly ismainbuilding)

This attribute was called ismainbuilding in data schema versions 1.0 and 2.0, and was renamed mainbuildingid_ismainbuilding from version 3.0 onward.

Flag to indicate whether the building is the primary building within the site. This has been captured by OS surveyors as the most normal building a casual visitor would report to within the Land Use Site.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 5

  • OS NGD API – Features Filterable: Yes

  • OS Select+Build Filterable: Yes

  • Data Schema Version: 3.0, 4.0

  • Data Types: Boolean (GeoJSON), Integer (GPKG), String (CSV)

  • Nullable: true

  • OS NGD API – Features Filterable: Yes

  • OS Select+Build Filterable: Yes

  • Data Schema Version: 1.0, 2.0

mainbuildingid_updatedate (formerly mainbuilding_updatedate)

This attribute was called mainbuilding_updatedate in data schema versions 1.0 and 2.0, and was renamed mainbuildingid_updatedate from version 3.0 onward.

Date when the main building was 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, 3.0, 4.0

buildinguse

Describes what the Building is used for and can have up to two values. The value will be 'Mixed Use' where more than two uses are identified.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: false

  • Max Length: 100

  • Multiplicity: [1..2]

  • OS NGD API – Features Filterable: Yes

  • OS Select+Build Filterable: Yes

  • Data Schema Version: 1.0, 2.0, 3.0, 4.0

buildinguse_oslandusetiera (formerly oslandusetiera)

This attribute was called oslandusetiera in data schema versions 1.0 and 2.0, and was renamed buildinguse_oslandusetiera from version 3.0 onward.

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: true

  • Max Length: 50

  • OS NGD API – Features Filterable: Yes

  • OS Select+Build Filterable: Yes

  • Data Schema Version: 1.0, 2.0, 3.0, 4.0

buildinguse_addresscount_total (formerly addresscount_total)

This attribute was called addresscount_total in data schema versions 1.0 and 2.0, and was renamed buildinguse_addresscount_total from version 3.0 onward.

Total count of built in-use address UPRNs associated with the building.

  • Data Types: Integer (GeoJSON), Integer (GPKG), Integer (CSV)

  • Nullable: false

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 1.0, 2.0, 3.0, 4.0

buildinguse_addresscount_residential (formerly addresscount_residential)

This attribute was called addresscount_residential in data schema versions 1.0 and 2.0, and was renamed buildinguse_addresscount_residential from version 3.0 onward.

Count of residential built in-use address UPRNs associated with the building.

  • Data Types: Integer (GeoJSON), Integer (GPKG), Integer (CSV)

  • Nullable: false

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 1.0, 2.0, 3.0, 4.0

buildinguse_addresscount_commercial (formerly addresscount_commercial)

This attribute was called addresscount_commercial in data schema versions 1.0 and 2.0, and was renamed buildinguse_addresscount_commercial from version 3.0 onward.

Count of commercial built in-use address UPRNs associated with the building.

  • Data Types: Integer (GeoJSON), Integer (GPKG), Integer (CSV)

  • Nullable: false

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 1.0, 2.0, 3.0, 4.0

buildinguse_addresscount_other (formerly addresscount_other)

This attribute was called addresscount_other in data schema versions 1.0 and 2.0, and was renamed buildinguse_addresscount_other from version 3.0 onward.

Count of other (not residential or commercial) built in-use address UPRNs associated with the building.

  • Data Types: Integer (GeoJSON), Integer (GPKG), Integer (CSV)

  • Nullable: false

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 1.0, 2.0, 3.0, 4.0

buildinguse_updatedate

Date when the building use was 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, 3.0, 4.0

connectivity

Describes how the building is connected to other buildings.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: false

  • Max Length: 15

  • OS NGD API – Features Filterable: Yes

  • OS Select+Build Filterable: Yes

  • Data Schema Version: 1.0, 2.0, 3.0, 4.0

connectivity_count (formerly connectivitycount)

This attribute was called connectivitycount in data schema versions 1.0 and 2.0, and was renamed connectivity_count from version 3.0 onward.

Count of connected buildings.

  • Data Types: Integer (GeoJSON), Integer (GPKG), Integer (CSV)

  • Nullable: false

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 1.0, 2.0, 3.0, 4.0

connectivity_updatedate

Date when the building connectivity was 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, 3.0, 4.0

constructionmaterial

The primary material from which the building is constructed. Construction material is recorded for addressable buildings. It may be recorded for some non-addressable buildings, but the majority of these will have construction material recorded as NULL.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 40

  • OS NGD API – Features Filterable: Yes

  • OS Select+Build Filterable: Yes

  • Data Schema Version: 2.0, 3.0, 4.0

constructionmaterial_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: 2.0, 3.0, 4.0

constructionmaterial_updatedate

Date when the construction material 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, 3.0, 4.0

constructionmaterial_source

Indicates the data source of the construction material.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 85

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 2.0, 3.0, 4.0

constructionmaterial_capturemethod

The capture method describes how the construction material was created, for example, via remote survey or via an automated process.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 25

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 2.0, 3.0, 4.0

constructionmaterial_thirdpartyprovenance

The provenance of the construction material provided by the third party data provider, for example, the name of an organisation and the specific dataset provided by that organisation.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 65

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 2.0, 3.0, 4.0

buildingage_period

The period (i.e. a range of years) in which the building was constructed. Construction period is recorded for addressable buildings. It may be recorded for some non-addressable buildings, but the majority of these will have construction period recorded as NULL.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 10

  • OS NGD API – Features Filterable: Yes

  • OS Select+Build Filterable: Yes

  • Data Schema Version: 2.0, 3.0, 4.0

buildingage_year

The year in which the building was constructed, for buildings constructed post-1999 and where available.

  • Data Types: Integer (GeoJSON), Integer (GPKG), Integer (CSV)

  • Nullable: true

  • OS NGD API – Features Filterable: Yes

  • OS Select+Build Filterable: Yes

  • Data Schema Version: 2.0, 3.0, 4.0

buildingage_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: 2.0, 3.0, 4.0

buildingage_updatedate

Date when the building age 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, 3.0, 4.0

buildingage_source

Indicates the data source of the building age.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 85

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 2.0, 3.0, 4.0

buildingage_capturemethod

The capture method describes how the building age was created, for example, via remote survey or via an automated process.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 25

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 2.0, 3.0, 4.0

buildingage_thirdpartyprovenance

The provenance of the building age provided by the third party data provider, for example, the name of an organisation and the specific dataset provided by that organisation.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 65

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 2.0, 3.0, 4.0

basementpresence

Indicates if a basement is present in the building. Basement presence is recorded for addressable buildings. It may be recorded for some non-addressable buildings, but the majority of these will have basement presence recorded as NULL.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 15

  • OS NGD API – Features Filterable: Yes

  • OS Select+Build Filterable: Yes

  • Data Schema Version: 2.0, 3.0, 4.0

basementpresence_selfcontained

Indicates if the basement contains a self-contained flat.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 15

  • OS NGD API – Features Filterable: Yes

  • OS Select+Build Filterable: Yes

  • Data Schema Version: 2.0, 3.0, 4.0

basementpresence_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: 2.0, 3.0, 4.0

basementpresence_updatedate

Date when the basement presence 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, 3.0, 4.0

basementpresence_source

Indicates the data source of the basement presence.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 85

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 2.0, 3.0, 4.0

basementpresence_capturemethod

The capture method describes how the basement presence was created, for example, via remote survey or via an automated process.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 25

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 2.0, 3.0, 4.0

basementpresence_thirdpartyprovenance

The provenance of the basement presence provided by the third party data provider, for example, the name of an organisation and the specific dataset provided by that organisation.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 65

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 2.0, 3.0, 4.0

numberoffloors

The maximum number of occupiable floors at or above ground level within a building.

  • Data Types: Integer (GeoJSON), Integer (GPKG), Integer (CSV)

  • Nullable: true

  • OS NGD API – Features Filterable: Yes

  • OS Select+Build Filterable: Yes

  • Data Schema Version: 3.0, 4.0

numberoffloors_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: 3.0, 4.0

numberoffloors_updatedate

Date when the number of floors 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: 3.0, 4.0

numberoffloors_source

Indicates the data source of the number of floors. For buildings with a populated number of floors value, this can be either 'Ordnance Survey' or 'Energy Performance Certificate Authority'.

  • 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: 3.0, 4.0

numberoffloors_capturemethod

The capture method describes how the number of floors was created, for example, via remote sensing survey or via an automated process.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 25

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 3.0, 4.0

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: 4.0

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: Yes

  • Data Schema Version: 4.0

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: 4.0

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: Yes

  • Data Schema Version: 4.0

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: Yes

  • Data Schema Version: 4.0

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

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 15

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 4.0

The date on which the latest evidence was gathered to make an update if required. For example, the date the imagery was captured that has been used to derive the height information.

  • Data Types: String (GeoJSON), Date (GPKG), Date (CSV)

  • Nullable: true

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 4.0

Date when the height 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: 4.0

The primary roof material present on the building.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 35

  • OS NGD API – Features Filterable: Yes

  • OS Select+Build Filterable: Yes

  • Data Schema Version: 4.0

Indicates if solar panels are present on the roof of the building.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 15

  • OS NGD API – Features Filterable: Yes

  • OS Select+Build Filterable: Yes

  • Data Schema Version: 4.0

Indicates if the roof of the building is at least partially covered with vegetation. This is usually specifically installed on a growing medium with a waterproof membrane, for environmental reasons.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 15

  • OS NGD API – Features Filterable: Yes

  • OS Select+Build Filterable: Yes

  • Data Schema Version: 4.0

An indication of whether the roof material output was expected, or if not, the reason why the quality may be lower.

  • 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: 4.0

The date on which the latest evidence was gathered to make an update if required. For example, the date the imagery was captured that has been used to derive the roof material information.

  • Data Types: String (GeoJSON), Date (GPKG), Date (CSV)

  • Nullable: true

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 4.0

Date when the roof material 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: 4.0

The capture method describes how the roof material attributes were created, for example, via remote sensing survey or via an automated process.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 25

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 4.0

An indication of the general shape characteristic of the roof of the building.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 10

  • OS NGD API – Features Filterable: Yes

  • OS Select+Build Filterable: Yes

  • Data Schema Version: 4.0

The sum of all roof face areas that have a pitch value of > 15°. Note that this measured area value is geometric (3D) rather than the planimetric (2D) measured area represented by geometry_area_m2.

  • Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)

  • Nullable: true

  • Precision: 7

  • Scale: 1

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 4.0

The sum of all roof face areas that have a pitch value of <= 15°. Note that this measured area value is geometric (3D) rather than the planimetric (2D) measured area represented by geometry_area_m2.

  • Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)

  • Nullable: true

  • Precision: 7

  • Scale: 1

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 4.0

The sum of all roof face areas with an aspect >= 337.5° and < 360° or >= 0 and < 22.5°. Note that this measured area value is geometric (3D) rather than the planimetric (2D) measured area represented by geometry_area_m2.

  • Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)

  • Nullable: true

  • Precision: 7

  • Scale: 1

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 4.0

The sum of all roof face areas with an aspect >= 22.5° and < 67.5°. Note that this measured area value is geometric (3D) rather than the planimetric (2D) measured area represented by geometry_area_m2.

  • Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)

  • Nullable: true

  • Precision: 7

  • Scale: 1

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 4.0

The sum of all roof face areas with an aspect >= 67.5° and < 112.5°. Note that this measured area value is geometric (3D) rather than the planimetric (2D) measured area represented by geometry_area_m2.

  • Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)

  • Nullable: true

  • Precision: 7

  • Scale: 1

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 4.0

The sum of all roof face areas with an aspect >= 112.5° and < 157.5°. Note that this measured area value is geometric (3D) rather than the planimetric (2D) measured area represented by geometry_area_m2.

  • Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)

  • Nullable: true

  • Precision: 7

  • Scale: 1

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 4.0

The sum of all roof face areas with an aspect >= 157.5° and < 202.5°. Note that this measured area value is geometric (3D) rather than the planimetric (2D) measured area represented by geometry_area_m2.

  • Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)

  • Nullable: true

  • Precision: 7

  • Scale: 1

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 4.0

The sum of all roof face areas with an aspect >= 202.5° and < 247.5°. Note that this measured area value is geometric (3D) rather than the planimetric (2D) measured area represented by geometry_area_m2.

  • Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)

  • Nullable: true

  • Precision: 7

  • Scale: 1

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 4.0

The sum of all roof face areas with an aspect >= 247.5° and < 292.5°. Note that this measured area value is geometric (3D) rather than the planimetric (2D) measured area represented by geometry_area_m2.

  • Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)

  • Nullable: true

  • Precision: 7

  • Scale: 1

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 4.0

The sum of all roof face areas with an aspect >= 292.5° and < 337.5°. Note that this measured area value is geometric (3D) rather than the planimetric (2D) measured area represented by geometry_area_m2.

  • Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)

  • Nullable: true

  • Precision: 7

  • Scale: 1

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 4.0

The sum of all roof face areas that have an indeterminable aspect. For example, areas obscured by vegetation or shadow, such as in an urban 'canyon'. Note that this measured area value is planimetric (2D) rather than geometric (3D), and is different to the other roofshapeaspect_area values.

  • Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)

  • Nullable: true

  • Precision: 7

  • Scale: 1

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 4.0

The sum of all roof face areas, excluding those with indeterminable aspects. Note that this measure area value is a combination of geometric (3D) and planimetric (2D) area values because it is comprised of all known and unknown areas. Where the roofshapeaspect_areaindeterminable_m2 value is equal to 0, this value will be entirely a geometric (3D) area value.

  • Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)

  • Nullable: true

  • Precision: 7

  • Scale: 1

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 4.0

An indication of whether the roof shape and aspect output was expected, or if not, the reason why the quality may be lower.

  • 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: 4.0

The date on which the latest evidence was gathered to make an update if required. For example, the date the imagery was captured that has been used to derive the roof shape aspect information.

  • Data Types: String (GeoJSON), Date (GPKG), Date (CSV)

  • Nullable: true

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 4.0

Date when the roof shape aspect 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: 4.0

The capture method describes how the roof shape and aspect attributes were created, for example, via remote sensing survey or via an automated process.

  • Data Types: String (GeoJSON), String (GPKG), String (CSV)

  • Nullable: true

  • Max Length: 25

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 4.0


Site Reference

A cross reference table mapping Building 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 of the site the Building is within.

  • 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: 1.0, 2.0, 3.0, 4.0

buildingid

The identifier of the Building.

  • 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: 1.0, 2.0, 3.0, 4.0

buildingversiondate

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: 1.0, 2.0, 3.0, 4.0


Building Part Reference

A cross reference table mapping Building to Building Part. 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.

buildingpartid

The identifier of the Building Part the Building is created from.

  • 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: 1.0, 2.0, 3.0, 4.0

buildingid

The identifier of the Building.

  • 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: 1.0, 2.0, 3.0, 4.0

buildingversiondate

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: 1.0, 2.0, 3.0, 4.0


UPRN Reference

A cross reference table mapping Address to Building. 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.

uprn

The identifier of the addressable feature that is located within the Building.

  • Data Types: Number (GeoJSON), Integer (GPKG), Integer (CSV)

  • Nullable: false

  • OS NGD API – Features Filterable: No

  • OS Select+Build Filterable: No

  • Data Schema Version: 1.0, 2.0, 3.0, 4.0

buildingid

The identifier of the Building.

  • 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: 1.0, 2.0, 3.0, 4.0

buildingversiondate

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: 1.0, 2.0, 3.0, 4.0

Code List Name:

Code List Name:

Code List Name:

physicalstate

Code List Name:

physicalstate_updatedate

Code List Name:

Code List Name:

Code List Name:

Code List Name:

Code List Name:

Code List Name:

Code List Name:

Code List Name:

Code List Name:

Code List Name:

Code List Name:

Code List Name:

Code List Name:

Code List Name:

Code List Name:

height_absolutemin_m

height_absoluteroofbase_m

height_absolutemax_m

height_relativeroofbase_m

height_relativemax_m

height_confidencelevel

Code List Name:

height_evidencedate

height_updatedate

roofmaterial_primarymaterial

Code List Name:

roofmaterial_solarpanelpresence

Code List Name:

roofmaterial_greenroofpresence

Code List Name:

roofmaterial_confidenceindicator

Code List Name:

roofmaterial_evidencedate

roofmaterial_updatedate

roofmaterial_capturemethod

Code List Name:

roofshapeaspect_shape

Code List Name:

roofshapeaspect_areapitched_m2

roofshapeaspect_areaflat_m2

roofshapeaspect_areafacingnorth_m2

roofshapeaspect_areafacingnortheast_m2

roofshapeaspect_areafacingeast_m2

roofshapeaspect_areafacingsoutheast_m2

roofshapeaspect_areafacingsouth_m2

roofshapeaspect_areafacingsouthwest_m2

roofshapeaspect_areafacingwest_m2

roofshapeaspect_areafacingnorthwest_m2

roofshapeaspect_areaindeterminable_m2

roofshapeaspect_areatotal_m2

roofshapeaspect_confidenceindicator

Code List Name:

roofshapeaspect_evidencedate

roofshapeaspect_updatedate

roofshapeaspect_capturemethod

Code List Name:

🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
🆕
changetypevalue
themevalue
buildingdescriptionvalue
physicalstatevalue
yesnovalue
buildingusevalue
landusetieravalue
buildingconnectivitytypevalue
constructionmaterialvalue
constructionmaterialsourcevalue
capturemethodvalue
buildingageperiodvalue
buildingagesourcevalue
capturemethodvalue
presencevalue
presencevalue
basementpresencesourcevalue
capturemethodvalue
capturemethodvalue
builtstructureheightconfidencevalue
roofmaterialvalue
presencevalue
presencevalue
roofconfidenceindicatorvalue
capturemethodvalue
roofshapevalue
roofconfidenceindicatorvalue
capturemethodvalue
Land Use Site
Data schema versioning

Loading OS NGD CSV files into databases

Comma-separated values (CSV) file format is universally supported for easy ingestion into all major database products. Before loading OS NGD data contained in CSV files into a database, it is necessary to create relevant tables. Data definition language (DDL) statements for PostgreSQL, SQL Server and Oracle can be accessed in our .

For instructions on loading CSV files, see the guide.

OS NGD Resources GitHub repository
Getting Started with CSV