About the National Rail Feeds: Difference between revisions

From Open Rail Data Wiki
Dev docs
EvelynSnow (talk | contribs)
Unbreak broken links
 
(42 intermediate revisions by 9 users not shown)
Line 1: Line 1:
In May 2014, [http://www.nationalrail.co.uk/ National Rail Enquiries] [http://www.nationalrail.co.uk/46391.aspx announced changes to its licensing conditions] for using data from their [http://www.nationalrail.co.uk/contact/feedback/46615.aspx Darwin] system.
The [https://www.raildeliverygroup.com/ Rail Delivery Group] (formerly known as Association of Train Operating Companies, or simply ATOC) under their [http://www.nationalrail.co.uk/ National Rail] brand provide a number of data feeds for passenger-facing information systems across the railway network. The [https://www.nationalrail.co.uk/developers/darwin-data-feeds/ developers page] on the NRE website provides information for the data feeds provided, some of which are free and some of which are chargeable. They also provide a summary of feeds they supply in the [https://assets.nationalrail.co.uk/e8xgegruud3g/2PHRyfp2mN2N0UUd6nyK0B/770a70c6c08296905136e2c1ef1ca06a/NRE_Feeds_Developer_Pack_v.01-05.pdf Feeds developer pack]


The following documentation is available for the feeds:
Outages and faults with RDG's data feeds should be reported to the email addresses in the below table; these contacts should not be used for general inquiries or support. For general usage support on National Rail (and other open rail data), use the [https://groups.google.com/d/forum/openraildata-talk openraildata-talk] forum.


* [http://www.slideshare.net/nationalrailenq/nre-developer-terms-conditions Developer Terms & Conditions]
== Terms and Conditions ==
* [http://www.slideshare.net/nationalrailenq/nre-developer-guidelines-v-22 Developer Guidelines]
* [https://opendata.nationalrail.co.uk/terms Developer Terms & Conditions (version 3)]
* [http://www.slideshare.net/nationalrailenq/nre-usage-charging-document-v-10-35307736 Usage Charging Document]
* [https://assets.nationalrail.co.uk/e8xgegruud3g/7yPy7gHJ7j3QZalp2zKZKJ/e32e5b871465c3a5f920e86cc07900d6/Developer_Guidelines_v_05-01.pdf Developer Guidelines (version 05.01)]
* [https://realtime.nationalrail.co.uk/ldbws/ Developer documentation]
* [https://assets.nationalrail.co.uk/e8xgegruud3g/3aKkEQ1sNtS25lD6o0fZdT/7cee7bcc2bed18c090ff6735e8b10e88/Usage_Charging_Document_v04-01.pdf Usage Charging Document (version 04-01)]
* Attribution of NRE as the data source should be in line with the [https://assets.nationalrail.co.uk/e8xgegruud3g/5ebcjZTTKAptCTtnPfBi4V/22a3bd92a54a84a4f82720c38559e629/Brand_Guidelines_Logos_2.zip Brand Guidelines & Logos]


It is anticipated that further information on the feeds, including their format and use cases, will be documented by the Open Rail Data community and made available here in due course.
==Freely available Feeds/APIs==
 
{| class="wikitable"
! Feed
! Type
! Availability
! Reporting faults
|-
|[[NreDarwinWebServicePublic|Darwin Webservice (Public)]]
|SOAP API
|[http://realtime.nationalrail.co.uk/OpenLDBWSRegistration Register]
|[mailto:infoservices@nationalrail.co.uk infoservices@nationalrail.co.uk]
|-
|[[NreDarwinWebServiceStaff|Darwin Webservice (Staff)]]
|SOAP API
|See below
|[mailto:infoservices@nationalrail.co.uk infoservices@nationalrail.co.uk]
|-
|[[Darwin:Push_Port|Darwin Push Port]]
|Pub/Sub stream
|[https://opendata.nationalrail.co.uk/ Register]
|[mailto:dsg_darwind3.support@caci.co.uk dsg_darwind3.support@caci.co.uk]
|-
|[[HSP|Historical Service Performance]]
|JSON API
|[https://opendata.nationalrail.co.uk/ Register]
|[mailto:dsg_darwind3.support@caci.co.uk dsg_darwind3.support@caci.co.uk]
|-
|[[KnowledgeBase|KnowledgeBase]]
|XML Feed
|[https://opendata.nationalrail.co.uk/ Register]
|[mailto:dsg_darwind3.support@caci.co.uk dsg_darwind3.support@caci.co.uk]
|-
|[[DTD|DTD]]
|Flat file feeds
|[https://opendata.nationalrail.co.uk/ Register]
|[mailto:dsg_darwind3.support@caci.co.uk dsg_darwind3.support@caci.co.uk]
|}
 
==Registering for OpenLDBSV/Darwin Staff Webservice==
OpenLDBSVWS has a [http://openldbsv.nationalrail.co.uk/ web registration process], this is currently (May 2023) broken, and cannot send registration verification emails. In the meantime, until the automatic registration process is fixed, RDG have established a procedure for manually creating accounts for the service. To request an account, send a completed [https://assets.nationalrail.co.uk/e8xgegruud3g/3naKK7Qy2P4Rs6VYvyCCxJ/e54ddd40e85b5e2c5acf85702da8f554/Licence-Request-Form.pdf licence request form] to [mailto:nationalraildatafeeds@raildeliverygroup.com nationalraildatafeeds@raildeliverygroup.com], RDG staff will send you a license to sign, and then can provide you with account credentials.
 
Note that the licence request form is generic, and is oriented more towards commercial data feeds users, but the eligibility criteria and license conditions for OpenLDBSV for open data feeds users remain the same as before.
 
==Licensed Feeds==
NRE also provide a number of APIs from the Online Journey Planner service. Whilst anyone can request access to these APIs, due to contractual constraints NRE are currently unable to offer them without cost (and an associated license). More information can be found on the [https://www.nationalrail.co.uk/developers/online-journey-planner-data-feeds/ OJP feeds page] on NRE's site.
 
{| class="wikitable"
! Feed
! Type
! Availability
|-
|[[Real_Time_Journey_Planner|RTJP web service]]
|SOAP API
|Formal license, charged
|-
|Disruptions web service
|JSON API
|Formal license, free of charge
|-
|(What can I do with) My Ticket web service
|JSON API
|Formal license, charged
|}
 
{{Navtable-NreDataFeeds}}
 
[[Category:National Rail Enquiries Data Feeds]]

Latest revision as of 10:10, 8 June 2023

The Rail Delivery Group (formerly known as Association of Train Operating Companies, or simply ATOC) under their National Rail brand provide a number of data feeds for passenger-facing information systems across the railway network. The developers page on the NRE website provides information for the data feeds provided, some of which are free and some of which are chargeable. They also provide a summary of feeds they supply in the Feeds developer pack

Outages and faults with RDG's data feeds should be reported to the email addresses in the below table; these contacts should not be used for general inquiries or support. For general usage support on National Rail (and other open rail data), use the openraildata-talk forum.

Terms and Conditions

Freely available Feeds/APIs

Feed Type Availability Reporting faults
Darwin Webservice (Public) SOAP API Register infoservices@nationalrail.co.uk
Darwin Webservice (Staff) SOAP API See below infoservices@nationalrail.co.uk
Darwin Push Port Pub/Sub stream Register dsg_darwind3.support@caci.co.uk
Historical Service Performance JSON API Register dsg_darwind3.support@caci.co.uk
KnowledgeBase XML Feed Register dsg_darwind3.support@caci.co.uk
DTD Flat file feeds Register dsg_darwind3.support@caci.co.uk

Registering for OpenLDBSV/Darwin Staff Webservice

OpenLDBSVWS has a web registration process, this is currently (May 2023) broken, and cannot send registration verification emails. In the meantime, until the automatic registration process is fixed, RDG have established a procedure for manually creating accounts for the service. To request an account, send a completed licence request form to nationalraildatafeeds@raildeliverygroup.com, RDG staff will send you a license to sign, and then can provide you with account credentials.

Note that the licence request form is generic, and is oriented more towards commercial data feeds users, but the eligibility criteria and license conditions for OpenLDBSV for open data feeds users remain the same as before.

Licensed Feeds

NRE also provide a number of APIs from the Online Journey Planner service. Whilst anyone can request access to these APIs, due to contractual constraints NRE are currently unable to offer them without cost (and an associated license). More information can be found on the OJP feeds page on NRE's site.

Feed Type Availability
RTJP web service SOAP API Formal license, charged
Disruptions web service JSON API Formal license, free of charge
(What can I do with) My Ticket web service JSON API Formal license, charged


National Rail Enquiries Data Feeds
Data Feeds About the Feeds Darwin Webservice (Public) Darwin Webservice (Staff) Historical Service Performance Push Port KnowledgeBaseDTDLocations (PoC)Real Time Journey Planner
LDB API About
LDB-SV API About
HSP About
DTD About Fares Timetable
Push Port About XML Schemas Schedules Associations Train Status Station Messages Alarms Train Order Train Alerts Formations Formation loading