LogoLogo
OS Docs HomeOS NGDOS APIsOS Download ProductsMore than MapsContact Us
  • More than Maps
  • Geographic Data Visualisation
    • Guide to cartography
      • Introduction to cartography
      • Types of maps
      • Symbology
      • Colour
      • Text on maps
      • Generalisation
      • Coordinate reference systems
      • Projections
      • Scale
      • Map legends
      • Map layout
      • Relief representation
      • North arrows
    • Guide to data visualisation
      • Introduction to data visualisation
      • GeoDataViz design principles
      • Types of visualisation
      • Thematic mapping techniques
      • Data visualisation critique
      • Accessible data visualisation
      • Ethical data visualisation
      • Software
      • Data
    • GeoDataViz assets
      • GeoDataViz basemaps
      • Stylesheets
      • GeoDataViz virtual gallery
      • Equal area cartograms
      • How did I make that?
        • Apollo 11 Landing
        • North York Moors National Park, 70 years
        • Snowdonia National Park, 70 years
        • Great Britain's National Parks
        • Great Britain's Islands
        • Great Britain's AONB's and National Scenic Areas
        • Famous shipwrecks of Pembrokeshire
        • Trig pillars today
        • Britain's most complex motorway junctions
      • #30DayMapChallenge
  • Data in Action
    • Examples
  • Demonstrators
    • 🆕Product Viewer
    • Addressing & location demonstrators
      • Address Portfolio overview
      • Which address product should you use?
      • AddressBase
      • AddressBase Core
      • AddressBase Plus
      • AddressBase Premium
      • Address Classifications
      • Addressing Lifecycle
      • OS Emergency Services Gazetteer
      • What are Vertical Streets?
      • Why are there differences in boundaries?
    • Contextual demonstrators
    • Customer best practice
      • Channel Shift
      • Data Management and OS Data Hub
      • End User Licence vs Contractor Licence
      • 🆕 IDs vs Spatial Relationships
      • Why we should capture good quality addresses at source
      • Why we Snap and Trace
    • Network Demonstrators
      • OS Detailed Path Network
      • OS Multi Modal Routing Network
        • OS Multi Modal Routing Network
      • Water Networks overview
      • OS MasterMap Highways Network and OS NGD Speeds
      • OS MasterMap® Highways Network and OS Open Roadsâ„¢
    • OS MasterMap Generation APIs
      • Using the OS Features API
      • Using the OS Features API Archive
      • Using the OS Downloads API
      • Using OS APIs in ESRI Software
    • 🆕OS NGD (National Geographic Database)
      • OS NGD Address
      • OS NGD Boundaries
      • 🆕OS NGD Buildings
        • 🆕Building and Building Access Feature Types
        • Building Part and Building Line Feature Types
      • 🆕OS NGD Geographical Names
      • OS NGD Land
      • OS NGD Land Cover enhancements
      • 🆕OS NGD Land Use
      • OS NGD Land Use enhancements
      • 🆕OS NGD Structures
        • 🆕OS NGD Structures
        • Field Boundaries
      • 🆕OS NGD Transport Features
      • 🆕OS NGD Transport Network
      • OS NGD Transport RAMI
      • OS NGD Water Features
      • OS NGD Water Network
      • OS NGD API - Features
      • Ordering OS NGD data
      • Change only updates
      • OS NGD Versioning
      • Creating a topographic map from OS NGD Data
      • Analytical styling for OS NGD data
    • OS MasterMap® demonstrators
    • 🆕Product & API Comparisons
      • 🆕Comparison of Water Network Products
  • Tutorials
    • GeoDataViz
      • Thematic Mapping Techniques
      • Downloading and using data from the OS Data Hub
      • How to download and use OS stylesheets
      • How to use the OS Maps API
      • Creating a bespoke style in Maputnik
    • GIS
      • Analysing pavement widths
      • Basic routing with OS Open Data and QGIS
      • Walktime analysis using OS Multi-modal Routing Network and QGIS
      • Creating 3D Symbols for GIS Applications
      • Constructing a Single Line Address using a Geographic Address
      • Creating a Digital Terrain Model (DTM)
      • Visualising a road gradient using a Digital Terrain Model
      • Visualising a road gradient using OSMM Highways
    • 🆕APIs
      • 🆕Using OS APIs with EPC API
      • 🆕OS APIs and ArcGIS
  • Deep Dive
    • Introduction to address matching
    • Guide to routing for the Public Sector
      • Part 1: Guide to routing
      • Part 2: Routing software and data options
      • Part 3: Building a routable network
    • Unlocking the Power of Geospatial Data
    • Using Blender for Geospatial Projects
    • A Guide to Coordinate Systems in Great Britain
      • Myths about coordinate systems
      • The shape of the Earth
      • What is position?
        • Types of coordinates
        • We need a datum
        • Position summary
      • Modern GNSS coordinate systems
        • Realising WGS84 with a TRF
        • The WGS84 broadcast TRF
        • The International Terrestrial Reference Frame (ITRF)
        • The International GNSS Service (IGS)
        • European Terrestrial Reference System 1989 (ETRS89)
      • Ordnance Survey coordinate systems
        • ETRS89 realised through OS Net
        • National Grid and the OSGB36 TRF
        • Ordnance Datum Newlyn
        • The future of British mapping coordinate systems
        • The future of British mapping coordinate systems
      • From one coordinate system to another: geodetic transformations
        • What is a geodetic transformation?
        • Helmert datum transformations
        • National Grid Transformation OSTN15 (ETRS89–OSGB36)
        • National Geoid Model OSGM15 (ETRS89-Orthometric height)
        • ETRS89 to and from ITRS
        • Approximate WGS84 to OSGB36/ODN transformation
        • Transformation between OS Net v2001 and v2009 realisations
      • Transverse Mercator map projections
        • The National Grid reference convention
      • Datum, ellipsoid and projection information
      • Converting between 3D Cartesian and ellipsoidal latitude, longitude and height coordinates
      • Converting between grid eastings and northings and ellipsoidal latitude and longitude
      • Helmert transformation worked example
      • Further information
  • Code
    • Ordnance Survey APIs
    • Mapping
    • Routing with pgRouting
      • Getting started with OS MasterMap Highways and pgRouting
      • Getting started with OS MasterMap Highways Network - Paths and pgRouting
      • Getting started with OS NGD Transport Theme and pgRouting
      • Getting started with OS NGD Transport Path features and pgRouting
  • RESOURCES
    • 🆕Data Visualisation External Resources
