network
Current version for network is: v1.5 (last changed Jul 28, 2022)
Content
- 1 Components
- 1.1 Network components
- 1.1.1 Network
- 1.1.2 GroupOfLines
- 1.1.3 Line
- 1.1.3.1 Presentation
- 1.2 Service
- 1.2.1 TypeOfService
- 1.3 Route
- 1.3.1 Route
- 1.3.2 RoutePoint
- 1.3.3 ScheduledStopPoint
- 1.3.4 TimingPoint
- 1.3.5 PointOnRoute
- 1.3.6 RouteLink
- 1.3.7 ServiceLink
- 1.3.8 Connection
- 1.3.8.1 SiteConnection
- 1.3.8.2 SiteConnectionEndStructure
- 1.3.9 Stop Assignment
- 1.3.9.1 StopAssignment
- 1.3.9.2 PassengerStopAssignment
- 1.3.9.3 FlexibleStopAssignment
- 1.3.9.4 TrainStopAssignment
- 1.4 Journey Pattern
- 1.4.1 JourneyPattern
- 1.4.1.1 StopPointInJourneyPattern
- 1.4.1.2 BookingArrangementsStructure
- 1.4.1.3 TimingPointInJourneyPattern
- 1.4.1.4 LinkInJourneyPattern
- 1.4.1.5 TimingLinkInJourneyPattern
- 1.4.1.6 ServiceLinkInJourneyPattern
- 1.4.1 JourneyPattern
- 1.5 DestinationDisplay
- 1.5.1 DestinationDisplayVariant
- 1.5.2 Via
- 1.6 Flexible transport
- 1.6.1 FlexibleLine
- 1.6.2 FlexibleStopAssignment
- 1.7 Transfers
- 1.7.1 Transfer
- 1.7.1.1 TransferDuration
- 1.7.1 Transfer
- 1.1 Network components
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 for particular purposes such as e.g. fare harmonisation or public presentation.
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 < 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
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
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
RoutePoint < Point < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
BorderCrossing | xsd:boolean | 0: 1 | Specifies whether the point is on the border between two countries. |
ScheduledStopPoint
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
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
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
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
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
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
Stop Assignment
StopAssignment
StopAssignment < Assignment < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
ScheduledStopPointRef | ScheduledStopPointRef | 1: 1 | Reference to ScheduledStopPoint |
PassengerStopAssignment
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
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
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
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
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
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
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: * | Intermediary stop(s) 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
DestinationDisplayVariant < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
DestinationDisplayVariantMediaType | DeliveryVariantTypeEnumeration | 1: 1 | Supported media types:
|
FrontText | 1: 1 | Frontpage text for DestinationDisplay |
Via
Via < VersionedChild < EntityInVersion < Entity | |||
---|---|---|---|
Name | Type | Cardinality | Description |
(attribute) order | xsd:integer | 0: 1 | Relative order for Via element. |
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 < 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
FlexibleStopAssignment < StopAssignment < Assignment < DataManagedObject | |||
---|---|---|---|
Name | Type | Cardinality | Description |
FlexibleStopPlaceRef | FlexibleStopPlaceRef | 1: 1 | Reference to FlexibleStopPlace |
Transfers
Transfer
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
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 |