Current version for network is: v1.4 (last changed )
Content
This document is part of the Norwegian NeTEx profile and describes data elements related to transport networks used for public transport data exchange in the NeTEx format.
Please note the network part of the profile describes structures, attributes, and geospatial objects, which make up the framework of the timetable data. It does not, however, describe time-related concepts, such as departure times, or operational days. All of these are described in timetable.
Components
Network components
Network
A transport network is an "umbrella" structure for all Lines which share relevant features, such as the ownership of the lines.
If necessary, these can be separated further as GroupOfLines (see below), a supplementary (optional) level of logical structuring within the overall Network of Lines.
See definition under General information
Defined in ServiceFrame
Examples in the GitHub-repository (including use of additionalNetworks)
Network < GroupOfLines < GroupOfEntities < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
Name | 1: 1 | Name of the network. | |
AuthorityRef | OrganisationRefStructure | 1: 1 | Organisation responsible (for example owner) for the network. |
groupsOfLines | 0: * | Lines (Line) included in the network. | |
tariffZones | tariffZoneRefs | 0: * | Tariff zones (TariffZone) in the network (when relevant). |
GroupOfLines
Additional (optional) grouping of lines.
See definition under General information
Defined in ServiceFrame
GroupOfLines < GroupOfEntities < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
Name | 1: 1 | Group name | |
members | lineRefs | 0: 1 | An explicit listing of lines included in the group (if appropriate) Note that reference should link from Line up to Network through a RepresentedByGroupRef |
MainLineRef | LineRefStructure | 0: 1 | Reference to the primary line in the group. |
TransportMode | AllVehicleModesOfTransportEnumeration | 0: 1 | The transport mode of the group. See Transport Modes for possible values |
Line
Line (grouping of Routes) with a name or number (PublicCode).
See definition under General information
Defined in ServiceFrame
Examples in the GitHub-repository
Line < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
(attr) modification | xs:ModificationEnumeration | 0: 1 | Type of modification (use "delete" when a Line is permanently discontinued) |
Name | 1: 1 | Name of the line | |
ShortName | 0: 1 | Short name (e.g. short version of commonly (publicly) known name) | |
Description | 0: 1 | Description | |
TransportMode | AllVehicleModesOfTransportEnumeration | 1: 1 | See Mode in Transport Modes for valid values |
TransportSubmode | TransportSubmode | 1: 1 | See Submodes in Transport Modes for valid values (must be a TransportSubmode belonging to the selected TransportMode) |
Url | xsd:anyURI | 0: 1 | URL to a website with information about the line. |
PublicCode | xsd:normalizedString | 0: 1 | The publicly advertised line number, or code of the line. Usually a number, or a number combined with a letter (eg L2, 31, 30E etc.). The Name field normally contains more information than the PublicCode, and is often the combination of PublicCode + Name. |
PrivateCode | xsd:normalizedString | 0: 1 | Internal (non-public) identifier for the line. For example, a code used by transport planners. |
ExternalLineRef | ExternalObjectRef | 0: 1 | Reference (ID) to a related Line (for example, the regular line for which this is a replacement). |
OperatorRef | OperatorRefStructure | 1: 1 | Reference to the main operator (may be omitted in exceptional cases, such as a different operator for every departure). |
additionalOperators | transportOrganisationRef | 0: * | Reference to additional operators of the line |
TypeOfLineRef | TypeOfLineRef | 0: 1 | Reference to the line type. Classification, (e.g. replacement line) |
Monitored | xsd:boolean | 0: 1 | Specifies whether real-time information normally is available for this line (set to |
routes | RouteRef | 0: * | Reference to a listing of all routes (Route) which are part of the line. The references can normally be deduced from Line references in Routes. Therefore this field is only relevant in exceptional cases). |
RepresentedByGroupRef | GroupOfLinesRefStructure | 1: 1 | Reference to the Lines' Network (alternatively a more specific reference to the GroupOfLines). |
Presentation | 0: 1 | Graphical representation information (colour, text, etc.) | |
AccessibilityAssessment | 0: 1 | Universal Design - Description of the line |
Presentation
Description of values used for presenting line information, such as fonts and colours, etc. which may be used on graphical representations of the line, such as maps or printed publications.
It is required to fill out at least one field (of the ones listed below) in order to have a valid Presentation. The default values are white (FFFFFF) Colour with black TextColour (000000).
Examples in the GitHub-repository
Presentation | |||
---|---|---|---|
Name | Type | Cardinality | Description |
Colour | ColourValueType | 0: 1 | Six digit hexadecimal representation of the lines' RGB colour values. |
TextColour | ColourValueType | 0: 1 | Six digit hexadecimal representation of the lines' RGB colour values. |
TextFont | xsd:normalizedString | 0: 1 | Font identifier (font). Normally not specified. |
Service
TypeOfService
TypeOfService < TypeOfValue < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
TypeOfService inherits fromTypeOfValue and does not introduce new elements or attributes. |
Route
Route
Description of a route, specified as a sorted list of RoutePoints.
See definition under General information
Defined in ServiceFrame
Examples in the GitHub-repository
Route < LinkSequence < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
LineRef | LineRefStructure | 1: 1 | Reference to Line (Line) to which the Route belongs. |
DirectionType | DirectionTypeEnumeration | 0: 1 | The direction of the route:
To be able to identify full- or partial circular routes clockwise/anticlockwise must be specified. |
pointsInSequence | 1: * | List of the routes points | |
InverseRouteRef | RouteRefStructure | 0: 1 | Reference to any route that goes in the opposite direction |
RoutePoint
A point that is a stop place in a route.
See definition under General information
Defined in ServiceFrame
Examples in the GitHub-repository
RoutePoint < Point < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
BorderCrossing | xsd:boolean | 0: 1 | Specifies whether the point is on the border between two countries. |
ScheduledStopPoint
Point for planned disembarking and/or boarding. Linking to StopPlaces/Quays is done through StopAssignment. All ScheduledStopPoint must have such a link.
See definition under General information
Defined in ServiceFrame
Examples in the GitHub-repository
ScheduledStopPoint < TimingPoint < Point < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
TimingPointStatus | TimingPointStatusEnumeration | 0: 1 | Type of TimingPoint:
|
tariffZones | TariffZoneRef | 0: 1 | List of TariffZones (TariffZone) the StopPoint belongs to Not recommended to use, as this may be overridden by TariffZone / FareZone geography specified in the SiteFrame. |
Presentation | 0: 1 | Graphical elements related to StopPoint |
TimingPoint
Point for registering passing times. Usually, not a place where the vehicle stops, nor a place relevant to passengers, though it can be used to indicate places where the vehicle waits.
See definition under General information
Defined in ServiceFrame
TimingPoint < Point < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
TimingPointStatus | TimingPointStatusEnumeration | 0: 1 | Type of TimingPoint:
|
AllowedForWaitTime | xsd:duration | 0: 1 | Allowed waiting time at the TimingPoint. |
PointOnRoute
Link between Route and RoutePoint.
See definition under General information
Examples in the GitHub-repository
PointOnRoute < PointInLinkSequence < VersionedChild < EntityInVersion < Entity | |||
---|---|---|---|
Name | Type | Cardinality | Description |
LinkSequenceRef | LinkSequenceRefStructure | 0: 1 | Reference to LinkSequence to which the point belongs. RouteRef should be used since Route inherits from LinkSequence. Note that the field should not be used if PointOnRoute is defined inline in Route. |
projections | 0: * | Projection on a point (RoutePoint, TimingPoint, SchedueledStopPoint) or a GML-coordinate projection. | |
PointRef | PointRefStructure | 1: 1 | Reference to Point RoutePointRef should be used to point to the corresponding RoutePoint. |
RouteLink
Link (with direction) between two RoutePoints.
See definition under General information
Defined in ServiceFrame
RouteLink < Link < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
FromPointRef | RoutePointRef | 1: 1 | The start point for the RouteLink |
ToPointRef | RoutePointRef | 1: 1 | The endpoint for the RouteLink |
ServiceLink
Link (with direction) between two stop points.
See definition under General information
Defined in ServiceFrame
ServiceLink < Link < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
Distance | xsd:decimal | 0: 1 | Distance in meters for ServiceLink, i.e. driving distance between FromPoint and ToPoint. |
projections | 0: 1 | Projection with <gml:LineString> indication of position. | |
FromPointRef | ScheduledStopPointRef | 1: 1 | The start point for the ServiceLink. |
ToPointRef | ScheduledStopPointRef | 1: 1 | The endpoint for ServiceLink. |
Connection
SiteConnection
Description of the navigation possibility between two Sites, for example between two StopPlaces, or two Quays.
SiteConnection < Transfer < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
From | 1: 1 | The starting point for SiteConnection | |
To | 1: 1 | The endpoint for SiteConnection | |
navigationPaths | 0: * | Possible path links between Site-objects |
SiteConnectionEndStructure
SiteConnectionEnd | |||
---|---|---|---|
Name | Type | Cardinality | Description |
StopPlaceRef | StopPlaceRef | 0: 1 | Reference to the StopPlace in question |
QuayRef | QuayRef | 0: 1 | Reference to the Quay in question |
StopPlaceEntranceRef | StopPlaceEntranceRef | 0: 1 | Reference to the Entrance in question |
Stop Assignment
StopAssignment
Abstract class used to describe the link between ScheduledStopPoint and StopPlace.
StopAssignment < Assignment < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
ScheduledStopPointRef | ScheduledStopPointRef | 1: 1 | Reference to ScheduledStopPoint |
PassengerStopAssignment
Link between ScheduledStopPoint and StopPlace or Quay
Examples in the GitHub-repository
Defined in ServiceFrame
PassengerStopAssignment < StopAssignment < Assignment < DataManagedObject | ||||
---|---|---|---|---|
Name | Type | Cardinality | Description | |
elem | StopPlaceRef | StopPlaceRef | 0: 1 | Reference to StopPlace which is related to ScheduledStopPoint Acts only as supplementary information, as the StopPlace can always be derived (in the National Stop Registry) through its mandatory referenced Quay (QuayRef). |
elem | QuayRef | QuayRef | 1: 1 | |
elem | trainElements | TrainStopAssignmentRef | 0: * | References to a detailed position on platform (TrainStopAssignment) Used only for trains |
attr | order | xsd:integer | 1: 1 | The Assignment order. The "order" attribute is inherited from the more generic type Assignment, but in the case of a PassengerStopAssignment its business meaning is undefined. It is however mandatory due to an XML schema validation constraint.
|
FlexibleStopAssignment
Link between ScheduledStopPoint and FlexibleStopPlace.
Defined in ServiceFrame (the same way as PassengerStopAssignment)
FlexibleStopAssignment < StopAssignment < Assignment < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
FlexibleStopPlaceRef | FlexibleStopPlaceRef | 1: 1 | Reference to FlexibleStopPlace which is related to ScheduledStopPoint |
(choice) FlexibleQuayRef | FlexibleQuayRef | 0: 1 | Reference to a FlexibleQuay. Can be added in a supplementary role if a FlexibleQuay is used. |
(choice) FlexibleAreaRef | FlexibleAreaRef | 0: 1 | Reference to an actual FlexibleArea Can be added in a supplementary role if a FlexibleArea is defined for the FlexibleStopPlace. |
(choice) HailAndRideAreaRef | HailAndRideAreaRef | 0: 1 | Reference to an actual HailAndRideArea Can be added in a supplementary role if a HailAndRideArea is defined for the FlexibleStopPlace. |
TrainStopAssignment
Link between TrainComponent (train cars) and StopPlace/Quay/BoardingPosition.
See definition under General information
Defined in ServiceFrame
TrainStopAssignment < StopAssignment < Assignment < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
PassengerStopAssignmentRef | PassengerStopAssignmentRef | 0: 1 | Reference to PassengerStopAssignment |
TrainRef | TrainRef | 0: 1 | Reference to Train. |
TrainComponentRef | TrainComponentRef | 0: 1 | Reference to specific cars (TrainComponent). |
BoardingPositionRef | BoardingPositionRef | 0: 1 | Reference to BoardingPosition. |
EntranceToVehicle | 0: 1 | Specifying entrances to the carriage, e.g. "front door", "rear door", etc. |
Journey Pattern
JourneyPattern
Sorted list of ScheduledStopPoint/TimingPoint and/or Links for a Route.
See definition under General information
Defined in ServiceFrame
JourneyPattern < LinkSequence < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
PrivateCode | xsd:normalizedString | 0: 1 | Internal (non-public) identifier for the JourneyPattern. |
RouteRef | RouteRef | 1: 1 | Reference to Route used in the JourneyPattern. |
runTimes | 0: * | Description of RunTimes for the JourneyPattern. Only used when describing frequency-based departures. | |
waitTimes | 0: * | Description of WaitTime for JourneyPattern Normally used only when describing frequency-based departures. | |
headways | 0: * | Description of JourneyHeadway for JourneyPattern Only used when describing frequency-based departures. | |
pointsInSequence | PointInJourneyPattern | 0: * | Sorted list of points in JourneyPattern. Must be StopPointInJourneyPattern or TimingPointInJourneyPattern. |
linksInSequence | 0: * | Sorted list of links in JourneyPattern. Must be ServiceLinkInJourneyPattern or TimingLinkInJourneyPattern. |
StopPointInJourneyPattern
StopPointInJourneyPattern < PointInLinkSequence < VersionedChild < EntityInVersion < Entity | |||
---|---|---|---|
Name | Type | Cardinality | Description |
ScheduledStopPointRef | ScheduledStopPointRef | 1: 1 | Reference to ScheduledStopPoint |
ForAlighting | xsd:boolean | 0: 1 | Specifies whether alighting is allowed. Should be explicitly indicated (normally "false") for the first StopPointInJourneyPattern |
ForBoarding | xsd:boolean | 0: 1 | Specifies whether boarding is allowed. Should be explicitly indicated (normally "false") for last StopPointInJourneyPattern |
DestinationDisplayRef | DestinationDisplayRef | 0: 1 | Reference to DestinationDisplay The required minimum for linear routes is for the first StopPointInJourneyPattern to have a DestinationDisplayRef. For circular routes, the minimum is two. A new DestinationDisplayRef should be set at any StopPointInJourneyPattern along the route where it is relevant to update the destination text. This is particularly relevant for circular routes. |
RequestStop | xsd:boolean | 0: 1 | Specifies whether passengers must signal to use this stop point. |
RequestMethod | RequestMethodTypeEnumeration | 0: 1 | Possible values for hailing or arranging a stop:
|
StopUse | StopUseEnumeration | 0: 1 | Nature of use of stop:
|
BookingArrangements | 0: 1 | Rules for booking. Please note that BookingArrangements specified at the StopPointInJourneyPattern level will always override equivalent specifications at the Line- or ServiceJourney level. |
BookingArrangementsStructure
Details for booking public transport services to a specific StopPointInJourneyPattern in an otherwise non-flexible line, or when the booking details for the stop deviate from those in a FlexibleLine.
BookingArrangementsStructure | |||
---|---|---|---|
Name | Type | Cardinality | Description |
BookingContact | 0: 1 | Contact information for booking Note that this field is mandatory if not already specified on FlexibleLine or overridden in FlexibleServiceProperties | |
BookingMethods | BookingMethodListOfEnumerations | 0: 1 | Possible ways to book (must match info found in BookingContact):
Note that this field is mandatory if not already specified on FlexibleLine or overridden in FlexibleServiceProperties |
BookingAccess | BookingAccessEnumeration | 0: 1 | Who may place an order (book):
|
BookWhen | PurchaseWhenEnumeration | 0: 1 | Time constraints for booking:
It is recommended to set this field if MinimumBookingPeriod is not specified (unless either is already specified on FlexibleLine or overridden in FlexibleServiceProperties) |
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 |
TimingPointInJourneyPattern
TimingPointInJourneyPattern < PointInLinkSequence < VersionedChild < EntityInVersion < Entity | |||
---|---|---|---|
Name | Type | Cardinality | Desription |
TimingPointRef | TimingPointRef | 1: 1 | Reference to TimingPoint |
WaitTime | xsd:duration | 0: 1 | Wait time at the timing point |
LinkInJourneyPattern
An abstract type for a sorted list of timing- or service links in a JourneyPattern.
LinkInJourneyPattern < VersionedChild < EntityInVersion < Entity | |||
---|---|---|---|
Name | Type | Cardinality | Description |
(choice) TimingLinkInJourneyPattern | 1: 1 | Sorted list of TimingLinks | |
(choice) ServiceLinkInJourneyPattern | 1: 1 | Sorted list of ServiceLinks |
TimingLinkInJourneyPattern
TimingLinkInJourneyPattern < VersionedChild < EntityInVersion < Entity | |||
---|---|---|---|
Name | Type | Cardinality | Description |
TimingLinkRef | TimingLinkRef | 1: 1 | Reference to ServiceLink |
ServiceLinkInJourneyPattern
ServiceLinkInJourneyPattern < VersionedChild < EntityInVersion < Entity | |||
---|---|---|---|
Name | Type | Cardinality | Description |
ServiceLinkRef | ServiceLinkRef | 1: 1 | Reference to ServiceLink |
DestinationDisplay
The text displayed on (or in) a vehicle, commonly above the front window or onboard information screens, describing the vehicles final (or intermediary) destination.
See definition under General information
Defined in ServiceFrame
Examples in the GitHub-repository
DestinationDisplay < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
SideText | 0: 1 | The text displayed on the side of the vehicle body. | |
FrontText | 1: 1 | The text displayed on the front of the vehicle, commonly above the front window. | |
vias | 0: 1 | An intermediary destination which the vehicle will pass before reaching its final destination. Eg. Oslo tram line 11: | |
variants | 0: * | Variations of DestinationDisplay adapted for particular media types Note that for composite DestinationDisplay text, e.g. line number and destination name. The minimum requirement is to provide a DestinationDisplay for web sites, with a destination name. |
DestinationDisplayVariant
Variations of DestinationDisplay adapted for particular media types.
DestinationDisplayVariant < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
DestinationDisplayVariantMediaType | DeliveryVariantTypeEnumeration | 1: 1 | Supported media types:
|
FrontText | 1: 1 | Frontpage text for DestinationDisplay |
Via
An intermediary destination which the vehicle will pass before reaching its final destination.
Via < VersionedChild < EntityInVersion < Entity | |||
---|---|---|---|
Name | Type | Cardinality | Description |
DestinationDisplayRef | DestinationDisplayRef | 1: 1 | Reference to the DestinationDisplay object describing the stop place/area the vehicle is headed towards. |
RoutePointRef | RoutePointRef | 0: 1 | Reference to RoutePoint. |
ViaType | ViaTypeEnumeration | 0: 1 | Possible values:
|
Flexible transport
FlexibleLine
FlexibleLine is a concept for describing on-demand transport, with at least some non-permanent stop places and/or specific requirements for prebooking).
See definition under General information
Defined in ServiceFrame
Examples in the GitHub-repository
FlexibleLine < Line < DataManagedObject | |||
---|---|---|---|
Nane | Type | Cardinality | Description |
FlexibleLineType | FlexibleLineTypeEnumeration | 1: 1 | Flexible line types:
|
BookingContact | 0: 1 | Contact information for booking | |
BookingMethods | BookingMethodListOfEnumerations | 0: 1 | Possible booking methods:
|
BookingAccess | BookingAccessEnumeration | 0: 1 | Who may place an order (book):
|
BookWhen | PurchaseWhenEnumeration | 0: 1 | Time constraints for booking:
|
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 |
FlexibleStopAssignment
Link between ScheduledStopPoint and FlexibleStopPlace.
See definition under General information
Defined in ServiceFrame
FlexibleStopAssignment < StopAssignment < Assignment < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
FlexibleStopPlaceRef | FlexibleStopPlaceRef | 1: 1 | Reference to FlexibleStopPlace |
Transfers
Transfer
An abstract type describing physical opportunity to come from one place to another. Not to be confused with Interchange.
Transfer < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
Name | 0: 1 | Name of the transfer | |
Description | 0: 1 | Textual description | |
Distance | xsd:decimal | 1: 1 | Total length for transfer (in meters) |
TransferDuration | 1: 1 | Detailed description for duration transfer | |
BothWays | xsd:boolean | 0: 1 | Specifies whether the transfer is possible in both directions |
TransferDuration
Specification of the duration of a transfer based on the type of traveller.
TransferDuration | |||
---|---|---|---|
Name | Type | Cardinality | Description |
DefaultDuration | xsd:duration | 1: 1 | Normal duration |
FrequentTravellerDuration | xsd:duration | 0: 1 | The time it will take a person with local knowledge to complete the transfer (commuter) |
OccasionalTravellerDuration | xsd:duration | 0: 1 | The time it will take a person unfamiliar with the place to complete the transfer (tourist etc.) |
MobilityRestrictedTravellerDuration | xsd:duration | 0: 1 | The time it will take a person with special needs to complete the transfer |