Road Link

A Road Link is a linear spatial object that defines the geometry and connectivity of a road network between two points in the network. Road Links can represent single carriageways, dual carriageways, slip roads, roundabouts, and indicative trajectories across traffic squares. Road Links will be split for connectivity purposes (for example, at junctions) and Road Nodes will connect the Road Links together. Each Road Link will provide a reference to the Road Nodes at the start and end of the Road Link.

Data schema versioning

The following table provides details about this feature type’s data schema versions, including the reasons behind the changes and the related launch date when each version went live.

Data schema version table

Please see for in-depth information about data schema versioning in the OS NGD.

Temporal filtering

Temporal filtering allows you to order a one-off snapshot of data from the OS NGD from a current or past date. It is an optional step when you create a new data package in OS Select+Build (the OS NGD download service).

The earliest and latest dates on which you can request a one-off snapshot of a date in the past for this feature type's data schema versions are indicated in the above. Please note that any data temporally filtered earlier than the specified launch date indicated in the table for the data schema versions may contain data inconsistencies.

More information about temporal filtering on OS NGD feature types is available from the .

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:

toid

Topographic Identifier (TOID) of the feature, as published in the OS MasterMap suite of products.

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

• Nullable: true

• Max Length: 20

• OS NGD API – Features Filterable:

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:

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:

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:

changetype

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

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

• Nullable: false

• Code List Name:

geometry

3D geometry for the feature.

• Data Types: Geometry (GeoJSON), Geometry (GPKG), WKT (CSV)

• Nullable: false

• OS NGD API – Features Filterable: No

• OS Select+Build Filterable:

geometry_length_m (formerly geometry_length)

The measured length of the geometry in metres.

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

• Nullable: false

• Precision: 15

• Scale: 3

theme

The OS NGD theme to which the feature belongs.

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

• Nullable: false

• Code List Name:

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

• Code List Name:

roadclassification

The official designated importance of a road that provides an indication of its expected usage and importance.

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

• Nullable: false

• Code List Name:

routehierarchy

A classification of the road designed to give the most appropriate route.

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

• Nullable: false

• Code List Name:

trunkroad

An indication of whether the Road Link forms part of the Trunk Road network.

primaryroute

An indication of whether the Road Link forms part of the Primary Route network.

roadclassificationnumber

The official road number assigned by the appropriate authority, for example, M6.

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

• Nullable: true

• Max Length: 10

• OS NGD API – Features Filterable:

name1_text

Name assigned to identify the feature.

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

• Nullable: true

• Max Length: 254

• OS NGD API – Features Filterable:

name1_language

The language type associated with name1. The valid values are defined in the Language Value Code List.

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

• Nullable: true

• Code List Name:

name2_text

The alternative language name assigned to identify the feature.

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

• Nullable: true

• Max Length: 254

• OS NGD API – Features Filterable:

name2_language

The language type associated with name2. The valid values are defined in the Language Value Code List.

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

• Nullable: true

• Code List Name:

alternatename1_text

Another name for the Road that the feature is part of. This is populated with the name captured by Ordnance Survey when it differs from that in Street.

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

• Nullable: true

• Max Length: 254

• OS NGD API – Features Filterable:

alternatename1_language

