timetable
Current version for timetable is: v1.5 (last changed Jul 28, 2022)
Content
- 1 Components
- 1.1 Journey
- 1.1.1 Journey
- 1.1.2 JourneyEndpointStructure
- 1.2 Types of journey
- 1.2.1 VehicleJourney
- 1.2.1.1 JourneyPart
- 1.2.1.2 Frequency
- 1.2.1.3 VehicleJourneyWaitTime
- 1.2.1.4 VehicleJourneyRunTime
- 1.2.1.5 VehicleJourneyHeadway
- 1.2.1.6 TimetabledPassingTime
- 1.2.2 ServiceJourney
- 1.2.2.1 TrainNumber
- 1.2.2.2 FlexibleServiceProperties
- 1.2.3 DatedServiceJourney
- 1.2.4 DeadRun
- 1.2.5 Periodical journeys
- 1.2.5.1 TemplateVehicleJourney
- 1.2.5.2 TemplateServiceJourney
- 1.2.5.3 JourneyFrequencyGroup
- 1.2.5.4 RhythmicalJourneyGroup
- 1.2.5.5 HeadwayJourneyGroup
- 1.2.6 Coupled journeys
- 1.2.6.1 CoupledJourney
- 1.2.6.2 JourneyPartCouple
- 1.2.1 VehicleJourney
- 1.3 ServiceCalendar
- 1.4 Interchange
- 1.4.1 Interchange across datasets
- 1.4.2 Interchange
- 1.4.3 ServiceJourneyInterchange
- 1.1 Journey
This document is part of NeTEx Norwegian Profile and describes data elements used for calendar data and planned timetables data exchange in the NeTEx format.
Note that the timetable-part of the profile describes elements for constructing time plans or time tables (dates, times, frequencies etc.) to be used in exchanging data between different systems, and representation of this information to travellers, based on the superordinate concept from the network-profile document.
Components
Journey
Journey
An abstract type which describes a departure/journey.
See definition under General information
Examples in the GitHub-repository (replacement transport)
Journey < LinkSequence < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
Description | 0: 1 | Description of the departure | |
TransportMode | AllVehicleModesOfTransportEnumeration | 0: 1 | Transport mode, see Mode in Transport Modes for possible values (with accompanying submodes). Note that when overriding the mode for a Journey, both TransportMode and TransportSubmode must be specified. |
TransportSubmode | TransportSubmode | 0: 1 | Transport submode See Submode in Transport Modes for possible values (must be a submode of specified TransportMode) Note that when overriding the mode for a Journey, both TransportMode and TransportSubmode must be specified. |
ExternalVehicleJourneyRef | ExternalObjectRef | 0: 1 | Reference (ID) to original ServiceJourney when specifying replacement traffic. Note that replaced ServiceJourneys (if ID is referred to by ExternalVehicleJourneyRef) must also be part of the dataset (even in cases of partial delivery) to ensure the validity of the reference. |
Monitored | xsd:boolean | 0: 1 | Specifies whether real-time information is available for the departure. |
JourneyEndpointStructure
Description of the beginning,- or the destination of a VehicleJourney
JourneyEndpointStructure | |||
---|---|---|---|
Name | Type | Cardinality | Description |
Name | 0: 1 | Name | |
ScheduledStopPointRef | ScheduledStopPointRef | 0: 1 | Reference to ScheduledStopPoint |
DestinationDisplayRef | DestinationDisplayRef | 0: 1 | Reference to DestinationDisplay |
Types of journey
VehicleJourney
VehicleJourney < Journey < LinkSequence < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
PrivateCode | xsd:normalizedString | 0: 1 | Internal code (non-public identifier) for the journey (e.g. train- or trip number from the planners' tool) |
DepartureTime | xsd:time | 0: 1 | Time of departure for the journey. |
Frequency | 0: 1 | Frequency or interval for departures. Used only for frequency-based departures. | |
JourneyDuration | xsd:duration | 0: 1 | The total duration of the journey. |
RouteRef | RouteRef | 0: 1 | Reference to Route (not mandatory for ServiceJourney, as this can be derived from JourneyPatternRef) |
PublicCode | xsd:normalizedString | 0: 1 | Public code or identifier for the journey Used only when for example the line number is changed per trip or has extraordinary overrides. |
waitTimes | 0: * | Description of wait times at TimingPoints Normally used only when describing frequency-based departures. | |
runTimes | 0: * | Description of run times between TimingPoints Normally used only when describing frequency-based departures. | |
passingTimes | 1: * | Description of planned passing times at StopPoints or TimingPoints | |
parts | 0: * | List of the parts of the journey. Used in special cases such as combined journeys. |
JourneyPart
JourneyPart < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
Description | 0: 1 | Description | |
MainPartRef | JourneyPartCoupleRef | 1: 1 | Reference to the main part of the journey |
JourneyPartCoupleRef | JourneyPartCoupleRef | 0: 1 | Reference to CoupledJourney to which this journey part belongs. |
TrainNumberRef | TrainNumberRef | 0: 1 | Reference to TrainNumber for the journey part |
FromStopPointRef | ScheduledStopPointRef | 0: 1 | The starting point for the journey part (ScheduledStopPoint) |
ToStopPointRef | ScheduledStopPointRef | 0: 1 | The destination for the journey part (ScheduledStopPoint) |
StartTime | xsd:time | 1: 1 | Start-time |
EndTime | xsd:time | 1: 1 | End-time |
Frequency
Frequency < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
ScheduledHeadwayInterval | xsd:duration | 1: 1 | Planned departure interval |
MinimumHeadwayInterval | xsd:duration | 0: 1 | Minimum departure interval |
MaximumHeadwayInterval | xsd:duration | 0: 1 | Maximum departure interval |
Description | 0: 1 | Description, for example, "every 15 minutes" |
VehicleJourneyWaitTime
VehicleJourneyWaitTime < JourneyWaitTime < JourneyTiming < VersionedChild < EntityInVersion < Entity | |||
---|---|---|---|
Name | Type | Cardinality | Description |
VehicleJourneyRef | VehicleJourneyRef | 0: 1 | Reference to VehicleJourney |
VehicleJourneyRunTime
VehicleJourneyRunTime < JourneyRuntime < JourneyTiming < VersionedChild < EntityInVersion < Entity | |||
---|---|---|---|
Name | Type | Cardinality | Description |
VehicleJourneyRef | VehicleJourneyRef | 0: 1 | Reference to VehicleJourney |
VehicleJourneyHeadway
VehicleJourneyHeadway < JourneyHeadway < JourneyTiming < VersionedChild < EntityInVersion < Entity | |||
---|---|---|---|
Name | Type | Cardinality | Description |
VehicleJourneyRef | VehicleJourneyRef | 0: 1 | Reference to VehicleJourney |
TimetabledPassingTime
ALTERNATIVE 1: Ordinary timetable for planned journeys
TimetabledPassingTime < PassingTime < VersionedChild < EntityInVersion < Entity | ||||
---|---|---|---|---|
| Name | Type | Cardinality | Description |
attr | id | ObjectIdType | 1: 1 | Unique id for the object Mandatory attribute |
attr | version | VersionIdType | 1: 1 | Version number Mandatory attribute |
elem | PointInJourneyPatternRef | PointInJourneyPatternRef | 1: 1 | Reference to PointInJourneyPattern (the point being served/passed by the vehicle) |
elem (choice) | ArrivalTime ArrivalDayOffset | xsd:time DayOffsetType (xsd:integer) | 1: 1 0: 1 | Planned arrival time (if relevant, both ArrivalTime and DepartureTime may be specified) ArrivalOffset relative to the OperatingDay / Date for the affected VehicleJourney(s), e.g. "-1" (previous day) or "1" (next day) |
DepartureTime DepartureDayOffset | xsd:time DayOffsetType (xsd:integer) | 1: 1 0: 1 | Planned departure time (if relevant, both ArrivalTime and DepartureTime may be specified) DepartureOffset relative to the OperatingDay / Date for the affected VehicleJourney(s), e.g. "-1" (previous day) or "1" (next day) | |
elem | WaitingTime | xsd:duration | 0: 1 | Planned waiting time at a Point |
ALTERNATIVE 2: On demand transport/FlexibleLines including hail and ride
TimetabledPassingTime < PassingTime < VersionedChild < EntityInVersion < Entity | ||||
---|---|---|---|---|
| Name | Type | Cardinality | Description |
attr | id | ObjectIdType | 1: 1 | Unique id for the object Mandatory attribute |
attr | version | VersionIdType | 1: 1 | Version number Mandatory attribute |
elem | PointInJourneyPatternRef | PointInJourneyPatternRef | 1: 1 | Reference to PointInJourneyPattern (the point being served/passed by the vehicle) |
elem | WaitingTime | xsd:duration | 0: 1 | Planned waiting time at a Point |
elem | LatestArrivalTime | xsd:time | 1: 1 | Latest possible (planned) arrival time (if relevant, both LatestArrivalTime and EarliestDepartureTime may be specified) |
elem | LatestArrivalDayOffset | DayOffsetType (xsd:integer) | 0: 1 | Number of days of arrival relative to the journey start day (only used when journey spans more than one calendar day) ArrivalOffset relative to the OperatingDay/Date for the affected VehicleJourney(s), e.g. "-1" (previous day) or "1" (next day) |
elem | EarliestDepartureTime | xsd:time | 1: 1 | Earliest possible departure time (if relevant, both LatestArrivalTime and EarliestDepartureTime may be specified) |
elem | EarliestDepartureDayOffset | DayOffsetType (xsd:integer) | 0: 1 | Number of days of arrival relative to the journey start day (only used when journey spans more than one calendar day) DepartureOffset relative to the OperatingDay/Date for the affected VehicleJourney(s), e.g. "-1" (previous day) or "1" (next day) |
ServiceJourney
ServiceJourney < VehicleJourney < Journey < LinkSequence < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
ServiceAlteration | ServiceAlterationEnumeration | 0: 1 | Journey type:
|
DepartureTime | xsd:time | 0: 1 | Departure time |
Frequency | 0: 1 | Frequency or interval for departures. Used only for frequency-based departures. | |
JourneyDuration | xsd:duration | 0: 1 | Duration of the journey |
dayTypes | DayTypeRef | 1: * | References to DayTypes |
JourneyPatternRef | JourneyPatternRef | 1: 1 | Reference to JourneyPattern |
JourneyFrequencyGroupRef | JourneyFrequencyGroupRef | 0: 1 | Reference to JourneyFrequencyGroup |
VehicleTypeRef | VehicleTypeRef | 0: 1 | Reference to VehicleType |
OperatorRef | OperatorRef | 0: 1 | Reference to Operator |
trainNumbers | TrainNumberRef | 0: * | References to TrainNumber |
passingTimes | 1: * | Planned passing times | |
parts | 0: * | List of parts of the journey (used in special cases, such as combined journeys) To make re-use of journey parts possible, these must be defined separately (as independent objects, referred to from here). | |
checkConstraints | 0: * | Information about security checks, barriers etc. which may cause delays. | |
TrainSize | 0: 1 | Information about the size and structure of a train | |
FlexibleServiceProperties | 0: 1 | Properties for flexible (on demand) transport. It is possible to define properties here if they deviate from the flexible service properties set at the Line-level. |
TrainNumber
TrainNumber < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
ForAdvertisement | xsd:normalizedString | 0: 1 | Train number to use for advertisement to public if different from ID. |
ForProduction | xsd:normalizedString | 0: 1 | Train number to use for production purposes, for instance towards technical systems that require an odd or even value according to safety regulations, if different from ID. |
FlexibleServiceProperties
FlexibleServiceProperties < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
FlexibleServiceType | FlexibleServiceTypeEnumeration | 0: 1 | Type of flexible transport:
|
CancellationPossible | xsd:boolean | 0: 1 | Specifies whether a service may be cancelled by the operator |
ChangeOfTimePossible | xsd:boolean | 0: 1 | Specifies whether times may be changed by the operator |
BookingContact | 0: 1 | Contact information to book the on-demand service | |
BookingMethods | BookingMethodListOfEnumerations | 0: 1 | Possible methods for booking the on-demand service:
|
BookingAccess | BookingAccessEnumeration | 0: 1 | Who may place an order (book the on-demand service):
|
BookWhen | PurchaseWhenEnumeration | 0: 1 | Time constraints for booking:
It is recommended to set this field if MinimumBookingPeriod is not specified |
BuyWhen | PurchaseMomentListOfEnumerations | 0: 1 | Time constraints for payment:
|
LatestBookingTime | xsd:time | 0: 1 | Latest possible time for booking Do not set if BookWhen is undefined or defined as “timeOfTravelOnly” (would be invalid) |
MinimumBookingPeriod | xsd:duration | 0: 1 | The minimum time ahead of journey departure the booking must be completed Can only be set (optionally) if BookWhen is undefined |
BookingNote | xsd:normalizedString | 0: 1 | Additional information about the booking |
DatedServiceJourney
DatedServiceJourney < ServiceJourney < VehicleJourney < Journey < LinkSequence < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
ServiceJourneyRef | ServiceJourneyRef | 1: 1 | Reference to the generic ServiceJourney from which journey details e.g. JourneyPatternRef and passingTimes is derived |
DatedServiceJourneyRef | DatedServiceJourneyRef | 0: * | (List of) Related DatedServiceJourneys Used to maintain link back to previously defined DatedServiceJourneys with ServiceAlteration “replaced” for the same OperatingDay |
OperatingDayRef | OperatingDayRef | 1: 1 | OperatingDay for DatedServiceJourney, which defines the date this service runs |
DeadRun
DeadRun < VehicleJourney < Journey < LinkSequence < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
Frequency | 0: 1 | Frequency/interval for departures Used only for frequency-based departures. | |
dayTypes | DayTypeRef | 1: * | References to DayTypes |
JourneyPatternRef | JourneyPatternRef | 1: 1 | References to JourneyPattern Note, that for JourneyPatterns used exclusively by DeadRuns, it is permitted to define ScheduledStopPoints which are not linked to a Place (i.e. StopAssignment is not defined), when these ScheduledStopPoints do not exist in the stop place registry (e.g. vehicle garages, workshops, rest areas) |
JourneyFrequencyGroupRef | JourneyFrequencyGroupRef | 0: 1 | Reference to JourneyFrequencyGroup |
VehicleTypeRef | VehicleTypeRef | 0: 1 | Reference to VehicleType |
passingTimes | 0: * | Planned passing times | |
OperatorRef | OperatorRef | 0: 1 | Reference to Operator |
DeadRunType | DeadRunTypeEnumeration | 0: 1 | Classification of DeadRun (if relevant):
|
Periodical journeys
TemplateVehicleJourney
TemplateServiceJourney < TemplateVehicleJourney < ServiceJourney < Journey < LinkSequence < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
frequencyGroups | (choice) RhytmicalJourneyGroup (choice) HeadwayJourneyGroup (choice) RhytmicalJourneyGroupRef (choice) HeadwayJourneyGroupRef | 1: * | RhythmicalJourneyGroup or HeadwayJourneyGroup, or reference to a template which applies to this pattern. |
TemplateServiceJourney
TemplateServiceJourney < TemplateVehicleJourney < ServiceJourney < Journey < LinkSequence < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
TemplateServiceJourney inherits from TemplateVehicleJourney and does not introduce new elements or attributes. |
JourneyFrequencyGroup
JourneyFrequencyGroup < GroupOfEntities < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
FirstDepartureTime | xsd:time | 1: 1 | Departure time for the first stop in the first departure in the frequency group. |
LastDepartureTime | xsd:time | 1: 1 | Departure time for the first stop in the last departure in the frequency group. |
DayOffset | xsd:integer | 0: 1 | Number of days from the starting point (when service period spans more than one calendar day) Offset is relative to the OperatingDay / Date for the affected VehicleJourney(s), e.g. "-1" (previous day) or "1" (next day) |
journeys | VehicleJourneyRef | 0: * | List of journeys in a JourneyFrequencyGroup. Lists only ServiceJourneyRef objects. |
RhythmicalJourneyGroup
RhythmicalJourneyGroup < JourneyFrequencyGroup < GroupOfEntities < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
timebands | 1: * | Reference to a Timeband-object which describes the departure time for ServiceJourney as minutes over a full hour. In the context of RhythmicalJourneyGroup, Timeband must have identical StartTime and EndTime and show the departure time as minutes over a full hour. Use "00:..." for generic time representation. |
HeadwayJourneyGroup
HeadwayJourneyGroup < JourneyFrequencyGroup < GroupOfEntities < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
ScheduledHeadwayInterval | xsd:duration | 1: 1 | The planned interval between departures |
MinimumHeadwayInterval | xsd:duration | 0: 1 | The minimum interval between departures |
MaximumHeadwayInterval | xsd:duration | 0: 1 | The maximum interval between departures |
Description | 0: 1 | Description (for example: "every 15 minutes") |
Coupled journeys
CoupledJourney
CoupledJourney < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
Description | 0: 1 | Description | |
journeys | VehicleJourneyRef | 0: * | List of VehicleJourneys in the coupled journey. |
JourneyPartCouple
JourneyPartCouple < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
Description | 0: 1 | Description of journey part coupling | |
StartTime | xsd:time | 1: 1 | Starting time for the coupled journey part(s) |
EndTime | xsd:time | 1: 1 | End time for the coupled journey part(s) |
FromStopPointRef | ScheduledStopPointRef | 1: 1 | Planned first stop for the journey part coupling (ScheduledStopPoint) |
ToStopPointRef | ScheduledStopPointRef | 1: 1 | Planned last stop for the journey part coupling (ScheduledStopPoint) |
MainPartRef | JourneyPartRef | 1: 1 | The main part of the coupled journey (relevant for travel information to the public) |
journeyParts | JourneyPartRef | 0: 1 | Remaining parts of a coupled journey (excl. MainPartRef) |
TrainNumberRef | TrainNumberRef | 0: 1 | Reference to TrainNumber for the coupled journey part(s) |
ServiceCalendar
ServiceCalendar < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
Name | 0: 1 | Name of calendar | |
FromDate | xsd:date | 1: 1 | Calendar start date |
ToDate | xsd:date | 1: 1 | Calendar end date |
EarliestTime | xsd:time | 0: 1 | Start time for the day can be defined in cases where it differs from the normal 00:00:00. |
DayLength | xsd:duration | 0: 1 | Length of the day can be defined in cases where it differs from the normal 24 hours. |
dayTypes | 0: * | DayTypes used in a calendar May be defined directly in ServiceCalendarFrame | |
timebands | 0: * | Timebands used in a calendar May be defined directly in ServiceCalendarFrame | |
operatingDays | 0: * | OperatingDays used in a calendar May be defined directly in ServiceCalendarFrame | |
operatingPeriods | 0: * | OperatingPeriods used in a calendar May be defined directly in ServiceCalendarFrame | |
dayTypeAssignments | 0: * | Linking of DayTypes to OperatingDays May be defined directly in ServiceCalendarFrame |
Interchange
Interchange
Interchange < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
Priority | xsd:integer | 0: 1 | Weighted prioritization of transfers, e.g. when there are multiple possible interchange locations along a journey, or when there is a need to mark a location as inappropriate for interchanges:
Corresponds to Weighting (InterchangeWeightingEnumeration) for StopPlace |
StaySeated | xsd:boolean | 0: 1 | Specifies that the traveller can remain seated in the vehicle, as it will be re-used for the next part of the journey. Useful when describing Lines that operate in a circular pattern (prevents fictitious interchanges), and also implies that the interchange is de facto guaranteed (i.e. does not require Guaranteed = “true” to be set). |
Guaranteed | xsd:boolean | 0: 1 | Specifies whether the interchange is guaranteed (the passenger is guaranteed the transfer between the two journeys). |
MaximumWaitTime | xsd:duration | 0: 1 | Maximum time (after normal departure time) the connecting transport allows for delays. If this value is not set for an Interchange with Guaranteed ‘true’, it should be assumed that the consumer service will wait for the feeder service regardless of delay. |
ServiceJourneyInterchange
ServiceJourneyInterchange < Interchange < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
FromPointRef | ScheduledStopPointRef | 1: 1 | Reference to stop where passenger begins transfer/interchange (arriving vehicle location) Stop point for the interchange feeder journey |
ToPointRef | ScheduledStopPointRef | 1: 1 | Reference to stop where passenger continues the journey from (departing vehicle location) Stop point for the interchange consumer/distributor journey |
FromJourneyRef | VehicleJourneyRef | 1: 1 | Reference to the journey the passenger transfers from (VehicleJourney) Interchange feeder journey |
ToJourneyRef | VehicleJourneyRef | 1: 1 | Reference to the journey the passenger transfers to (VehicleJourney) Interchange consumer/distributor journey |