GML overview

The OS MasterMap Topography Layer product is supplied in Geography Markup Language (GML) version 2.1.2. This section describes how OS MasterMap is defined in GML. An understanding of XML

(eXtensible Mark-up Language) and XML schemas is required. The XML specifications that GML is based on are available from the World Wide Web Consortium (W3C) website.

XML schema

Schema overview and Internet location

XML schemas are used to validate the format and content of the GML. The GML 2.1.2 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 Ordnance Survey application schemas that are referenced by the data are available from the Ordnance Survey XML schemas page of the OS website.

These schemas make use of XML Schema Definitions (XSDs) and Document Type Definitions (DTDs) produced by the W3C that are available from The XML: Namespace page of the W3C website.

Some recent parsers now fail to validate OS MasterMap Topography Layer using these schemas as working practices and XML schema specification clarifications have led to GML 2.1.2 being rendered invalid.

Schema descriptions

The W3C-provided XSDs and DTDs are:

  • xml.xsd – To allow the use of the xml:lang attribute for language qualification.

  • XMLSchema.dtd – Required by xml.xsd.

  • datatypes.dtd – Required by XMLSchema.dtd.

The OGC-provided schemas are:

  • feature.xsd – The feature and property constructs.

  • geometry.xsd – The geometric constructs, such as polygon and point.

  • xlinks.xsd – A schema based on the W3C XLINK recommendation provided by the OGC to make use of the XLINK constructs.

The Ordnance Survey application schemas are:

  • OSDNFFeatures.xsd – The definition of the Ordnance Survey features and their properties.

  • OSComplexTypes.xsd – The complex property types, including changeHistoryType.

  • OSSimpleTypes.xsd – The basic property types, including descriptiveGroupType and accuracyOfPositionType.

  • OSMeasures.xsd – The definition of measure-qualified types used in OS MasterMap data.

  • OSQueryresult.xsd – The definition of a query result with its properties.

  • OSGeometryTopology.xsd – Geometry and topology extensions to the GML 2.1.2 specification required by Ordnance Survey, including rectangles and polygon topology.

XML namespaces

Use of examples

Any examples in this section that mention specific data content are to be taken as examples only. All data content is defined in OS MasterMap Topography Layer separately, and the examples are not necessarily in harmony with the data specification.

XML declaration

The XML declaration to all query results is: <?xml version=‘1.0’ encoding=‘UTF-8’?>

Document type

All information returned from a query is provided in an osgb:FeatureCollection. If no features lie inside a query, then an empty collection is returned with its required collection properties.

The document defines the XML namespaces:

osgb – https://www.ordnancesurvey.co.uk/xml/schema/v9/index.html The location of the schema is defined as: https://www.ordnancesurvey.co.uk/xml/schema/v9/index.html http://www.ordnancesurvey.co.uk/xml/schema/vX/OSDNFFeatures.xsd The fid is set to the Ordnance Survey identifier given to the query.

For example:

<osgb:FeatureCollection xmlns:osgb=’
http://www.ordnancesurvey.co.uk/xml/namespaces/osgb
’ xmlns:gml=
’http://www.opengis.net/gml’
 xmlns:xlink=’
http://www.w3.org/1999/xlink
’ xmlns:xsi=’
http://www.w3.org/2001/XMLSchema-instance
’ xsi:schemaLocation=
’http://www.ordnancesurvey.co.uk/xml/namespaces/osgb
 
http://www.ordnancesurvey.co.uk/xml/schema/vX/OSDNFFeatures.xsd
’ fid=’queryId’>
...
</osgb:FeatureCollection>

Query result properties

The gml:description element is the first property of the feature collection; this contains a copyright statement and the date of the query.

The gml:boundedBy element is the next property of the feature collection; this contains a gml:null element with the value of ‘unknown’.

The start time of the query is specified at GMT as a feature property. The name of the property is queryTime.

The following optional properties are provided for the osgb:FeatureCollection if they were provided as part of the query. The ordering of these properties is according to the order they appear in the table:

NameTypeFormatDescription

queryExtent

Geometric property

gml:Polygon or osgb:Rectangle (see Geometry).

The query extent provided as part of a spatial query.

queryChangeSinceDate

Date

CCYY-MM-DD

The date that was given as part of a change-only query.

For geographically chunked data, if there are features in the collection, the last element in the feature collection is an osgb:boundedBy element. This is a gml:Box defining the minimum bounding rectangle of all items in the collection, including the query extent. If the collection is empty, no osgb:boundedBy element is provided.

For example:

<osgb:FeatureCollection xmlns:osgb=‘
http://www.ordnancesurvey.co.uk/xml/namespaces/osgb’
 xmlns:gml=
‘http://www.opengis.net/gml’
 xmlns:xsi=
http://www.w3.org/2001/XMLSchema-instance
 xmlns:xlink=
http://www.w3.org/1999/xlink
 xsi:schemaLocation=‘
