Advanced Search
Search Results
52 total results found
Create Blanket Speed Restriction
Background A Blanket Speed Restriction (BSR) can be imposed to restrict speeds over a wide area. This is typically due to a forecast of bad weather. Our implementation consists of two parts; Blanket Speed Notice – a Route may impose a single Notice to Ope...
Register to Receive Webhooks
Please contact us via help@nrsdb.uk to register to use our webhooks feature. You will need to create a publicly available web address (URL) that can receive the data. We currently support the following events; Impose ESR Amend ESR Withdraw ESR As you...
Webhook Signing
When you register for webhooks we will assign a "secret". This should be kept securely (do not commit to source control). We will create a signature using this secret and a timestamp each time we send you a webhook. You should use the secret to validate this ...
Abbreviations and Acronyms
Some are more obvious that others :-) GF = Ground Frame (manual points) HABD = Hot Axle Box Detector LC = Level Crossing (optionally with suffix): AHB = Automatic Half Barrier AHBC-X = AHB with reverse direction capability ABCL = Auto...
Introduction
Chris Scharf <Chris.SCHARF@networkrail.co.uk> has compiled this excellent introduction to Speed Restrictions - Emergency and temporary speed restriction over view.pdf
Signed API V2
For external use we offer an API that requires each request to be sent with a "signature" created using the request content and a timestamp. This makes each signature useful for a short time only and prevents possible replay attacks. Signed API V2 Base URL: ...
Tools
Plot ELR Start by choosing the ELR you wish to work with from the drop down on the left of the toolbar. This will draw the path of the ELR on the map and create a table showing all the "track segments" and their mileages. A "track segment" is a contiguous...
Introduction
The ELR Explorer has been created to help Incident Controllers create accurate Speed Restrictions. We can explore the track layout for any ELR, discover the available track IDs (TRID), review the key locations along the ELR and discover adjoining ELRs. We als...
Signed API V1 (deprecated)
Signed API V1 (Deprecated) Base URL: https://nrsdb.uk/api/nrsdb.php Signature Append the signature, timestamp and key as URL parameters, e.g. https://nrsdb.uk/api/nrsdb.php?key=test×tamp=12345678&signature= Endpoints Add the 'r' parameter to the URL...
Create Signature
Registration Registered users of the API will be issued with a key and secret. End points require authentication by passing the following URL params: - key - identifies the requesting organisation- timestamp - UNIX timestamp at time signature is calculated,...
Subscriptions and Alerts
Each Train Operating Company will have one or more "Operator" accounts that are responsible for receiving ESRs and distributing them to their drivers. NRSDB tracks the alerts sent to these accounts and records an Acknowledgement when that user returns to revi...
Acknowledgements
Our email alerts contain a "View ESR" link that will open NRSDB and take you directly to the correct speed. We record "acknowledgement" automatically when you enter the Speed page. From here you can download or print the Notice (PDF).
View TSRs
Each list view has a summary of ESRs and TSRs by Route. There is a link to the TSR list view This view gives the details for all active TSRs (it includes those that are imposed by not yet active) You can hover over the speech bubble on those TSR...
Email Alerts
NRSDB will soon cover the entire network and we average about 5 events (Impose, Amend or Withdraw) each day. Most users do not need to receive every single alert. Some are only interested in a route or a particular line. For example C2C exclusively run on the...
Sample Code
PHP This is a comprehensive example of a middleware to validate the Webhook source, with a verifier class that checks the Timestamp and the Signature. <?php declare(strict_types=1); namespace Nrsdb\Middleware; use Laminas\Diactoros\Response\JsonRespons...
Data Structures
ESR ESR Data Structure - refnum (string) - this is made up of a route specific prefix, a three digit incremental counter, plus the two digit year - speed (object) - "Freight Speed / Passenger Speed" - single number if both are same, units and unrest...
Withdrawal
To Withdraw an ESR, a Controller can click on the green, flag button in the toolbar when viewing. This opens a window shown below where the Controller can add notes regarding the withdrawal. It is also possible to specify that the ESR is being replaced by ...