NPTG & NaPTAN uses a systematic versioning scheme in line with GovTalk & e-Gif standards. The system is intended to allow you to design applications that operate at different schema levels concurrently, and to manage future schema application evolution in a rigourous and orderly manner.
Both schemas & instance documents are versioned.
1. Version Numbering
1.1 Version Numbers
All NPTG & NaPTAN schemas have a version Identifier of the form N.Mx, where:
- N indicates a Major release, e.g. "2.0". A major release is usually is not strictly compatible with the previous release.
- M indicates a Minor release, e.g. "2.1". A minor release is compatible with the previous release, providing any new optional features added in the release are not used
- x indicates an Unapproved draft, e.g. "1.0a", "4.3a". A letter suffix indicates that the release is not yet officially approved or released.
2. Version Location
2.1 Schema versions
NPTG & NaPTAN schema versions are always located at a specific, versioned URL. The URL has the general form:
Version 1.1 of NaPTAN:
2.2 Namespace versions
Note that the namespace used for NaPTAN is not itself versioned, in line with GovTalk & e-Gif standards, thus:
2.3 Directory Structure
NPTG & NaPTAN artefacts are organised into a hierarchical directory structure relative to the root domain, in accordance with the e-Gif versioning system. For example the directory structure used is as follows:
//www.naptan.org.uk/ //www.naptan.org.uk/schema/ ... //www.naptan.org.uk/schema/2.1/ //www.naptan.org.uk/schema/2.1/NaPtan.xsd
//www.naptan.org.uk/schema/2.0/ //www.naptan.org.uk/schema/2.0/NaPtan.xsd //www.naptan.org.uk/schema/2.0/NPTG.xsd //www.naptan.org.uk/schema/2.0/NPTG_Discovery.xsd //www.naptan.org.uk/schema/2.0/napt/NaPT_stop-v2-0.xsd //www.naptan.org.uk/schema/2.0/napt/NaPT_common-v2-0.xsd //www.naptan.org.uk/schema/2.0/napt/NaPT_dates-v2-0.xsd //www.naptan.org.uk/schema/2.0/napt/NaPT_geographic-v2-0.xsd //www.naptan.org.uk/schema/2.0/napt/NaPT_topography-v2-0.xsd //www.naptan.org.uk/schema/2.0/xml/xml.xsd //www.naptan.org.uk/schema/2.0/guide //www.naptan.org.uk/schema/2.0/guide/NaPtanSchemaGuide-v2.0-32.pdf ....'
3.1 Schema Version Identifiers
All NPTG & NaPTAN schema versions have a formal version identifier in the header element:
<xs:schema targetNamespace="http://www.naptan.org.uk/schemas/" xmlns="http://www.naptan.org.uk/schemas/" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified" version="2.0" id="NaPTAN"> ...
3.2 Document Version Identifiers
All NPTG & NaPTAN documents have a version identifier which must be populated by the implementation to indicate the schema level against which the document validates.
<?xml version='1.0' encoding='UTF-8'?>
< NaPTAN xmlns =' www.dft.gov.uk/naptan/ " xmlns:xsi =" http://www.w3.org/2001/XMLSchema-instance' xsi:schemaLocation =" http://www.naptan.org.uk/:\Projects\Naptan\schema\2.0\NaPTAN.xsd " CreationDateTime =" 2004-07-17T09:30:47-05:00 " ModificationDateTime =" 2004-07-17T09:30:47-05:00 " Modification =" new " RevisionNumber =" 1 " FileName =" String ' SchemaVersion =' 2.0 ' LocationSystem =' Grid ">
< StopPoints >
</ StopPoints >
3.3 Package versions
Low level subschemas that are shared with other schemas and referenced by NPTG & NaPTAN schemas are individually versioned within a subdirectory, for example /napt and /apd. Copies of the referenced subschemas are included in the download so that the schemas can be used offline. For example:
Page last updated: 2013.03.29