Powered by GitBook

Website

  • Ordnance Survey

Data

  • OS Data Hub
On this page
  • What is OS NGD schema versioning?
  • Type of data releases
  • What does versioning look like over time?
  • An example with OS NGD Address
  • Recipes
  • ​Gitbook help​
  • Versioning in the Recipe Library
  • ​How will versioning affect you?​

Was this helpful?

  1. Demonstrators
  2. OS NGD (National Geographic Database)

OS NGD Versioning

A Lightning Talk

PreviousChange only updatesNextCreating a topographic map from OS NGD Data

Last updated 7 months ago

Was this helpful?

What is OS NGD schema versioning?

Ordnance Survey is implementing schema versioning to OS NGD feature types to allow the easy flow of data updates to each data theme. ​

For example:​

Type of data releases

New Schema​ - The release of a new schema will cause a feature type to have a new version. A new schema is created when additional fields are added or when the addition or removal of attribution has occurred​

​Data Enhancement​ - The release of a data enhancement will not cause a feature type to have a new version. A data enhancement is when the existing data quality has been improved, but there are no changes to the fields or attribution specified in the dataset​

​New Feature​ - The release of a brand new feature will be known as version 1 of that feature type. A new feature will contain the original schema, and can be adapted by data enhancements​

What does versioning look like over time?

  • As new data updates are made and released, the versioning will continue (V1, V2, V3 etc…)​

  • To manage versioning over time there will be a ‘latest’ version and ‘maintenance’ versions

  • ​Once a new ‘latest’ version is released, the previous version will become a ‘maintenance’ version : ​V 1 – maintenance, V 2 – latest​

  • A maintenance version is still available in OS NGD and usable through OS Select+Build​

  • There will be no more than three versions available in OS NGD at any one time (one ‘Latest’ and up to two ‘Maintenance’ versions)​ : V 1 – Maintenance, V 2 – Maintenance, V 3 – Latest​

  • Once three versions have been released, Version 1 will be removed from OS NGD, and will no longer be available through OS Select+Build​

An example with OS NGD Address

Built Address is a feature type found under the Address theme, and in the GB Address collection​

It is an existing feature type which means it has a current Version number. As there hadn’t been any data updates since it was first released to OS NGD, it was released as Version 1​

There have now been updates made to the Built Address schema as some new fields and attributions have been added​

Updates to feature types are released in OS NGD updates (every 6 months – March or September)​

When a new version is available the feature type, in this example we choose Built Address, and it defaults to the newest version available, which is then Version 2​

Recipes

When a new version of the feature type is live, you can choose what version you want to download by selecting the feature type and choosing from the dropdown list. In this example we select Built Address and choose version 2​

Version 1 is the Built Address feature type with the original schema containing the original fields and attribution (no new fields or attribution will be in this version)​

Version 2 is the Built Address feature type with the new schema containing the original and new fields and attribution​

You can find out what the new fields and attribution are by navigating to the National Geographic Database Platform on the OS Gitbook site​

​Gitbook help​

When a new schema version is released (or close to release), the OS NGD Platform on Gitbook will be updated​

Using the OS NGD Address example; A notification will appear under the applicable Address feature types that are receiving updates and changes in the new version when a release is planned but not yet live​

Under each field that is available within the feature type a new metadata point ‘Data Schema Version’ has been added which says what versions of this feature type has this field in it​

For either new fields or fields receiving new attribution that are not in the original version but are in the new version, the ‘Data Schema Version’ will only specify the new version​

Versioning in the Recipe Library

When viewing your recipe in the Recipe Library you can tick the box ‘Show schema version’ to view what version of the feature types are included in that recipe​

​How will versioning affect you?​

Advanced notice will be given if there are plans to make an update and create a new feature type schema version​

There is no immediate requirement for customers to adopt a feature type’s new schema version​

12 months or more notice will be given if there are plans to remove a version from OS NGD and therefore make it no longer accessible​

Customers will need to create a new recipe in OS Select+Build to use the new feature type version​

When customers view a recipe in their recipe library there will be an option to view the feature type versions that are included​


Links that may be useful:

Sample schemas will be made available to ensure customers can understand and support it. Information will be made available via our Gitbook page and updated SQL DDL via Github OS NGD Resources​

This content has been developed from what was originally a Lightning Talk PowerPoint slide set. These slides are available to PSGA members to view and download from the

OS NGD Documentation
Platform
PSGA members area of the OS website
🆕
OS NGD Documentation Platform | osngd
Logo
OS Data HubOrdnanceSurvey
Logo
OS Select+Build | OS productsOrdnance Survey
Page cover image
Logo