Darwin:Schedule Element: Difference between revisions
PeterHicks (talk | contribs) Add Darwin Schedule documentation |
PeterHicks (talk | contribs) m PeterHicks moved page Darwin:Schedule to Darwin:Schedule Element without leaving a redirect |
(No difference)
|
Revision as of 16:12, 27 January 2015
Schedule messages
Overview
Darwin provides schedule information when a train is activated, or when new schedule, or changes to an existing schedule are received.
Schedules cover the complete journey of a single train, and are always sent in full. Changes replace any previous version of a schedule that may have been received.
Darwin identifies trains by RID, whereas TRUST identifies trains by a 10-character identity.
Detail
A schedule may be received in two ways:
- Via the Push Port inside inside a uR element, along with a TS element, which initialises the predictions held for this schedule. An association may also be included if this train splits, joins or there is a 'next train' association
- Via the Darwin Timetable
A schedule message comprises of an origin, zero or more intermediate locations and a terminating location.
Example message
<schedule rid="201411200059826" uid="P63461" trainId="2K33" ssd="2014-11-20" toc="LM"> <sc:OR tpl="DORIDGE" act="TB" ptd="13:09" wtd="13:09" /> <sc:PP tpl="BNHTX" wtp="13:11" /> <sc:IP tpl="WDNYMNR" act="T " pta="13:14" ptd="13:14" wta="13:13:30" wtd="13:14" /> <sc:DT tpl="KDRMNST" act="TF" pta="14:10" wta="14:10" /> </schedule>
Location types
Darwin has five types of location, each with a number of attributes:
Tag | Description | act | pta | wta | wtp | ptd | wtd |
---|---|---|---|---|---|---|---|
OR | Origin | Y | Y | Y | |||
PP | Passing point | Y | |||||
IP | Intermediate point (call) | Y | Y | Y | Y | Y | |
OPIP | Operational stop | Y | Y | ||||
DT | Destination | Y | Y | Y |