The Service Interface for Real Time Information - Situation Exchange
Info | ||
---|---|---|
| ||
Current version for SIRI-SX is: v1.1 (last changed ) |
...
Sending of a SIRI-SX ServiceDelivery, data must be in accordance with this profile and the entire dataset should be contained within a single XML file.
Note that the profile does not present an exhaustive list of all real-time information technically possible to transfer via SIRI-SX, but it lays the foundation for which demands are placed on the datasets in order to meet the demands set by Håndbok N801.
It is permitted for client systems to send more than one Situations (PtSituationElement) per SituationExchangeDelivery, in order for real-time information to be conflated and be transferred as part of the same ServiceDelivery.
...
SituationExchangeDelivery < ServiceDelivery | ||||
---|---|---|---|---|
Name | Type | Cardinality | Description | |
attribute | version | xsd:NMTOKEN | 1: 1 | Version ID for SitutaionExhangeDelivery |
element | ResponseTimestamp | xsd:dateTime | 1: 1 | Timestamp for when the dataset was created/published. |
element | Situations | 637370606 | 1: * | Data object for a Public Transport Situation Exchange. |
...
PtSituationElement | ||||
---|---|---|---|---|
Name | Type | Cardinality | Description | |
element | CreationTime | xsd:dateTime | 1: 1 | Timestamp for when the situation was created. |
element | ParticipantRef | ParticipantCode | 1: 1 | Codespace of the data source (see codespace). |
element | SituationNumber | xsd:anyURI | 1: 1 | Unique situation-ID for PtSituationElement. Format: |
element | Version | xsd:integer | 0: 1 | Version-number for the current message. Could be used together with VersionedAtTime to easier track changes over time. |
element | Source | 637370606 | 1: 1 | Information on the source of the message. |
element | VersionedAtTime | xsd:dateTime | 0: 1 | Timestamp when the situation element was updated. |
element | Progress | WorkflowStatusEnumeration | 1: 1 | Status of a situation message. Possible values:
Please note that when Progress is set to 'closed' the message is considered expired and should not be presented to the public. |
element | ValidityPeriod | 637370606 | 1: * | Validity period(s) set with a start time and optionally with an end time. When the end time of the situation is undefined the expiration of the situation is considered unknown until cancellation status for the situation is sent. If the situation has several periods, all but the last period must have an end date. Note that for closed (Progress=closed) messages, the ValidityPeriod must have an EndTime with a minimum of five hours into the future to ensure the message is properly delivered and received by all systems. Once EndTime has expired, the message will no longer be re-distributed in real-time data streams or services. |
element | UndefinedReason | Reason | 1: 1 | Reason should always be <UndefinedReason/>. The field is mandatory due to format specification, but is not used. |
element | Severity | SeverityEnumeration | 0: 1 | How severely the situation affects public transport services. Possible values:
|
element | Priority | xsd:nonNegativeInteger | 0: 1 | Number value from 1 to 10 indicating the priority (urgency) of the situation message. 1 - First (i.e. highest) message priority. Equivalent to DATEX2 urgency level "extremelyUrgent" Left blank (default) is equivalent to DATEX2 urgency level "normal urgency". |
element | ReportType | ReportTypeEnumeration | 1: 1 | Type of situation report. The field is required in order to differentiate general information from incidents. Possible values:
|
element | Planned | xsd:boolean | 0: 1 | Whether the situation in question is due to planned events, or an unexpected incident. |
element | Summary | NaturalLanguageStringStructure | 1: * (Can be 0 when Progress = "closed") | The textual summary of the situation (which is not already described by structured data). One summary per language (if more than one, the xml:lang attribute must be set). Maximum 160 characters (to keep the message readable). |
element | Description | NaturalLanguageStringStructure | 0: * | Expanded textual description (if more than one, the xml:lang attribute must be set) of the situation (do not repeat information from Summary, or structured data). Please do not add advice on how to avoid the situation, as this should be presented in the Advice field. |
element | Advice | NaturalLanguageStringStructure | 0: * | Textual advice (if more than one, the xml:lang attribute must be set) on how a passenger should react/respond to the situation. |
element | InfoLinks | 637370606 | 0: 1 | Link to a website which has further information on the situation. |
element | Affects | 637370606 | 1: 1 | A description of what the situation affects. Only allowed to be blank (have no content) when message progress is set to "closed". |
...
AffectedNetwork | ||||
---|---|---|---|---|
Name | Type | Cardinality | Description | |
element | AffectedOperator | 637370606 | 0: 1 | Reference to the affected operator. |
element | NetworkRef | xsd:NMTOKEN | 1: 1 | Reference to affected Network. |
element | VehicleMode | VehicleModesOfTransportEnumeration | 0: 1 | Affected modality. Possible values:
Modes must be specified together with corresponding submode (when applicable), whenever the situation does not affect all modalities in the affected planned data. |
(choice) element | AirSubmode | AirSubmodesOfTransportEnumeration | 0: 1 | Possible values:
|
BusSubmode | BusSubmodesOfTransportEnumeration | Possible values:
| ||
Coach | CoachSubmodesOfTransportEnumeration | Possible values:
| ||
MetroSubmode | MetroSubmodesOfTransportEnumeration | Possible values:
| ||
RailSubmode | RailSubmodesOfTransportEnumeration | Possible values:
| ||
TramSubmode | TramSubmodesOfTransportEnumeration | Possible values:
| ||
WaterSubmode | WaterSubmodesOfTransportEnumeration | Possible values:
| ||
(choice) element | AffectedLine | 637370606 | 1: * | Reference(s) to affected line(s). Must be stated explicitly AffectedLine or AllLines due to technical demands on the element in the SIRI standard. |
AllLines | xsd:string (empty) | 1: 1 |
...
AffectedLineStructure | ||||
---|---|---|---|---|
Name | Type | Cardinality | Description | |
element | LineRef | xsd:NMTOKEN | 1: 1 | Reference to Line in question (ID to the corresponding object in the timetable data). |
element | Routes | 637370606 | 0: * | Reference to Route(s) in question (ID to the corresponding object in the timetable data), when the situation does not apply to the entire Line. |
element | Sections | SIRI-SX#AffectedSection | 0: * |
...
AffectedRouteStructure | ||||
---|---|---|---|---|
Name | Type | Cardinality | Description | |
element | AffectedRoute | 637370606 | 1: 1 | Reference to Route in question (ID to the corresponding object in the timetable data). |
AffectedRouteStructure
Info |
---|
Information about an affected Route |
...
AffectedRouteStructure | ||||
---|---|---|---|---|
Name | Type | Cardinality | Description | |
element | RouteRef | xsd:NMTOKEN | 0: 1 | Reference to Route in question (ID to the corresponding object in the timetable data). |
choice (element) | StopPoints | 637370606 | 0: * | Reference to affected stop(s) in the affected Line. |
Sections | SIRI-SX#AffectedSection | 0: * | Reference to affected section(s) in the affected Line/Journey. |
...
AffectedSection | ||||
---|---|---|---|---|
Name | Type | Cardinality | Description | |
element | AffectedSection | 637370606 | 1: * | Reference to Route in question (ID to the corresponding object in the timetable data). |
AffectedSectionStructure
Info |
---|
Information about an affected Section |
...
AffectedStopPoint | ||||
---|---|---|---|---|
Name | Type | Cardinality | Description | |
element | StopPointRef | xsd:NMTOKEN | 1: 1 | Reference to the Quay in question (ID corresponding to objects in the national stop place registry). If the quay is currently unknown, or the message applies to all quays, a reference to StopPlace may be used instead. |
element | StopPointName | NaturalLanguageStringStructure | 0: 1 | Name of StopPlace (Not used, but may be set to increase human readability.) |
element | StopCondition | RoutePointTypeEnumeration | 0: * | Specifies which passengers the message applies to, for example, people who are disembarking at an affected stop. Possible values:
If this field is left blank or omitted the message will be interpreted as affecting boarding and alighting. |
...
AffectedStopPlace | ||||
---|---|---|---|---|
Name | Type | Cardinality | Description | |
element | AccessibilityAssessment | 637370606 | 0: 1 | Specifies whether the object is still available for users with special needs. |
element | StopPlaceRef | xsd:NMTOKEN | 1: 1 | Reference to StopPlace or specific Quay (ID corresponding to objects in the national stop place registry). |
element | PlaceName | NaturalLanguageStringStructure | 0: 1 | Name of the stop (not used due to the reference to the national stop place registry, but can be included to make the XML easier to read). |
element | AffectedComponents | 637370606 | 0: * | Reference(s) to which part(s) of the stop(s) are being affected. |
...
AffectedComponent | ||||
---|---|---|---|---|
Name | Type | Cardinality | Description | |
element | ComponentRef | xsd:NMTOKEN | 0: 1 | Reference to the Quay in question (ID corresponding to objects in the national stop place registry). Used if ComponentType is "quay" |
element | ComponentType | ifopt:StopPlaceComponentTypeEnumeration | 1: 1 | Possible values:
|
element | AccessFeatureType | ifopt:AccessibilityFeatureEnumeration | 0: 1 | Possible values:
Used when it necessary to specify limitations for users with special mobility needs. |
...
AffectedVehicleJourney | ||||
---|---|---|---|---|
Name | Type | Cardinality | Description | |
(choice) element | VehicleJourneyRef | xsd:NMTOKEN | 1: 1 | Reference to affected VehicleJourney (ID to the corresponding object in the timetable data). |
DatedVehicleJourneyRef | xsd:NMTOKEN | Reference to affected DatedVehicleJourney (ID to the corresponding object in the timetable data). | ||
FramedVehicleJourneyRef | FramedVehicleJourneyRefStructure | Reference with date to affected VehicleJourney (ID to the corresponding object in the timetable data). | ||
element | Operator | 637370606 | 0: 1 | Reference to affected Operator (ID to the corresponding object in the timetable data). Not used, but may be set to increase human readability. |
element | LineRef | xsd:NMTOKEN | 0: 1 | Reference to affected Line (ID to the corresponding object in the timetable data). Not used, but may be set to increase human readability. |
element | Route | 637370606 | 1: * | Reference to affected Route(s) (ID to the corresponding object in the timetable data). Mandatory field (due to format implementation), but can be blank if the situation affects all stops in AffectedVehicleJourney. |
element | OriginAimedDepartureTime | xsd:dateTime | 0: 1 | Originally planned departure time (per time table) from the first stop of the departure. |
...