The language the name is expressed in, provided as a 3-digit ISO 639-2 code ('eng, 'cym', 'gla').

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

• Nullable: true

• Code List Name:

alternatename2_text

Another name for the Road that the feature is part of. This is populated with the name captured by Ordnance Survey when it differs from that in Street.

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

• Nullable: true

• Max Length: 254

• OS NGD API – Features Filterable:

alternatename2_language

The language the name is expressed in, provided as a 3-digit ISO 639-2 code ('eng, 'cym', 'gla').

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

• Nullable: true

• Code List Name:

operationalstate

Description of the current state of the Street, indicating which point the street record is at within its lifecycle.

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

• Nullable: false

• Code List Name:

directionality

Indication of the direction of traffic flow.

The directionality indicates the direction of traffic flow in relation to the direction of digitisation. A Road Node that is ‘in direction’ means that the traffic moves from start to end node, but ‘against direction’ means the traffic moves from end node to start node. The start and end nodes indicate the direction of digitisation.

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

• Nullable: false

• Code List Name:

cyclefacility

An indication of whether the the link has facilities for cyclists.

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

• Nullable: true

• Code List Name:

cyclefacility_wholelink

An indication of whether the facilities for cyclists apply to the whole link feature.

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

• Nullable: true

• OS NGD API – Features Filterable: No

• OS Select+Build Filterable:

roadstructure

Identifies whether this section of Road passes through or over a physical structure.

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

• Nullable: true

• Code List Name:

roadwidth_average

An indication of the average width of the road carriageway.

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

• Nullable: true

• Precision: 3

• Scale: 1

roadwidth_minimum

An indication of the minimum width of the road carriageway.

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

• Nullable: true

• Precision: 3

• Scale: 1

roadwidth_confidencelevel

The original capture specification for the topographic feature used to indicate the width of the carriageway. This provides an indication of the confidence that can be placed in the value provided.

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

• Nullable: true

• Code List Name:

elevationgain_indirection

The total ascent experienced when passing along a link feature in the direction of digitisation, calculated from three-dimensional geometry.

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

• Nullable: false

• Precision: 6

• Scale: 1

elevationgain_againstdirection

The total ascent experienced when passing along a link feature against the direction of digitisation, calculated from three-dimensional geometry.

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

• Nullable: false

• Precision: 6

• Scale: 1

heightingmethod

The origin and derivation of the three dimensional geometry of the Road Link.

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

• Nullable: false

• Code List Name:

capturespecification

Indicates the capture specification used by OS when capturing the feature. This could either be Urban, Rural or Moorland.

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

• Nullable: false

• Code List Name:

matchstatus

Indication of whether the feature has been matched to a feature in the National or Scottish Street Gazetteers.

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

• Nullable: false

• Code List Name:

startnode

The node coincident with the first vertex of the geometry attribute of the link feature.

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

• Nullable: false

• Max Length: 36

• OS NGD API – Features Filterable:

startgradeseparation

The relative level of the link at the startnode.

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

• Nullable: true

• OS NGD API – Features Filterable: No

• OS Select+Build Filterable:

endnode

The node coincident with the last vertex of the geometry attribute of the link feature.

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

• Nullable: false

• Max Length: 36

• OS NGD API – Features Filterable:

endgradeseparation

The relative level of the link at the endnode.

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

• Nullable: true

• OS NGD API – Features Filterable: No

• OS Select+Build Filterable:

presenceofpavement_overall_m

Indicates the overall presence of pavements along both sides of a Road Link in metres of the total length of the Road Link.

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

• Nullable: false

• Precision: 6

• Scale: 2

presenceofpavement_overallpercentage

Indicates the overall presence of pavements along both sides of a Road Link as a percentage of the total length of the Road Link.

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

• Nullable: false

• OS NGD API – Features Filterable: Yes

• OS Select+Build Filterable:

presenceofpavement_left_m

Indicates the presence of pavements along the left hand side of a Road Link in metres.

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

• Nullable: false

• Precision: 6

• Scale: 2

presenceofpavement_leftpercentage

Indicates the presence of pavements along the left hand side of a Road Link as a percentage of the total length of the Road Link.

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

• Nullable: false

• OS NGD API – Features Filterable: Yes

• OS Select+Build Filterable:

presenceofpavement_right_m

Indicates the presence of pavements along the right hand side of a Road Link in metres.

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

• Nullable: false

• Precision: 6

• Scale: 2

presenceofpavement_rightpercentage

Indicates the presence of pavements along the right hand side of a Road Link as a percentage of the total length of the Road Link.

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

• Nullable: false

• OS NGD API – Features Filterable: Yes

• OS Select+Build Filterable:

presenceofpavement_minimumwidth_m

Indicates the minimum width of the pavement along a Road Link measured in metres.

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

• Nullable: false

• Precision: 6

• Scale: 2

presenceofpavement_averagewidth_m

Indicates the average width of the pavement along a Road Link measured in metres.

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

• Nullable: false

• Precision: 6

• Scale: 2

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

presenceofpavement_updatedate

Date when the pavement presence was last updated.

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

• Nullable: false

• OS NGD API – Features Filterable: No

• OS Select+Build Filterable:

presenceofpavement_source

Indicates the data source of the pavement presence.

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

• Nullable: true

• Max Length: 85

• OS NGD API – Features Filterable:

presenceofpavement_capturemethod

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

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

• Nullable: false

• Code List Name:

presenceoftram_extentoflink

The extent of the Road Link to which the tramline applies.

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

• Nullable: true

• Code List Name:

presenceoftram_linkdirection

The direction of the Road Link to which the tramline applies in relation to the direction the link has been captured in.

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

• Nullable: true

• Code List Name:

presenceoftram_updatedate

Date when the the presence of tram was last updated.

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

• Nullable: true

• OS NGD API – Features Filterable: No

• OS Select+Build Filterable:

presenceoftram_source

The source organisation indicating the data provider of the tram data.

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

• Nullable: true

• Max Length: 85

• OS NGD API – Features Filterable:

presenceofstreetlight_coverage

An indication of the extent of street light coverage along the Road Link or Path Link.

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

• Nullable: false

• Code List Name:

• Max Length: 12

presenceofstreetlight_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: false

• OS NGD API – Features Filterable: No

• OS Select+Build Filterable: No

presenceofstreetlight_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

presenceofstreetlight_capturemethod

Indication of the method used to capture or produce the data.

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

• Nullable: false

• Code List Name:

• Max Length: 25

🆕 presenceofbuslane_overall_m

Indicates the length of the Road Link in metres that has a Bus Lane present on it.

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

• Nullable: false

• Precision: 6

• Scale: 2

🆕 presenceofbuslane_overallpercentage

Indicates the percentage of the Road Link that has a Bus Lane present on it.

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

• Nullable: false

• OS NGD API – Features Filterable: Yes

• OS Select+Build Filterable: Yes

🆕 presenceofbuslane_indirection_m

Indicates the length of the Road Link in metres that has a Bus Lane present on it that can be traversed in the direction of digitisation of the Road Link.

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

• Nullable: false

• Precision: 6

• Scale: 2

🆕 presenceofbuslane_indirectionpercentage

Indicates the presence of a Bus Lane that can be traversed in the direction of digitisation of the Road Link as a percentage of the total length of the Road Link.

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

• Nullable: false

• OS NGD API – Features Filterable: Yes

• OS Select+Build Filterable: Yes

🆕 presenceofbuslane_inoppositedirection_m

Indicates the length of the Road Link in metres that has a Bus Lane present on it that can be traversed against the direction of digitisation of the Road Link.

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

• Nullable: false

• Precision: 6

• Scale: 2

🆕 presenceofbuslane_inoppositedirectionpercentage

Indicates the presence of a Bus Lane that can be traversed against the direction of digitisation of the Road Link as a percentage of the total length of the Road Link.

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

• Nullable: false

• OS NGD API – Features Filterable: Yes

• OS Select+Build Filterable: Yes

🆕 presenceofbuslane_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 the date information was received from a third party.

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

• Nullable: false

• OS NGD API – Features Filterable: No

• OS Select+Build Filterable: No

🆕 presenceofbuslane_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

🆕 presenceofbuslane_capturemethod

Indication of the method used to capture or produce the data.

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

• Nullable: false

• Code List Name:

• Max Length: 25

🆕 presenceofcyclelane_overall_m

Indicates the length of the Road Link in metres that has a Cycle Lane present on it.

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

• Nullable: false

• Precision: 6

• Scale: 2

🆕 presenceofcyclelane_overallpercentage

Indicates the percentage of the Road Link that has a Cycle Lane present on it.

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

• Nullable: false

• OS NGD API – Features Filterable: Yes

• OS Select+Build Filterable: Yes

🆕 presenceofcyclelane_indirection_m

Indicates the length of the Road Link in metres that has a Cycle Lane present on it that can be traversed in the direction of digitisation of the Road Link.

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

• Nullable: false

• Precision: 6

• Scale: 2

🆕 presenceofcyclelane_indirectionsegregated_m

Indicates the length of the Road Link in metres that has some form of segregated Cycle Lane away from the carriageway that can be traversed in the direction of digitisation of the Road Link.

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

• Nullable: false

• Precision: 6

• Scale: 2

🆕 presenceofcyclelane_indirectionpercentage

Indicates the presence of a Cycle Lane that can be traversed in the direction of digitisation of the Road Link as a percentage of the total length of the Road Link.

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

• Nullable: false

• OS NGD API – Features Filterable: Yes

• OS Select+Build Filterable: Yes

🆕 presenceofcyclelane_inoppositedirection_m

Indicates the length of the Road Link in metres that has a Cycle Lane present on it that can be traversed against the direction of digitisation of the Road Link.

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

• Nullable: false

• Precision: 6

• Scale: 2

🆕 presenceofcyclelane_inoppositedirectionsegregated_m

Indicates the length of the Road Link in metres that has some form of segregated Cycle Lane away from the carriageway that can be traversed against the direction of digitisation of the Road Link.

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

• Nullable: false

• Precision: 6

• Scale: 2

🆕 presenceofcyclelane_inoppositedirectionpercentage

Indicates the presence of a Cycle Lane that can be traversed against the direction of digitisation of the Road Link as a percentage of the total length of the Road Link.

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

• Nullable: false

• OS NGD API – Features Filterable: Yes

• OS Select+Build Filterable: Yes

🆕 presenceofcyclelane_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: false

• OS NGD API – Features Filterable: No

• OS Select+Build Filterable: No

🆕 presenceofcyclelane_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

🆕 presenceofcyclelane_capturemethod

Indication of the method used to capture or produce the data.

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

• Nullable: false

• Code List Name:

• Max Length: 25

Road Track Or Path Reference

A cross reference table mapping Road Link to Road Track Or Path. 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.

roadtrackorpathid

The identifier of the Road Track Or Path feature.

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

• Nullable: false

• Max Length: 36

• OS NGD API – Features Filterable:

roadlinkid

The identifier of the Road Link feature.

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

• Nullable: false

• Max Length: 36

• OS NGD API – Features Filterable:

roadlinkversiondate

The date this version of the feature entered the OS National Geographic Database.

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

• Nullable: true

• OS NGD API – Features Filterable: No

• OS Select+Build Filterable: