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

PtSituationElement

1: *

Data object for a Public Transport Situation Exchange.

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:
CODESPACE:SituationNumber:ID
e.g.: ABC:SituationNumber:123

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

SituationSource

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:

• open

• closed (the situation is over and traffic has returned to normal)

Please note that when Progress is set to 'closed' the message is considered expired and should not be presented to the public.

element

ValidityPeriod

HalfOpenTimestampRangeStructure

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:

• noImpact

• verySlight

• slight

• normal (default)

• severe

• verySevere

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"
2 - 10 - Urgent, of various priority. Equivalent to DATEX2 urgency level "urgent" with added priority order.

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:

• general (used for public information not impacting the actual operation of the PT-service. eg. "No food service on this journey")

• incident (used for public information impacting the operation of the PT-service. eg. "expect delays due to road construction work") 

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

InfoLinks

0: 1

Link to a website which has further information on the situation.

element

Affects

Affects

1: 1

A description of what the situation affects.

Only allowed to be blank (have no content) when message progress is set to "closed".

element

SourceType

SourceType

1: 1

Information type

Possible values:

• directReport

Required by the format spesification, but not used.

element

StartTime

xsd:dateTime

1: 1

Start time for the period.

element

EndTime

xsd:dateTime

0: 1

End time for the period.

element

InfoLink

InfoLink

1: 1

Link to a website which has further information on the situation.

element

Uri

xsd:anyUri

1: 1

Link to a website which has further information on the situation.

element

Label

NaturalLanguageStringStructure

0: 1

Label for the link.

(choice) element

Networks

AffectedNetwork

1: *

(Can be 0 when Progress = "closed") 

Network with operators and lines affected by the situation.

StopPlaces

AffectedStopPlace

Stops affected by the situation.

StopPoints

AffectedStopPoint

Stops affected by the situation, with the possibility of specifying criteria of situation relevance.

VehicleJourneys

AffectedVehicleJourney

Trips affected by the situation.

element

AffectedOperator

AffectedOperatorStructure

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:

• all

• air

• bus

• coach

• funicular (please note: does not have a corresponding submode)

• metro

• rail

• taxi (please note: does not have a corresponding submode)

• telecabin (mapped to til cableway) (please note: does not have a corresponding submode)

• tram

• water

• selfDrive

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