Skip to end of banner
Go to start of banner

network

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 26 Current »

Current version for network is:   v1.5   (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

MultilingualString

1: 1

Name of the network.

AuthorityRef

OrganisationRefStructure

1: 1

Organisation responsible (for example owner) for the network.

groupsOfLines

GroupOfLines

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

MultilingualString

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

MultilingualString

1: 1

Name of the line

ShortName

MultilingualString

0: 1

Short name (e.g. short version of commonly (publicly) known name)

Description

MultilingualString  

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 true when real-time data exists for the line).

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

Presentation

0: 1

Graphical representation information (colour, text, etc.)

AccessibilityAssessment

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

Classification of a service. 

See definition under General information

Defined in TimetableFrame

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:

  • inbound (towards the city centre or transport hub)

  • outbound (from the city centre or transport hub) 

  • clockwise (circular route in the clockwise direction)

  • anticlockwise (circular route in the anticlockwise direction)

To be able to identify full- or partial circular routes clockwise/anticlockwise must be specified.

pointsInSequence

PointOnRoute

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:

  • timingPoint (the ScheduledStopPoint should also explicitly be regarded as a timing point in relevant systems)

  • notTimingPoint (the ScheduledStopPoint should not be regarded as a timing point)

  • secondaryTimingPoint (for arbitrary use)

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

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:

  • timingPoint

  • notTimingPoint (may indicate the expected passing time)

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

Projection

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.

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

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

LinkSequenceProjection

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.

See definition under General information

SiteConnection < Transfer < DataManagedObject

Name

Type

Cardinality

Description

From

SiteConnectionEndStructure

1: 1

The starting point for SiteConnection

To

SiteConnectionEndStructure

1: 1

The endpoint for SiteConnection

navigationPaths

NavigationPath

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.

See definition under General information

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

Reference to an actual Quay on StopPlace

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.
Examples of valid implementations:

  • an incremented sequence number ("1", "2", "3", ...)

  • a constant value ("0")

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

MultilingualString

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

JourneyPatternRunTime

0: *

Description of RunTimes for the JourneyPattern.

Only used when describing frequency-based departures.

waitTimes

JourneyPatternWaitTime

0: *

Description of WaitTime for JourneyPattern

Normally used only when describing frequency-based departures.

headways

JourneyPatternHeadway

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

LinkInJourneyPattern

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:

  • handSignal

  • phoneCall

  • sms

  • stopButton

  • turnOnLight

StopUse

StopUseEnumeration

0: 1

Nature of use of stop:

  • interchangeOnly

BookingArrangements

BookingArrangementsStructure

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

ContactStructure

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):

  • callDriver

  • callOffice

  • online

  • phoneAtStop

  • text (text message/SMS)

  • other

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):

  • public

  • authorisedPublic (e.g. TT-transport - special services for mobility restricted travelers)

  • staff

BookWhen

PurchaseWhenEnumeration

0: 1

Time constraints for booking:

  • timeOfTravelOnly

  • dayOfTravelOnly (requires LatestBookingTime to be set)

  • untilPreviousDay (requires LatestBookingTime to be set)

  • advanceAndDayOfTravel (requires LatestBookingTime to be set)

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:

  • onReservation

  • beforeBoarding

  • afterBoarding

  • onCheckOut

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.

See definition under General information

LinkInJourneyPattern < VersionedChild < EntityInVersion < Entity

Name

Type

Cardinality

Description

(choice) TimingLinkInJourneyPattern

TimingLinkInJourneyPattern

1: 1

Sorted list of TimingLinks

(choice) ServiceLinkInJourneyPattern

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

MultilingualString

0: 1

The text displayed on the side of the vehicle body.

FrontText

MultilingualString

1: 1

The text displayed on the front of the vehicle, commonly above the front window.

vias

Via

0: *

Intermediary stop(s) which the vehicle will pass before reaching its final destination.

Eg. Oslo tram line 11: "Majorstuen - Kjelsås via Torshov"

variants

DestinationDisplayVariant

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.

See definition under General information

DestinationDisplayVariant < DataManagedObject

Name

Type

Cardinality

Description

DestinationDisplayVariantMediaType

DeliveryVariantTypeEnumeration

1: 1

Supported media types:

  • Printed

  • TextToSpeech

  • Web

  • Mobile

  • other (e.g. real-time display)

FrontText

MultilingualString

1: 1

Frontpage text for DestinationDisplay

Via

An intermediary destination which the vehicle will pass before reaching its final destination.

See definition under General information

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:

  • stopPoint

  • name

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:

  • corridorService

  • mainRouteWithFlexibleEnds

  • flexibleAreasOnly

  • hailAndRideSections

  • fixedStopAreaWide

  • mixedFlexible

  • mixedFlexibleAndFixed

  • fixed

BookingContact

ContactStructure

0: 1

Contact information for booking

BookingMethods

BookingMethodListOfEnumerations

0: 1

Possible booking methods:

  • callDriver

  • callOffice

  • online

  • phoneAtStop

  • text (text message/SMS)

  • other

BookingAccess

BookingAccessEnumeration

0: 1

Who may place an order (book):

  • public

  • authorisedPublic (e.g. TT-transport - special services for mobility restricted travelers)

  • staff

BookWhen

PurchaseWhenEnumeration

0: 1

Time constraints for booking:

  • timeOfTravelOnly

  • dayOfTravelOnly (requires LatestBookingTime to be set)

  • untilPreviousDay (requires LatestBookingTime to be set)

  • advanceAndDayOfTravel (requires LatestBookingTime to be set)

BuyWhen

PurchaseMomentListOfEnumerations

0: 1

Time constraints for payment:

  • onReservation

  • beforeBoarding

  • afterBoarding

  • onCheckOut

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

An abstract type describing physical opportunity to come from one place to another. Not to be confused with Interchange.

See definition under General information

Transfer < DataManagedObject

Name

Type

Cardinality

Description

Name

MultilingualString

0: 1

Name of the transfer

Description

MultilingualString

0: 1

Textual description

Distance

xsd:decimal

1: 1

Total length for transfer (in meters)

TransferDuration

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.

See definition under General information

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

  • No labels