http://www.ordnancesurvey.co.uk/xml/namespaces/osgb http://www.ordnancesurvey.co.uk/xml/schema/v3/OSDNFFeatures.xsd
fid=‘queryId’>
<gml:description>
OrdnanceSurvey, (C) CrownCopyright. All rights reserved, 2002-05-16
</gml:description>
<gml:boundedBy><gml:null>unknown</gml:null></gml:boundedBy>
<osgb:queryTime>2001-03-28T14:31:54</osgb:queryTime>
<osgb:queryExtent’>
<osgb:Rectangle srsName=‘osgb:BNG’>
<gml:coordinates>4000000,3094763 4000010,3094820</gml:coordinates>
</osgb:Rectangle>
</osgb:queryExtent>
<osgb:queryChangeSinceDate>2001-01-31</osgb:queryChangeSinceDate>
<!-features go here-->
<osgb:boundedBy>
<gml:Box srsName=‘osgb:BNG’>
<gml:coordinates>3999350,3089542 4005602,3095673</gml:coordinates>
</gml:Box>
</osgb:boundedBy>
</osgb:FeatureCollection>

Features

Each feature within the osgb:FeatureCollection is encapsulated in one of the following member elements according to its feature type:

Member elementFeature type

boundaryMember

BoundaryLine

cartographicMember

CartographicText, CartographicSymbol

topographicMember

TopographicPoint, TopographicLine, TopographicArea

departedMember

DepartedFeature (see section on COU)

Each member element contains a single feature element that has the name of the feature type, for example, TopographicPoint, TopographicLine, and so on.

The TOID of the feature is provided in the XML attribute ‘fid’ of the osgb:Feature element. A TOID has a maximum of 16 digits and is prefixed with ‘osgb’. The ‘osgb’ prefix is required to form a valid XML ID type.

A feature element does not contain a name, description or boundedBy element. For example:

<osgb:topographicMember>
<osgb:TopographicPoint fid=‘osgb15789329786’>
....
</osgb:TopographicPoint>
</osgb:topographicMember>

Properties

Our application schema defines three main types of properties that are present inside a feature element; these are simple, complex and geometric properties.

The ordering of properties within a feature element is important as XML validation is reliant on elements being in a specified order. The order of properties is specified within the XML schema.

Each type of property may additionally have associated metadata encoded using an XML attribute. This metadata provides some qualification of the status or accuracy of the content provided in the attribute.

Simple

A simple property is one that contains a single piece of non-geometric information. These properties correspond to simple feature attributes. The value of each feature attribute is enclosed in an element that takes its name from the feature attribute.

A feature association is a special type of simple property that defines a relationship between one feature and another. The feature association is defined by the XML attribute xlink:href. This shall refer to a feature as if it was locally available, even though this is not guaranteed to be the case; that is, it shall be set to the character ‘#’ followed by ‘osgb’ and then the TOID of the feature being referenced.

For example:

<osgb:descriptiveGroup>Rail</osgb:descriptiveGroup>
<osgb:calculatedAreaValue>13254</osgb:calculatedAreaValue>
<osgb:referenceToFeature xlink:href=‘#osgb5798572675343543’/>

Geometry

A geometric property is one that describes a specific geometry. All geometric properties are encoded according to the GML specification. We have extended the GML v.2.1.2 specification to include a rectangle that is defined by two points. The first point defines the minimum coordinate, whilst the second point defines the maximum coordinate.

All geometric properties are encoded by placing the GML geometry elements inside an element that takes its name from the feature attribute.

The XML attribute srsName shall be set to ‘osgb:BNG’ (BNG stands for British National Grid), which uses eastings and northings specified in metres.

If a line is broken or a polygon has bled into another because of a partial update (see inconsistent features), then the XML attribute broken shall be set to ‘true’. A line that is broken will be encoded as a gml:MultiLineString.

All polygon outer boundaries have an anticlockwise orientation, and all inner boundaries have a clockwise orientation.

For example:

<osgb:anchorPoint>
<gml:Point srsName=‘osgb:BNG’>
<gml:coordinates>12365.563,8975.676</gml:coordinates>
</gml:Point>
</osgb:anchorPoint>
<osgb:queryExtent>
<osgb:Rectangle srsName=‘osgb:BNG’>
<gml:coordinates>0,0 700000,1300000</gml:coordinates>
</osgb:Rectangle>
</osgb:queryExtent>
<osgb:polyline broken=‘true’>
<gml:MultiLineString srsName=‘osgb:BNG’>
<gml:lineStringMember>
<gml:LineString>
<gml:coordinates>
01289.2,970344.5 301300.0,970352.6
</gml:coordinates>
</gml:LineString>
</gml:lineStringMember>
<gml:lineStringMember>
<gml:LineString>
<gml:coordinates>
301300.0,970354.1 301304.6,970369.8
</gml:coordinates>
</gml:LineString>
</gml:lineStringMember>
</gml:MultiLineString>
</osgb:polyline>

Complex

A complex property is one that contains more than one piece of information. These properties correspond to the complex feature attributes.

Class model

The definition of a complex property here is recursive, so complex properties may be nested. Currently, within OS MasterMap, this recursion is not used.

Figure 9: Class model diagram showing a complex property in OS MasterMap Topography Layer.

XML mapping

The complex property element takes its name from the complex feature attribute. Each part of a complex property shall be encoded as a simple, complex, geometry or topology property, as appropriate, inside the complex property element.

For example:

<osgb:textRendering>
<osgb:anchorPosition>4</osgb:anchorPosition>
<osgb:font>2</osgb:font>
<osgb:height>24</osgb:height>
<osgb:orientation>3476</osgb:orientation>
</osgb:textRendering>
<osgb:heightAboveDatum>
<osgb:heightAboveDatum>3456</osgb:heightAboveDatum>
<osgb:accuracyOfPosition>2.0m</osgb:accuracyOfPosition>
</osgb:heightAboveDatum>

Last updated