# Comparison of OS MasterMap Greenspace Layer and OS NGD {% hint style="warning" %} The OS MasterMap Greenspace Layer product will become End of Life on 31 March 2027. As of this date, Ordnance Survey will cease to maintain or publish updates, and access to the product will be removed from the OS Data Hub, OS Features API and OS Vector Tile API. For the latest updates and information on this and other products, please refer to our [strategic product roadmap](https://www.ordnancesurvey.co.uk/products/roadmap) and [End of Life Product Notice](https://docs.os.uk/os-downloads/resources/product-resources/end-of-life-product-notices/end-of-life-notice-os-mastermap-greenspace-layer) pages. {% endhint %} ## Overview The purpose of this page is to provide a technical summary of things to consider when migrating from OS MasterMap Greenspace Layer to the corresponding four feature types (Land, Rail, Road Track Or Path, and Water) within the OS National Geographic Database (OS NGD). The information currently provided in OS MasterMap Greenspace Layer is contained within the following OS NGD collections: the OS Land Features, OS Transport Features and OS Water Features Collections. This page covers data supply and formats, as well as a comparison of the attribution of the two products. ## Key features The [OS MasterMap Greenspace Layer](https://docs.os.uk/os-downloads/products/land-and-terrain-portfolio/os-mastermap-greenspace-layer) product includes the following key attribution: * Primary Form and Secondary Form – describing land cover * Primary Function and Secondary Function – describing land use OS NGD data offers the following improvements: * Full coverage of Great Britain, as opposed to coverage being limited to urban areas only for OS MasterMap Greenspace Layer; the coverage comparison maps further down the page give a good visual representation of greenspace data coverage differences between the products. * Land cover (Primary and Secondary Form are the equivalents in OS MasterMap Greenspace Layer) is presented as a hierarchy with more than 100 values, compared to 6 values in OS MasterMap Greenspace Layer. * Land use (Primary and Secondary Function are the equivalents in OS MasterMap Greenspace Layer) is presented as a hierarchy with more than 50 values, compared to 18 values in OS MasterMap Greenspace Layer. * Alternative land cover and land use classifications are available in the OS NGD: * Land cover * European Nature Information System (EUNIS) classification scheme * UK Biodiversity Action Plan (BAP) Broad Habitats classification scheme * Land use * National Land Use Database (NLUD) * Address (BS7666) * Data in the three OS NGD collections is updated up-to-daily (updates are 6-monthly for OS MasterMap Greenspace Layer). * Every area feature in the OS NGD has a code assigned that indicates the local authority it lies within – Government Statistical Service (GSS) codes – allowing summaries of land use and land cover. * Richer change metadata at attribute level is available in the OS NGD to improve the analysis of change over time. * The three OS NGD collections contain a link to the [Site Feature Type](https://docs.os.uk/osngd/data-structure/land-use/land-use-features/site) in the OS Land Use Features Collection, allowing features to be grouped where they lie within a common occupied extent, such as a park or residential property. {% hint style="info" %} ### OS NGD greenspace recipe guide now available There's no like-for-like replacement download product for OS MasterMap Greenspace Layer, but you can create a recipe in OS Select+Build to download the equivalent greenspace data from the OS NGD. The [greenspace recipe guide](https://docs.os.uk/osngd/getting-started/downloading-with-os-select+build/getting-started-with-os-recommended-recipes/greenspace-recipe-guide) is available on the OS NGD documentation site; it provides detailed step-by-step instructions outlining how you can combine and filter the four OS NGD feature types to create a greenspace recipe. You can adapt the suggested greenspace recipe at the recipe creation or editing stage so that it fully meets your needs. {% endhint %} ## Feature types OS MasterMap Greenspace Layer has one feature type: * Greenspace Area In the OS NGD, there are four corresponding feature types: * [Land](https://docs.os.uk/osngd/data-structure/land/land-features/land) (in the OS Land Features Collection) * [Rail](https://docs.os.uk/osngd/data-structure/transport/transport-features/rail) (in the OS Transport Features Collection) * [Road Track Or Path](https://docs.os.uk/osngd/data-structure/transport/transport-features/road-track-or-path) (in the OS Transport Features Collection) * [Water](https://docs.os.uk/osngd/data-structure/water/water-features/water) (in the OS Water Features Collection) ## Comparison maps ### Coverage comparison maps Below are two maps showing the greenspace coverage for Great Britain provided by OS MasterMap Greenspace Layer and by OS NGD data using the [greenspace recipe](https://docs.os.uk/osngd/getting-started/downloading-with-os-select+build/getting-started-with-os-recommended-recipes/greenspace-recipe-guide):
Maps comparing the greenspace coverage of Great Britain provided by OS MasterMap Greenspace Layer vs. OS NGD data. The map for OS MasterMap Greenspace Layer shows that there is only greenspace coverage provided in urban areas, whereas the map for OS NGD data shows full Great Britain coverage for green spaces.

Maps comparing the greenspace coverage of Great Britain provided by OS MasterMap Greenspace Layer vs. OS NGD data.

### Attribution comparison maps Below is a pair of interactive maps over Exeter showing the similarities between the OS MasterMap Greenspace Layer (top) and the OS NGD feature types (bottom); clicking on a feature in either map will open a pop-up displaying the shared attributes: {% embed url="" %} ## Currency OS MasterMap Greenspace Layer has an update frequency of six monthly (April and October), whereas the OS NGD has an update frequency of up-to-daily for the three collections. ## Data supply ### File formats OS MasterMap Greenspace Layer is available in: * ESRI Shapefile * GML * GeoPackage * Vector tiles It is also currently supplied in the [OS Features API](https://docs.os.uk/os-apis/accessing-os-apis/os-features-api) and the [OS Vector Tile API](https://docs.os.uk/os-apis/accessing-os-apis/os-vector-tile-api) (although access to the product will be removed from both APIs in March 2027). The OS Land Features, OS Transport Features and OS Water Features Collections of the OS NGD are available in: * GeoPackage * CSV (comma-separated values) * GeoJSON * Vector tiles The download service of OS Select+Build supplies GeoPackage and CSV formats, while [OS NGD API – Features](https://docs.os.uk/osngd/getting-started/access-the-os-ngd-api/os-ngd-api-features) supplies GeoJSON, and [OS NGD API – Tiles](https://docs.os.uk/osngd/getting-started/access-the-os-ngd-api/os-ngd-api-tiles) supplies vector tiles. {% hint style="info" %} The [OS NGD Documentation site](https://docs.os.uk/osngd) contains further guidance on the differing formats and APIs available: * [OS NGD file formats and naming](https://docs.os.uk/osngd/getting-started/os-ngd-fundamentals/file-formats-and-naming) * [Getting Started with OS NGD API – Features](https://docs.os.uk/osngd/getting-started/access-the-os-ngd-api/os-ngd-api-features/getting-started) * [Getting Started with OS NGD API – Tiles](https://docs.os.uk/osngd/getting-started/access-the-os-ngd-api/os-ngd-api-tiles/getting-started) {% endhint %} ### Data ordering Through the [OS Data Hub](https://osdatahub.os.uk/), it's currently possible to order OS MasterMap Greenspace Layer for all of Great Britain or a customisable area (5km² tiles) in the following formats: * Geography Markup Language (GML) * ESRI Shapefile * GeoPackage * Vector tiles All OS NGD download data is supplied through OS Select+Build in the [OS Data Hub](https://osdatahub.os.uk/). OS Select+Build offers a much more tailored experience to ordering and downloading OS data, with an improved range of options, including: * True areas of interest are supplied, as opposed to 5km² tiles, removing need to deduplicate adjoining 'hairy' tiles. * In addition to updates being delivered as full refreshes, it is also possible to take Change-Only Updates (COUs) in CSV format for full Great Britain coverage, so you'll receive only the updated features. With OS Select+Build, it is also possible to filter your supply so you receive only the features that you require. For example, [OS Land Cover Tier A](https://docs.os.uk/osngd/code-lists/code-lists-overview/landcovertieravalue) and [OS Land Use Tier A](https://docs.os.uk/osngd/code-lists/code-lists-overview/landusetieravalue). {% hint style="info" %} The [OS NGD Documentation site](https://docs.os.uk/osngd) contains guidance on downloading with OS Select+Build and using and loading OS NGD data in both CSV and GeoPackage formats: * The [greenspace recipe guide](https://docs.os.uk/osngd/getting-started/downloading-with-os-select+build/getting-started-with-os-recommended-recipes/greenspace-recipe-guide) provides detailed step-by-step instructions outlining how you can combine and filter the four OS NGD feature types to create a greenspace recipe in OS Select+Build. * [Downloading with OS Select+Build](https://docs.os.uk/osngd/getting-started/downloading-with-os-select+build) * [Getting Started with CSV](https://docs.os.uk/osngd/getting-started/downloading-with-os-select+build/getting-started-with-csv) * [Getting Started with GeoPackage](https://docs.os.uk/osngd/getting-started/downloading-with-os-select+build/getting-started-with-geopackage) {% endhint %} ## Unique identifiers In OS MasterMap Greenspace Layer, persistent managed identifiers are supplied called TOIDs (Topographic Identifiers). TOIDs are strings of up to 20 characters, starting with 'osgb'; the remaining characters are digits (0 to 9). As OS MasterMap Greenspace Layer contains a subset of features from [OS MasterMap Topography Layer](https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-mastermap-topography-layer), the TOIDs provided in OS MasterMap Greenspace Layer are the same identifiers as for the corresponding features in OS MasterMap Topography Layer. The OS NGD uses a new identifier called the OSID (OS Identifier) to uniquely identify features. The OSID is a Globally Unique Identifier (GUID) and requires no centralised authority to ensure uniqueness. The Land, Rail, Road Track Or Path, and Water Feature Types in the OS NGD contain a TOID attribute, which allows linking back to OS MasterMap Greenspace Layer. ## Attribution comparison OS NGD data contains richer information on land use and land cover, and is structured to be simple to navigate and query. The attribution comparison maps further up the page show the similarities between OS MasterMap Greenspace Layer data and the four OS NGD feature types, and the extra attribution available through the latter. The table below compares the attribution available for the two products:
OS MasterMap Greenspace Layer AttributePurposeOS NGD AttributePurpose
toidThe unique reference number of the feature in OS MasterMap Topography Layer.toidThe TOID is provided in the OS NGD to enable migration. The OSID is the primary identifier for the OS NGD.
versionThe version number of the feature in OS MasterMap Topography Layer. This identifies the specific version of Topography Layer feature this dataset was created from.versiondate, versionavailablefromdate, versionavailabletodateDate on which the version was last updated; the date on which this version of the feature became the latest version; the date on which this version of the feature was superseded by an update or ceased to exist.
primaryFunctionThe main function of the greenspace area.oslandusetiera, oslandusetierbClassifications of land use provided at a high level (Tier A) and in more detail (Tier B).
secondaryFunctionWhere a polygon has more than one greenspace function present, this field will be populated with the second function.oslandusetiera, oslandusetierbClassifications of land use provided at a high level (Tier A) and in more detail (Tier B).
primaryFormThe main form of the greenspace area.oslandcovertiera, oslandcovertierbClassifications of land cover provided at a high level (Tier A) and in more detail (Tier B).
secondaryFormWhere a polygon has more than one greenspace form present, this field will be populated with the second form.oslandcovertiera, oslandcovertierbClassifications of land cover provided at a high level (Tier A) and in more detail (Tier B).
All the OS MasterMap Greenspace Layer attributes above use the names from the GML format; please see the [Attribute mapping](https://docs.os.uk/os-downloads/products/land-and-terrain-portfolio/os-mastermap-greenspace-layer/os-mastermap-greenspace-layer-technical-specification/attribute-mapping#id-8.1-greenspace-area) page for the ESRI Shapefile, GeoPackage and vector tiles equivalents. ### Additional attribution available for OS NGD data The OS NGD also provides additional information beneficial to greenspace use cases:
OS NGD InformationAttributePurpose
DescriptiondescriptionA single descriptive value intended for a quick understanding of what the feature represents.
Change metadatafirstdigitalcapturedate, changetype, geometry_evidencedate, geometry_updatedate, geometry_source, geometry_capturemethodInformation explaining data changes.
Link to Sitessmallestsite_siteid, smallestsite_landusetiera, smallestsite_landusetierb, largestsite_landusetiera, largestsite_landusetierbReferences to OS NGD Land Use Theme data for more land use information.
NLUD classificationnlud_code, nlud_orderdescription, nlud_groupdescriptionAn alternative land use classification that uses a code defined in the NLUD schema.
Address classification

address_classificationcode, address_primarydescription,

address_secondarydescription

An alternative land use classification that uses a code defined in the Address / BS7666 schema.
GSS codelowertierlocalauthority_gsscode, lowertierlocalauthority_countThe unique identifier of the Lower Tier Local Authority administrative area provided by the Office for National Statistics that the feature lies within.
Habitat informationscheme, habitatcode, habitatdescription, percentageHabitat classifications for natural topographic features mapped to the EUNIS and UK BAP classification schemes.
## Help and support ### Supporting links The [OS NGD Documentation](https://docs.os.uk/osngd) site has further information that you may find useful. Some particularly relevant sections that may aid you with migration are: * [Greenspace recipe guide](https://docs.os.uk/osngd/getting-started/downloading-with-os-select+build/getting-started-with-os-recommended-recipes/greenspace-recipe-guide) * [OS NGD Fundamentals](https://docs.os.uk/osngd/getting-started/os-ngd-fundamentals) * [OS Land Features Collection](https://docs.os.uk/osngd/data-structure/land/land-features) * [OS Transport Features Collection](https://docs.os.uk/osngd/data-structure/transport/transport-features) * [OS Water Features Collection](https://docs.os.uk/osngd/data-structure/water/water-features) ### Contact us If you have any questions, need assistance, or want to provide feedback, please don't hesitate to reach out to us at [os.uk/contact-us](https://os.uk/contact-us). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.os.uk/more-than-maps/os-ngd-migration/comparison-of-os-mastermap-greenspace-layer-and-os-ngd.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.