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 13 Next »

Version

Current version for network is:   v1.3   (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 < network#GroupOfLines < GroupOfEntities  < DataManagedObject
NameTypeCardinalityDescription
NameMultilingualString1: 1Name of the network.
AuthorityRefOrganisationRefStructure1: 1

Organisation responsible (for example owner) for the network.

groupsOfLinesnetwork#GroupOfLines0: *Lines (network#Line) included in the network.
tariffZonestariffZoneRefs0: *Tariff zones (network#TariffZone) in the network (when relevant).

GroupOfLines

Additional (optional) grouping of lines.

See definition under General information

Defined in ServiceFrame

GroupOfLines < GroupOfEntities  < DataManagedObject
NameTypeCardinalityDescription
NameMultilingualString1: 1Group name
memberslineRefs0: 1

An explicit listing of lines included in the group (if appropriate)

Note that reference should link from network#Line up to network#Network through a RepresentedByGroupRef

MainLineRefLineRefStructure0: 1Reference to the primary line in the group.
TransportModeAllVehicleModesOfTransportEnumeration0: 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
NameTypeCardinalityDescription
(attr) modificationxs:ModificationEnumeration0: 1Type of modification (use "delete" when a Line is permanently discontinued)
NameMultilingualString1: 1Name of the line
ShortNameMultilingualString0: 1Short name (e.g. short version of commonly (publicly) known name)
DescriptionMultilingualString  0: 1Description
TransportModeAllVehicleModesOfTransportEnumeration1: 1

See Mode in Transport Modes for valid values

TransportSubmodeTransportSubmode1: 1

See Submodes in Transport Modes for valid values (must be a TransportSubmode belonging to the selected TransportMode)

Urlxsd:anyURI0: 1URL to a website with information about the line.
PublicCodexsd:normalizedString0: 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.

PrivateCodexsd:normalizedString0: 1Internal (non-public) identifier for the line. For example, a code used by transport planners.
ExternalLineRefExternalObjectRef0: 1

Reference (ID) to a related Line (for example, the regular line for which this is a replacement).

OperatorRefOperatorRefStructure

1: 1

Reference to the main operator (may be omitted in exceptional cases, such as a different operator for every departure).

additionalOperatorstransportOrganisationRef0: *

Reference to additional operators of the line

TypeOfLineRefTypeOfLineRef0: 1

Reference to the line type. Classification, (e.g. replacement line)

Monitoredxsd:boolean0: 1

Specifies whether real-time information normally is available for this line (set to true when real-time data exists for the line).

routesRouteRef0: *

Reference to a listing of all routes (network#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

GroupOfLinesRefStructure1: 1Reference to the Lines' network#Network (alternatively a more specific reference to the GroupOfLines).
Presentationnetwork#Presentation0: 1

Graphical representation information (colour, text, etc.)

AccessibilityAssessmentAccessitilityAssessment0: 1Universal 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
NameTypeCardinalityDescription
ColourColourValueType0: 1

Six digit hexadecimal representation of the lines' RGB colour values.

TextColourColourValueType0: 1

Six digit hexadecimal representation of the lines' RGB colour values.

TextFontxsd:normalizedString0: 1

Font identifier (font). Normally not specified.

TariffZone

Geospatial area/zone used to calculate fares.

See definition under General information

Defined in ServiceFrame

Example found in GitHub-repository 

TariffZone < Zone < GroupOfPoints < GroupOfEntities  < DataManagedObject
NameTypeCardinalityDescription
TariffZone inherits from Zone and does not introduce new elements or attributes.

Service

TypeOfService

Classification of a service. 

See definition under General information

Defined in TimetableFrame

TypeOfService < TypeOfValue < DataManagedObject
NameTypeCardinalityDescription
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
NameTypeCardinalityDescription
LineRefLineRefStructure1: 1Reference to Line (network#Line) to which the Route belongs.
DirectionTypeDirectionTypeEnumeration0: 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.

pointsInSequencenetwork#PointOnRoute1: *List of the routes points 
InverseRouteRefRouteRefStructure0: 1Reference 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
NameTypeCardinalityDescription
BorderCrossingxsd:boolean0: 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 network#StopAssignment. All ScheduledStopPoint must have such a link.

See definition under General information

Defined in ServiceFrame

Examples in the GitHub-repository 

ScheduledStopPoint < network#TimingPoint < Point < DataManagedObject
NameTypeCardinalityDescription
tariffZonesTariffZoneRef0: 1List of TariffZones (network#TariffZone) the StopPoint belongs to.
Presentationnetwork#Presentation0: 1Graphical 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
NameTypeCardinalityDescription
TimingPointStatusTimingPointStatusEnumeration0: 1

Type of TimingPoint:

  • timingPoint
  • notTimingPoint (may indicate the expected passing time)
AllowedForWaitTimexsd:duration0: 1Allowed waiting time at the TimingPoint.

PointOnRoute

PointOnRoute < PointInLinkSequence < VersionedChild  < EntityInVersion < Entity 
NameTypeCardinalityDescription
LinkSequenceRefLinkSequenceRefStructure0: 1

Reference to LinkSequence to which the point belongs.

RouteRef should be used, since network#Route inherits from LinkSequence.

Note that the field should not be used if PointOnRoute is defined inline in network#Route.

projectionsProjection0: *

Projection on a point (RoutePoint, TimingPoint, SchedueledStopPoint) or a gml-coordinate projection .

PointRefPointRefStructure1: 1

Reference to Point

RoutePointRef should be used to point to the corresponding network#RoutePoint.

Link (with direction) between two RoutePoints.

See definition under General information

Defined in ServiceFrame

RouteLink < Link < DataManagedObject
NameTypeCardinalityDescription
FromPointRefRoutePointRef1: 1The start point for the RouteLink
ToPointRefRoutePointRef1: 1The endpoint for the RouteLink

Link (with direction) between two stop points.

See definition under General information

Defined in ServiceFrame

ServiceLink < Link < DataManagedObject
NameTypeCardinalityDescription
Distancexsd:decimal0: 1

Distance in meters for ServiceLink, i.e. driving distance between FromPoint and ToPoint.

projectionsLinkSequenceProjection0: 1Projection with <gml:LineString> indication of position.
FromPointRef

ScheduledStopPointRef

1: 1The start point for the ServiceLink.
ToPointRefScheduledStopPointRef1: 1The endpoint for ServiceLink.

Stop Assignment

StopAssignment

Abstract class used to describe the link between ScheduledStopPoint and StopPlace.

See definition under General information

StopAssignment < Assignment < DataManagedObject
NameTypeCardinalityDescription
ScheduledStopPointRefScheduledStopPointRef1: 1Reference to network#ScheduledStopPoint

PassengerStopAssignment

Link between ScheduledStopPoint and StopPlace or Quay

Examples in the GitHub-repository

Defined in ServiceFrame

PassengerStopAssignment < network#StopAssignment < Assignment  < DataManagedObject

NameTypeCardinalityDescription
elemStopPlaceRefStopPlaceRef0: 1

Reference to StopPlace which is related to network#ScheduledStopPoint

Should be included as far as possible, but the StopPlace can also be derived from the referenced Quay (QuayRef) when the StopPlaceRef is missing

elemQuayRefQuayRef1: 1Reference to an actual Quay on StopPlace
elemtrainElementsTrainStopAssignmentRef0: *

References to a detailed position on platform (network#TrainStopAssignment)

Used only for trains

attrorderxsd:integer1: 1The 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 < network#StopAssignment < Assignment  < DataManagedObject
NameTypeCardinalityDescription
FlexibleStopPlaceRefFlexibleStopPlaceRef1: 1Reference to FlexibleStopPlace which is related to network#ScheduledStopPoint
(choice) FlexibleQuayRefFlexibleQuayRef0: 1

Reference to a FlexibleQuay.

Can be added in a supplementary role if a FlexibleQuay is used.

(choice) FlexibleAreaRefFlexibleAreaRef0: 1

Reference to an actual FlexibleArea

Can be added in a supplementary role if a FlexibleArea is defined for the FlexibleStopPlace.

(choice) HailAndRideAreaRefHailAndRideAreaRef0: 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 < network#StopAssignment  < Assignment < DataManagedObject
NameTypeCardinalityDescription
PassengerStopAssignmentRefPassengerStopAssignmentRef0: 1Reference to network#PassengerStopAssignment
TrainRefTrainRef0: 1Reference to Train.
TrainComponentRefTrainComponentRef0: 1Reference to specific cars (TrainComponent).
BoardingPositionRefBoardingPositionRef0: 1Reference to BoardingPosition.
EntranceToVehicleMultilingualString0: 1Specifying 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
NameTypeCardinalityDescription
PrivateCodexsd:normalizedString0: 1

Internal (non-public) identifier for the JourneyPattern.

RouteRefRouteRef1: 1Reference to network#Route used in the JourneyPattern.
runTimesJourneyPatternRunTime0: *

Description of RunTimes for the JourneyPattern.

Only used when describing frequency-based departures.

waitTimesJourneyPatternWaitTime0: *

Description of WaitTime for JourneyPattern

Normally used only when describing frequency-based departures.

headwaysJourneyPatternHeadway0: *

Description of JourneyHeadway for JourneyPattern

Only used when describing frequency-based departures.

pointsInSequencePointInJourneyPattern0: *Sorted list of points in JourneyPattern. Must be network#StopPointInJourneyPattern or network#TimingPointInJourneyPattern.
linksInSequencenetwork#LinkInJourneyPattern0: *Sorted list of links in JourneyPattern. Must be network#ServiceLinkInJourneyPattern or network#TimingLinkInJourneyPattern.

StopPointInJourneyPattern

StopPointInJourneyPattern < PointInLinkSequence < VersionedChild < EntityInVersion < Entity
NameTypeCardinalityDescription
ScheduledStopPointRefScheduledStopPointRef1: 1Reference to network#ScheduledStopPoint
ForAlightingxsd:boolean0: 1

Specifies whether alighting is allowed.

Should be explicitly indicated (normally "false") for the first StopPointInJourneyPattern

ForBoardingxsd:boolean0: 1

Specifies whether boarding is allowed.

Should be explicitly indicated (normally "false") for last StopPointInJourneyPattern

DestinationDisplayRefDestinationDisplayRef0: 1

Reference to network#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.

FlexiblePointPropertiesnetwork#FlexiblePointProperties0: 1Properties of a stop point related to flexible transport.
RequestStopxsd:boolean0: 1Specifies whether passengers must signal to use this stop point.
RequestMethodRequestMethodTypeEnumeration0: 1

Possible values for hailing or arranging a stop:

  • handSignal
  • phoneCall
  • sms
  • stopButton
  • turnOnLight
BookingArrangementsnetwork#BookingArrangementsStructure0: 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
NameTypeCardinalityDescription
BookingContactContactStructure0: 1

Contact information for booking

Note that the field is mandatory if this is not already on network#FlexibleLine or overridden in FlexibleServiceProperties

BookingMethods

BookingMethodListOfEnumerations0: 1

Possible ways to book (must match info found in BookingContact):

  • callDriver
  • callOffice
  • online
  • phoneAtStop
  • text (text message/SMS)

Note that the field is mandatory if this is not already on network#FlexibleLine or overridden in FlexibleServiceProperties

BookingAccessBookingAccessEnumeration0: 1

Who may place an order (book):

  • public
  • authorisedPublic (eg TT-transport - special services for mobility restricted travellers )
  • staff
BookWhenPurchaseWhenEnumeration0: 1

Time constraints for booking:

  • timeOfTravelOnly
  • dayOfTravelOnly
  • untilPreviousDay
  • advanceAndDayOfTravel

Note that the field is mandatory if this is not already on network#FlexibleLine or overridden in FlexibleServiceProperties

BuyWhenPurchaseMomentListOfEnumerations0: 1

Time constraints for payment:

  • onReservation
  • beforeBoarding
  • afterBoarding
  • onCheckOut
LatestBookingTimexsd:time0: 1Latest possible booking time.
MinimumBookingPeriodxsd:duration0: 1

The minimum period prior to the departure the booking has to be placed.

BookingNotexsd:normalizedString0: 1Additional information about the order.

TimingPointInJourneyPattern

TimingPointInJourneyPattern < PointInLinkSequence < VersionedChild < EntityInVersion < Entity
NameTypeCardinalityDesription
TimingPointRefTimingPointRef1: 1Reference to network#TimingPoint
WaitTimexsd:duration0: 1Wait 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

NameTypeCardinalityDescription
(choice) TimingLinkInJourneyPatternnetwork#TimingLinkInJourneyPattern1: 1Sorted list of TimingLinks
(choice) ServiceLinkInJourneyPatternnetwork#ServiceLinkInJourneyPattern1: 1Sorted list of ServiceLinks

TimingLinkInJourneyPattern

TimingLinkInJourneyPattern < VersionedChild < EntityInVersion < Entity

NameTypeCardinalityDescription
TimingLinkRefTimingLinkRef1: 1Reference to ServiceLink

ServiceLinkInJourneyPattern

ServiceLinkInJourneyPattern < VersionedChild < EntityInVersion < Entity

NameTypeCardinalityDescription
ServiceLinkRefServiceLinkRef1: 1Reference 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
NameTypeCardinalityDescription
SideTextMultilingualString0: 1

The text displayed on the side of the vehicle body

FrontTextMultilingualString1: 1

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

viasnetwork#Via0: 1

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

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

variantsnetwork#DestinationDisplayVariant0: *

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
NameTypeCardinalityDescription
DestinationDisplayVariantMediaTypeDeliveryVariantTypeEnumeration1: 1

Supported media types:

  • Printed
  • TextToSpeech
  • Web
  • Mobile
  • other (e.g. real-time display)
FrontTextMultilingualString1: 1

Front page 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 
NameTypeCardinalityDescription
DestinationDisplayRefDestinationDisplayRef1: 1

Reference to the DestinationDisplay object describing the stop place/area the vehicle is headed towards.

RoutePointRefRoutePointRef0: 1Reference to RoutePoint.
ViaTypeViaTypeEnumeration0: 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). Note: FlexibleLine must be used if one or more FlexibleStopPlace (FlexibleArea and/or HailAndRideArea) are present in the Line.

See definition under General information

Defined in ServiceFrame

Examples in the GitHub-repository

FlexibleLine < network#Line < DataManagedObject
NaneTypeCardinalityDescription
FlexibleLineTypeFlexibleLineTypeEnumeration1: 1

Flexible line types:

  • corridorService
  • mainRouteWithFlexibleEnds
  • flexibleAreasOnly
  • hailAndRideSections
  • fixedStopAreaWide
  • mixedFlexible
  • mixedFlexibleAndFixed
  • fixed
BookingContactContactStructure0: 1

Contact information for booking.

BookingMethodsBookingMethodListOfEnumerations

0: 1

Possible booking methods:

  • callDriver
  • callOffice
  • online
  • phoneAtStop
  • text (text message/SMS)
BookingAccessBookingAccessEnumeration0: 1

Who may place an order (book):

  • public
  • authorisedPublic
  • staff
BookWhenPurchaseWhenEnumeration0: 1

Time constraints for booking:

  • timeOfTravelOnly
  • dayOfTravelOnly
  • untilPreviousDay
  • advanceAndDayOfTravel
BuyWhenPurchaseMomentListOfEnumerations0: 1

Time constraints for payment:

  • onReservation
  • beforeBoarding
  • afterBoarding
  • onCheckOut
LatestBookingTimexsd:time0: 1Latest possible booking time.
MinimumBookingPeriodxsd:duration0: 1

The minimum period prior to the departure the booking has to be placed.

BookingNotexsd:normalizedString0: 1Additional information about the order.

FlexibleStopAssignment

FlexibleStopAssignment < network#StopAssignment < Assignment < DataManagedObject
NameTypeCardinalityDescription
FlexibleStopPlaceRefFlexibleStopPlaceRef1: 1Reference 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
NameTypeCardinalityDescription
NameMultilingualString0: 1Name of the transfer
DescriptionMultilingualString0: 1Textual description
Distancexsd:decimal1: 1Total length for transfer (in meters)
TransferDurationnetwork#TransferDuration1: 1

Detailed description for duration transfer

BothWaysxsd:boolean0: 1Specifies 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
NameTypeCardinalityDescription
DefaultDurationxsd:duration1: 1Normal duration
FrequentTravellerDurationxsd:duration0: 1

The time it will take a person with local knowledge to complete the transfer (commuter)

OccasionalTravellerDurationxsd:duration0: 1

The time it will take a person unfamiliar with the place to complete the transfer (tourist etc.)

MobilityRestrictedTravellerDurationxsd:duration0: 1

The time it will take a person with special needs to complete the transfer

  • No labels