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.
Temporal filtering
The earliest date on which you can request a one-off snapshot of a date in the past for data in this feature type is 29 September 2022.
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
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: Yes
OS Select+Build Filterable: No
Data Schema Version: 1.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
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
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
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: changetypevalue
Max Length: 50
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: No
Data Schema Version: 1.0
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: No
Data Schema Version: 1.0
Geometry Type: LineString
geometry_length
The measured length of the geometry in metres.
Data Types: Number (GeoJSON), Float (GPKG), Real (CSV)
Nullable: false
Precision: 15
Scale: 6
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: No
Data Schema Version: 1.0
theme
The OS NGD Theme to which the feature belongs. Multiplicity allows for a primary theme to be assigned along with additional themes. For example, a Verge is primarily in the OS NGD Transport Theme, but it is also in the OS NGD Land Theme.
Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Code List Name: themevalue
Max Length: 40
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.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
Code List Name: formofwaytypevalue
Max Length: 42
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
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: roadclassificationvalue
Max Length: 21
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
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: roadfunctionvalue
Max Length: 32
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
trunkroad
An indication of whether the road link forms part of the Trunk Road network.
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
primaryroute
An indication of whether the road link forms part of the Primary Route network.
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
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: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
name1_text
Name assigned to identify the boundary feature.
Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 254
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
name1_language
The language type associated with name1. The valid values are defined in the LanguageValue code list.
Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Code List Name: languagevalue
Max Length: 3
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0
name2_text
The alternative language name assigned to identify the boundary feature.
Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Max Length: 254
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
name2_language
The language type associated with name2. The valid values are defined in the LanguageValue code list.
Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: true
Code List Name: languagevalue
Max Length: 3
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0
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: No
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
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: languagevalue
Max Length: 3
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0
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: No
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
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: languagevalue
Max Length: 3
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0
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: operationalstatevalue
Max Length: 19
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
directionality
Indication of the direction of traffic flow.
Data Types: String (GeoJSON), String (GPKG), String (CSV)
Nullable: false
Code List Name: linkdirectionvalue
Max Length: 21
OS NGD API – Features Filterable: No
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
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: cyclefacilityvalue
Max Length: 45
OS NGD API – Features Filterable: No
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
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: No
Data Schema Version: 1.0
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: roadstructurevalue
Max Length: 14
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
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
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
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
OS NGD API – Features Filterable: Yes
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
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: roadwidthconfidencelevelvalue
Max Length: 27
OS NGD API – Features Filterable: No
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
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
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0
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
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0
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: heightingmethodvalue
Max Length: 19
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0
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: capturespecificationvalue
Max Length: 40
OS NGD API – Features Filterable: No
OS Select+Build Filterable: No
Data Schema Version: 1.0
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: matchstatusvalue
Max Length: 39
OS NGD API – Features Filterable: No
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
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: No
OS Select+Build Filterable: No
Data Schema Version: 1.0
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: No
Data Schema Version: 1.0
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: No
OS Select+Build Filterable: No
Data Schema Version: 1.0
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: No
Data Schema Version: 1.0
Road Track Or Path Reference
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: No
OS Select+Build Filterable: No
Data Schema Version: 1.0
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: No
OS Select+Build Filterable: No
Data Schema Version: 1.0
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: No
Data Schema Version: 1.0
Last updated
Was this helpful?