Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
This technical specification provides detailed technical information about OS MasterMap Greenspace Layer. It is targeted at technical users and software developers.
OS MasterMap Greenspace Layer gives a comprehensive view of the greenspaces within an urban area. The dataset consists of topographic areas published in OS MasterMap Topography Layer, with additional greenspace-specific attribution to describe their function. It includes both publicly accessible and private greenspaces. This product has been designed for Public Sector Geospatial Agreement (PSGA) customers.
The OS MasterMap Greenspace Layer technical specification contains the following sections:
Polygon defining the area of the feature
The unique reference number of the feature in OS MasterMap Topography Layer. Combined with the version number, this enables joins with the Topography Layer dataset.
Attribute Name: Toid (GML), Toid (ESRI Shapefile), toid (GeoPackage), Toid (Vector tiles)
Type: CharacterString
Length: 20
Multiplicity: [1]
The version number of the feature in OS MasterMap Topography Layer. This identifies the specific version of Topography Layer feature this dataset was created from. Combined with the TOID, this enables joins with the Topography Layer dataset.
Attribute Name: Version (GML), Version (ESRI Shapefile), version (GeoPackage), N/A (Vector tiles)
Type: Integer
Length: 3
Multiplicity: [1]
The main function of the greenspace area.
Attribute Name: primaryFunction (GML), priFunc (ESRI Shapefile), primary_function (GeoPackage), primary_function (Vector tiles)
Type: Function
Length: 40
Multiplicity: [1]
The secondary function of the greenspace area, if applicable.
Attribute Name: secondaryFunction (GML), secFunc (ESRI Shapefile), secondary_function (GeoPackage), N/A (Vector tiles)
Type: Function
Length: 40
Multiplicity: [0..1]
Type of land cover present.
Attribute Name: primaryForm (GML), priForm (ESRI Shapefile), primary_form (GeoPackage), N/A (Vector tiles)
Type: Form
Length: 20
Multiplicity: [0..1]
Secondary type of land cover present, if applicable.
Attribute Name: secondaryForm (GML), secForm (ESRI Shapefile), secondary_form (GeoPackage), N/A (Vector tiles)
Type: Form
Length: 20
Multiplicity: [0..1]
The geometry of the greenspace area.
Attribute Name: geometry
Type: GM_Surface
Multiplicity: [1]
Where more than one Form value applies for a single topographic area polygon, the population of Primary Form and Secondary Form attributes is driven by a hierarchy. This hierarchy is applied to the data to determine which form is primary and secondary in cases where more than one form applies for a single topographic area polygon. Not all polygons will have a form and this hierarchy only applies where more than one form exists.
The hierarchy has been developed to ensure the process applies the appropriate forms consistently and does not imply any level of priority.
The following table declares this hierarchy:
| Hierarchy | Form |
|---|---|
*Due to the way beach and foreshore polygons are located, areas with this form would not be expected to have a secondary form.
OS has published two related products on greenspaces, OS Open Greenspace and . For some applications, it is intended that these products are used together as they contain different information.
OS Open Greenspace is part of Ordnance Survey’s Open Data portfolio and depicts the location and extent of exercise and recreation facilities likely to be open to the public. It includes access points locating entrances and exits from greenspace sites and proper names. Full information regarding OS Open Greenspace can be found in the .
A lookup table exists to link between the two products. Where an OS Open Greenspace polygon and an OS MasterMap Greenspace Layer polygon exist in the same location, the lookup table provides this information. This can be used to join the two products together, where appropriate, if the user wishes to use both datasets. OS MasterMap Greenspace Layer and OS Open Greenspace will be maintained and released with the same currency to ensure that these datasets are synchronised, allowing them to be easily used together.
Records will only be included in the lookup file where an appropriate match between an OS MasterMap Greenspace Layer TOID and OS Open Greenspace ID can be made.
The lookup table is provided as a comma-separated value (.csv) file. The file will be supplied with headers and the information contained is detailed in the attributes above. It will only be supplied to customers taking full Great Britain (GB) supply of OS MasterMap Greenspace Layer. If you are taking AOI supply and would like access to the lookup table, please contact the customer service centre () to request this. Please note that as the Lookup Table is only generated for full GB supply, there will be additional records within the table that won't match-up with an AOI data supply – these additional records exist outside your AOI and should be ignored.
The OS MasterMap Greenspace Layer TOID.
The OS Open Greenspace ID for a polygon which intersects with the relevant TOID.
1
Open Semi-Natural
2
Inland Water
3
Woodland
4
Beach Or Foreshore*
5
Manmade Surface
6
Multi-Surface
OS MasterMap Greenspace Layer is comprised of a subset of the TopographicArea polygons from OS MasterMap Topography Layer (which represent topographic objects that have a polygon-based geometry). Only polygons which have been classified as a type of greenspace will be supplied. This subset of polygons will have the Topographic Identifier (TOID) and version number from OS MasterMap Topography Layer (to enable the datasets to be used in conjunction) plus additional attributes providing the greenspace-specific information.
The attribute information for the Greenspace Area feature is included below.
Value defining the land cover of the greenspace feature.
| Code | Description |
|---|---|
* While most polygons with this form will have a primary function of Private Gardens, this will not always be the case due to the Function Hierarchy.
Woodland
Areas of land covered with trees with an area size larger than 0.1hectares and width greater than 5m.
Open Semi-Natural
Areas of undeveloped or previously developed land with natural habitats (except woodland) for example, scrub, heath and rough grassland.
Inland Water
Static water bodies (for example, reservoirs, lakes and ponds) and rivers above the normal tidal limit.
Beach Or Foreshore
Areas of beach above the tidal minimum low tide (for example, sand and shingle).
Manmade Surface
Manmade areas within sites used for exercise and recreation (for example, paths and car parks within a public park).
Multi-Surface
Polygons which may be comprised of multiple surface types, such as grass, decking and hard standing making up a private garden polygon. This applies to Private Gardens* and is generated from the Topography Layer Descriptive Term of Multi-Surface for the corresponding polygon.
Allotments Or Community Growing Spaces
Areas of land for growing fruit, vegetables, and other plants, either in individual allotments or as a community activity. Produce is for the growers’ own consumption and not primarily for commercial activity.
Amenity – Residential or Business
Landscaped areas providing visual amenity or separating different buildings or land uses for environmental, visual or safety reasons. Where the area is better described by another category this will be used in preference (for example, playing field, public park, play space).
Amenity – Transport
Landscaped areas providing visual amenity or separating different buildings or land uses for environmental, visual or safety reasons when related to a transport function, such as a road, or within a transport hub.
Land Use Changing
Areas of land that are currently under development or awaiting redevelopment.
Bowling Green
A specially prepared area intended for playing bowls.
Camping Or Caravan Park
An organised area of ground designated for tents or caravans, intended for temporary occupation by holidaymakers.
Cemetery
Areas of land associated with burial areas or crematoriums.
Golf Course
A specially prepared area intended for playing golf
Institutional Grounds
Areas of land normally enclosed and associated with institutions. Grounds may be reserved for private use or have restricted access.
Includes: Universities, Hospitals, Nursing homes, Emergency Services, Prisons, Military Sites, Government and Community Buildings providing public services, Libraries, Museums, Zoos and Theatres.
Natural
Land use areas with no other greenspace function but with Form attribute of woodland, open semi-natural, open water, beach or foreshore.
Other Sports Facility
Land used for other sports not specifically described by other categories. Includes facilities for sports spectating (for example, stadiums) as well as participation.
Religious Grounds
Areas of land associated with churches and other places of worship.
Play Space
A specially prepared area intended for children’s play, usually linked to housing areas or parks and containing purpose-built equipment. Not captured if within schools or paid-for tourist attractions.
Playing Field
Large, flat areas of grass or specially designed surfaces, generally with marked pitches, used primarily for outdoor sports (i.e. football, rugby, cricket).
Private Garden
Areas of land normally enclosed and associated with private residences and reserved for private use.
Public Park or Garden
Areas of land designed, constructed, managed and maintained as a public park or garden. These normally have a defined perimeter and free public access, and generally sit within or close to urban areas.
Access is granted for a wide range of uses and not usually restricted to paths or tracks within the area. May include areas with managed facilities such as benches and flowerbeds, and more natural areas.
School Grounds
Areas of land normally enclosed that is associated with a school and primarily reserved for their use.
Tennis Court
A specially prepared area intended for playing tennis.
A code list or enumeration is a controlled set of values which can be used to populate a specific column.
OS MasterMap Greenspace Layer consists of the following general classifications:
Public parks or gardens
Private gardens or grounds
Amenity greenspace
Play spaces
Sports areas and playing fields
Natural or semi-natural greenspaces
Allotments or community growing spaces
Churchyards or burial grounds
Camping or caravan sites
Areas undergoing land use change
A full list of the definitions of these classifications is included in the Code lists below.
OS MasterMap Greenspace Layer is constructed as per the following UML diagram:
ESRI Shapefile is a simple, non-topological format for storing the geometric location and attribute information of geographic features. A Shapefile is one of the spatial data formats that can be utilised in ArcGIS.
The Shapefile format defines the geometry and attributes of geographically referenced features in as many as six files with specific file extensions that should be stored in the same project workspace.
They are:
.shp – the file that stores the feature geometry.
.shx – the file that stores the index of the feature geometry.
.dbf – the dBASE file that stores the attribute information of features.
.prj – the projection file that provides the information on the coordinate reference system.*
.sbn and .sbx – the files that store the spatial index of the features.**
*When a Shapefile is added as a theme to a view, this file is displayed as a feature table.
**These two files will only exist if you perform theme on theme selection, spatial joins, or create an index on a theme's SHAPE field.
The shapefile has two attributes (FID and SHAPE) that are virtual columns created by ArcGIS when accessing the table contents but are not visible in the attribute table. The FID column uniquely identifies each object stored in the table. The SHAPE column provides information about the feature geometry.
The naming of attributes will be different between the various formats due to the differing naming conventions associated with each format (for example, the presence of underscores, character limitations and capitalisation). Therefore, the following table maps the differing format attribute names to one another.
| GML | ESRI Shapefile | GeoPackage | Vector tiles |
|---|---|---|---|
Some attributes are not mapped to all formats; the absence of an attribute field is represented by ‘N/A’ in the preceding table.
OS MasterMap Greenspace Layer is supplied as a single GeoPackage for the whole of Great Britain. GeoPackage (*.gpkg) is an open, non-proprietary, platform-independent, standards-based data format for geographic information systems (GIS), as defined by the Open Geospatial Consortium (OGC). It is designed to be a lightweight format that can contain large amounts of varied and complex data in a single, easy to distribute and ready to use file. GeoPackage is natively supported by numerous software applications.
The population of Primary Function and Secondary Function attributes is driven by a hierarchy. This hierarchy is applied to the data to determine which function is primary and secondary in cases where more than one function applies for a single topographic area polygon. Not every polygon will have more than one function due to the nature of the primary function, for example, cemeteries and bowling greens are not likely to have secondary functions. This hierarchy only applies where more than one function exists.
The hierarchy has been developed to ensure the process applies the appropriate functions and does not imply any level of priority.
The following table declares this hierarchy:
| Hierarchy | Function |
|---|---|
*Due to the way Amenity – Residential or Business function is defined (see Code lists), features classified as this primary function would not be expected to have a secondary function.
GreenspaceArea
GreenspaceArea
greenspace_area
greenspace_area
N/A
FID
fid
N/A
Toid
toid
toid
Toid
Version
version
version
N/A
primaryFunction
priFunc
primary_function
primary_function
secondaryFunction
secFunc
secondary_function
N/A
primaryForm
priForm
primary_form
N/A
secondaryForm
secForm
secondary_form
N/A
MultiPolygon
polygon
MultiPolygon
polygon
1
Public Park Or Garden
2
School Grounds
3
Institutional Grounds
4
Golf Course
5
Amenity – Residential Or Business*
6
Amenity – Transport
7
Camping Or Caravan Park
8
Religious Grounds
9
Cemetery
10
Private Garden
11
Playing Field
12
Other Sports Facility
13
Tennis Court
14
Allotments Or Community Growing Spaces
15
Play Space
16
Bowling Green
17
Land Use Changing
18
Natural
(features with no other function but with Form attribute of woodland, open semi-natural, open water, foreshore)
The OS MasterMap Greenspace Layer product is supplied in Geography Markup Language (GML) version 3.2.1. This section describes how OS MasterMap Greenspace Layer is defined in GML. An understanding of XML (eXtensible Mark-up Language) and XML schemas is required.
GML is an XML grammar for expressing geographic features. GML serves as a modelling language for geographic systems as well as an open interchange format for geographic transactions on the Internet. More information can be found on the Open Geospatial Consortium (OGC). http://www.opengeospatial.org/standards/gml.
The XML specifications that GML is based on are available from the World Wide Web Consortium (W3C): http://www.w3.org.
Information about Unicode and UTF-8, the character encoding we have chosen, is available on the Unicode Consortium website: http://www.unicode.org.
Any use of examples in this chapter that mention specific data content are to be taken as examples only.
XML schemas are used to define and validate the format and content of the GML. The GML v3.2.1 specification provides a set of schemas that define the GML feature constructs and geometric types. These are designed to be used as a basis for building application-specific schemas, which define the data content.
The schema document defines the namespace, http://namespaces.ordnancesurvey.co.uk/OSMM/Greenspace/1.0, this is defined in the XSD at: https://www.ordnancesurvey.co.uk/xml/open/ogsp/1.0/OSMMGreenspace.xsd.
The code list dictionaries for the OS MasterMap Greenspace Layer can be found at the following URLs: http://www.os.uk/xml/codelists/GreenspaceFunctionValue.xml http://www.os.uk/xml/codelists/FormValue.xml
The name of the attribute and what it is describing.
The nature of the attribute, for example a numeric value or a code list value.
The length of the attribute provided (optional).
Describes how many times this element is expected to be populated in the data. An attribute may be optional or mandatory within the product. These are denoted by:
‘1’ – there must be a value.
‘0..1’ – population is optional but a maximum of one attribute will be returned These values may be used in combination.
OS MasterMap Greenspace Layer is supplied as a national vector tiles set in a single MBTiles file. This is a lightweight set of tiles that is efficient and fast to render in your software, and which provides high resolution data and gives a seamless experience when zooming in and out. The data is supplied in Web Mercator projection (ESPG:3857).
The vector tiles schema is detailed in the following table. In the zoom levels columns within the table, the letter N indicates that the specified layer and attribute are not mapped within that zoom level, whereas the letter Y indicates that the specified layer and attribute are mapped within that zoom level.
| Attribute | Zoom Levels: 0 to 12 | 13 | 14 | 15 | 16 |
|---|---|---|---|---|---|
toid
N
Y
Y
Y
Y
primary_function
N
Y
Y
Y
Y
polygon
N
Y
Y
Y
Y
GeoPackage offers users the following benefits:
The single file is easy to transfer and offers the end-user a rich experience.
Attribute names are not limited in length, making the format user-friendly.
The file size limit is very large at 140 TB*
It supports raster, vector and database formats, making it a highly versatile solution.
It is an OGC standard.
In most cases, it is a plug-and-play format.
* A file size limit might be imposed by the file system to which the file is written.
For information on how to open, use and understand a GeoPackage dataset, please refer to our Getting Started with GeoPackage guide. For further information on GeoPackage, please see the GeoPackage website.
