Samtrafiken NeTEx export

1 Changelog of this documentation
2 ServiceCalendar, DayType, OperatingPeriod and DayTypeAssignment
3 _shared_data.xml
4 _stops.xml
5 line_{Noptis.TransportAuthority.Number}_{Noptis.Line.Number}_{Noptis.Line.Gid}.xml (line_253_53_9011005005300000.xml)
6 General Noptis to Netex mappings

This page contains documentation on how Samtrafiken exports data in the NeTEx format according to the Nordic NeTEx Profile. It also shows how this NeTEx export is mapped from Noptis (DOI/DII) data (see Home Page | NOPTIS), which is the format that many PTA:s use to deliver their data to Samtrafiken.

If you are using Samtrafiken’s NeTEx sales data (used for sales through Samtrafiken ACCESS) then you should also read the specific documentation for that dataset here: https://samtrafiken.atlassian.net/wiki/x/GYCOzQ.

Changelog of this documentation

2024-02-12 - Added the two fields JourneyPart.StartTimeDayOffset and JourneyPart.EndTimeDayOffset with explanations.

ServiceCalendar, DayType, OperatingPeriod and DayTypeAssignment

The ServiceCalendar information is specified using DayTypes with PropertyOfDay specifying which DaysOfWeek that the service runs (N.B: In some cases this can also be empty).

An OperatingPeriod is connected to the DayType using a DayTypeAssignment, thereby specifying during which period the DayType is valid.

Finally, to handle exceptional days (added or excluded dates) additional DayTypeAssignments are connected to the DayType, specifying additional dates as either added (the default) or excluded (marked by setting <isAvailable>false</isAvailable>).

Note: The OperatingPeriod is valid up to the datetime specified in the ToDate, but NOT including that time, see the example below:

<OperatingPeriod version="any" id="SE:253:OperatingPeriod:221108221209">
  <FromDate>2022-11-08T00:00:00</FromDate>
  <ToDate>2022-12-10T00:00:00</ToDate>
  <!-- N.B: The ToDate is actually the time when the OperatingPeriod stops being valid.
       This means that the period is valid up to this time, but NOT including this time. 
       So the last possible trip would depart on 2022-12-09 23:59:59 -->
</OperatingPeriod>

_shared_data.xml

This is an example of the file _shared_data.xml with explanations on how the different fields and elements are mapped to the Noptis format.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<PublicationDelivery xmlns="http://www.netex.org.uk/netex" xmlns:ns2="http://www.opengis.net/gml/3.2" xmlns:ns3="http://www.siri.org.uk/siri">
    <PublicationTimestamp>2019-11-27T12:50:21</PublicationTimestamp> <!-- Timestamp of export -->
    <ParticipantRef>SAM</ParticipantRef>
    <dataObjects>
        <CompositeFrame created="2019-11-27T12:50:21" version="20191127125021" id="SE:253:CompositeFrame:1"> <!-- Version is timestamp of export, id is always 1 -->
            <ValidBetween>
                <FromDate>2005-01-01T00:00:00</FromDate> <!-- Always set to 2005-01-01 -->
            </ValidBetween>
            <codespaces>
                <Codespace id="253"> <!-- id is same as Xmlns -->
                    <Xmlns>253</Xmlns> <!-- From Samtrafiken's registry of producer numbers, based on data source -->
                    <XmlnsUrl>http://www.samtrafiken.se/ns/Östgötatrafiken</XmlnsUrl> <!-- "Östgötatrafiken" is based on data source -->
                </Codespaced>
            </codespaces>
            <FrameDefaults>
                <DefaultLocale>
                    <TimeZone>Europe/Stockholm</TimeZone>
                    <DefaultLanguage>se</DefaultLanguage>
                </DefaultLocale>
                <DefaultLocationSystem>4326</DefaultLocationSystem> <!-- All coordinates are WGS84 -->
            </FrameDefaults>
            <frames>
                <ResourceFrame version="20191127125021" id="SE:253:ResourceFrame:1"> <!-- Version is timestamp of export (YYYYMMDDHHmmSS), id is always 1 -->
                    <organisations>
                        <!-- Authority is based on Noptis.TransportAuthority -->
                        <Authority version="20131206" id="SE:253:Authority:9010005000000000"> <!-- version=Noptis.TransportAuthority.ExistsFromDate, id=Noptis.TransportAuthority.Gid -->
                            <ValidBetween>
                                <FromDate>2019-02-13T00:00:00</FromDate> <!-- Noptis.TransportAuthority.ExistsFromDate -->
                                <!-- ToDate = Noptis.TransportAuthority.ExistsToDate, in this case "ExistsToDate" is null -->
                            </ValidBetween>
                            <PrivateCode>253</PrivateCode>
                            <Name>Östgötatrafiken</Name> <!-- Noptis.TransportAuthority.Name -->
                            <LegalName>Östgötatrafiken</LegalName> <!-- Noptis.Organisation.FormalName -->
                            <OrganisationType>authority</OrganisationType> <!-- Always "authority" -->
                        </Authority>
                        <!-- More Authority elements -->
                        <!-- Operator is based on Noptis.Contractor -->
                        <Operator version="20131211" id="SE:253:Operator:9013005918200000"> <!-- version=Noptis.Contractor.ExistsFromDate, id=Noptis.Contractor.Gid -->
                            <ValidBetween>
                                <FromDate>2019-02-13T00:00:00</FromDate> <!-- Noptis.Contractor.ExistsFromDate -->
                                <!-- ToDate = Noptis.Contractor.ExistsToDate, in this case "ExistsToDate" is null -->
                            </ValidBetween>
                            <Name>eBuss Motala</Name> <!-- Noptis.Contractor.Name -->
                            <LegalName>eBuss i Sverige AB</LegalName> <!-- Noptis.Organisation.FormalName -->
                            <OrganisationType>operator</OrganisationType> <!-- Always "operator" -->
                        </Operator>
                        <!-- More Operator elements -->
                    </organisations>
                </ResourceFrame>
                <ServiceFrame version="20191127125021" id="SE:253:ServiceFrame:1"> <!-- Version is timestamp of export (YYYYMMDDHHmmSS), id is always 1 -->
                    <!-- Each unique Noptis.Line.IsDefinedByTransportAuthority will create a Network with the AuthorityRef. In this case there is only one, 
                    additional Networks would be placed in an "additionalNetworks" element. -->
                    <Network version="20131206" id="SE:253:Network:9010005000000000"> <!-- version=Noptis.TransportAuthority.ExistsFromDate, id=Noptis.TransportAuthority.Gid -->
                        <Name>Östgötatrafiken</Name> <!-- Noptis.TransportAuthority.Name -->
                        <AuthorityRef ref="SE:253:Authority:9010005000000000" version="20131206"/>
                        <!-- WIP, Netex.GroupOfLines is based on Noptis.GroupOfLines -->
                        <groupsOfLines>
                            <GroupOfLines version="1" id="SE:253:GroupOfLines:1">
                                <ValidBetween>
                                    <FromDate>2019-02-13T00:00:00</FromDate> <!-- Noptis.GroupOfLines.ExistsFromDate -->
                                    <!-- ToDate = Noptis.GroupOfLines.ExistsToDate, in this case "ExistsToDate" is null -->
                                </ValidBetween>
                                <Name>Spårvagn</Name> <!-- Noptis.GroupOfLines.Name -->
                                <PrivateCode>SPV</PrivateCode> <!-- Noptis.GroupOfLine.Code -->
                                <members>
                                    <LineRef ref="SE:253:Line:9011005005300000"/> <!-- Based on Noptis.LineInGroupOfLines -->
                                </members>
                            </GroupOfLines>
                        </groupsOfLines>
                    </Network>
                    <routePoints>
                        <!-- RoutePoint, ScheduledStopPoint, PassengerStopAssignment are all based on Noptis.StopPoint -->
                        <RoutePoint version="20190426" id="SE:253:RoutePoint:9022005000001001"> <!-- version=Noptis.StopPoint.ExistsFromDate, id=Noptis.StopPoint.Gid -->
                            <projections>
                                <PointProjection version="20190426" id="SE:253:PointProjection:9022005000001001"> <!-- version=Noptis.StopPoint.ExistsFromDate, id=Noptis.StopPoint.Gid -->
                                    <ProjectedPointRef ref="SE:253:ScheduledStopPoint:9022005000001001" version="20190426"/>
                                </PointProjection>
                            </projections>
                        </RoutePoint>
                        <!-- More RoutePoint elements -->
                    </routePoints>
                    <destinationDisplays>
                        <!-- DestinationDisplay is based on Noptis.DestinationDisplay -->
                        <!-- DestinationDisplays that are used as "via" are created from each Noptis.DestinationDisplay.SecondaryDestinationName. Theses elements are recognized by having "via_" prepended to their id.
                        In the example below, both DestinationDisplay elements are created from the same Noptis.DestinationDisplay. -->
                        <DestinationDisplay version="any" id="SE:253:DestinationDisplay:via_55700000037211691"> <!-- id=Noptis.DestinationDisplay.Id -->
                            <FrontText>Västerlösa</FrontText> <!-- Noptis.DestinationDisplay.SecondaryDestinationName -->
                            <PublicCode>573</PublicCode> <!-- Noptis.DestinationDisplay.LineDesignation -->
                        </DestinationDisplay>
                        <DestinationDisplay version="any" id="SE:253:DestinationDisplay:55700000037211691"> <!-- id=Noptis.DestinationDisplay.Id -->
                            <FrontText>Malmslätt</FrontText> <!-- Noptis.DestinationDisplay.PrimaryDestinationName -->
                            <PublicCode>573</PublicCode> <!-- Noptis.DestinationDisplay.LineDesignation -->
                            <vias>
                                <Via>
                                    <DestinationDisplayRef ref="SE:253:DestinationDisplay:via_55700000037211691" version="any"/>
                                </Via>
                            </vias>
                        </DestinationDisplay>
                        <!-- More DestinationDisplay elements -->
                    </destinationDisplays>
                    <scheduledStopPoints>
                        <!-- RoutePoint, ScheduledStopPoint, PassengerStopAssignment are all based on Noptis.StopPoint -->
                        <ScheduledStopPoint version="20190426" id="SE:253:ScheduledStopPoint:9022005000001001"> <!-- version=Noptis.StopPoint.ExistsFromDate, id=Noptis.StopPoint.Gid -->
                            <Name>Norr Tull</Name> <!-- Noptis.StopPoint.Name -->
                        </ScheduledStopPoint>
                        <!-- More ScheduledStopPoint elements -->
                    </scheduledStopPoints>
                    <serviceLinks>
                        <!-- ServiceLink is based on Noptis.RouteLink -->
                        <ServiceLink version="20190213" id="SE:253:ServiceLink:BUS_9025005000136402_9025005000005702"> <!-- version=Noptis.RouteLink.ExistsFromDate, 
                            id=Noptis.RouteLinkTraversableByTransportModeCode.TransportModeCode + Noptis.RouteLink.StartsAtJourneyPatternPointGid + Noptis.RouteLink.EndsAtJourneyPatternPointGid -->
                            <ValidBetween>
                                <FromDate>2019-02-13T00:00:00</FromDate> <!-- Noptis.RouteLink.ExistsFromDate -->
                                <!-- ToDate = Noptis.RouteLink.ExistsToDate, in this case "ExistsToDate" is null -->
                            </ValidBetween>
                            <Distance>338</Distance> <!-- Noptis.RouteLink.DistanceMeters -->
                            <projections>
                                <LinkSequenceProjection version="20190213" id="SE:253:LinkSequenceProjection:BUS_9025005000136402_9025005000005702"> <!-- Same ID as parent ServiceLink -->
                                    <ns2:LineString srsName="4326" ns2:id="LS_BUS_9025005000136402_9025005000005702"> <!-- Same ID as parent ServiceLink but with "LS_" prepended -->
                                        <ns2:posList count="30" srsDimension="2">58.666991 16.180848 58.666982 16.180848 58.66691 16.180899 58.666703 16.181034 58.666325 16.181358 58.666109 16.181545 58.665821 16.1818 58.665749 16.181834 58.665651 16.181833 58.665624 16.181833 58.665328 16.181743 58.664978 16.18155 58.664593 16.181253 58.664494 16.181166 58.664154 16.180869</ns2:posList> 
                                        <!-- Each coordinate pair is created from one Noptis.PointOnRouteLink -->
                                    </ns2:LineString>
                                </LinkSequenceProjection>
                            </projections>
                            <FromPointRef ref="SE:253:ScheduledStopPoint:9022005001364002" version="20190426"/> <!-- Noptis.RouteLink.StartsAtJourneyPatternPointGid -->
                            <ToPointRef ref="SE:253:ScheduledStopPoint:9022005000057002" version="20190426"/> <!-- Noptis.RouteLink.EndsAtJourneyPatternPointGid -->
                            <VehicleMode>bus</VehicleMode> <!-- See the section "General Noptis to Netex mappings" below -->
                        </ServiceLink>
                        <!-- More ServiceLink elements -->
                    </serviceLinks>
                    <stopAssignments>
                        <!-- RoutePoint, ScheduledStopPoint, PassengerStopAssignment are all based on Noptis.StopPoint -->
                        <PassengerStopAssignment order="0" version="20190426" id="SE:253:PassengerStopAssignment:9022005000001001"> <!-- version=Noptis.StopPoint.ExistsFromDate, id=Noptis.StopPoint.Gid, "order" is always 0 -->
                            <ScheduledStopPointRef ref="SE:253:ScheduledStopPoint:9022005000001001" version="20190426"/>
                            <QuayRef ref="SE:253:Quay:9022005000001001"/>
                        </PassengerStopAssignment>
                        <!-- More PassengerStopAssignment elements -->
                    </stopAssignments>
                    <notices>
                        <!-- Notice is based on Noptis.AdvanceOrderCondition -->
                        <Notice version="any" id="SE:253:Notice:55700000050931583"> <!-- id=Noptis.AdvanceOrderCondition.Id -->
                            <Text>Turen måste förbeställas på 0771 - 71 10 20 senast 2 timmar före avresa från turens starthållplats.</Text> <!-- Noptis.AdvanceOrderCondition.PublicNote -->
                        </Notice>
                        <!-- More Notice elements -->
                    </notices>
                </ServiceFrame>
                <ServiceCalendarFrame version="20191127125021" id="SE:253:ServiceCalendarFrame:1"> <!-- Version is timestamp of export (YYYYMMDDHHmmSS), id is always 1 -->
                    <!-- The content of ServiceCalendarFrame is created based on Noptis.DatedVehicleJourney.OperatingDayDate but a pattern of runnings days and operating period is constructed to represent that data.
                    Each unique combination of operating days of a Noptis.VehicleJourney will create one DayType. -->
                    <dayType
                        <DayType version="any" id="SE:253:DayType:a33m5mgb2thf88dnl75h8a8jt21i3iqu">
                          <properties>
                            <PropertyOfDay>
                              <DaysOfWeek>Monday Tuesday Wednesday Thursday Friday</DaysOfWeek>
                            </PropertyOfDay>
                          </properties>
                        </DayType>
                        <DayType version="any" id="SE:253:DayType:4vfuvln5ed1bte5nrbf56qees9vakerf">
                          <properties>
                            <PropertyOfDay>
                              <DaysOfWeek>Saturday Sunday</DaysOfWeek>
                            </PropertyOfDay>
                          </properties>                        
                        </DayType>
                    </dayTypes>
                    <operatingPeriods>
                        <OperatingPeriod version="any" id="SE:253:OperatingPeriod:221108221209">
                            <FromDate>2022-11-08T00:00:00</FromDate>
                            <ToDate>2022-12-10T00:00:00</ToDate><!-- N.B: The period is valid up-to this time, but NOT including this time. So the last possible trip would depart on 2022-12-09 23:59:59 -->
                        </OperatingPeriod>
                        <OperatingPeriod version="any" id="SE:253:OperatingPeriod:221212230331">
                            <FromDate>2022-12-12T00:00:00</FromDate>
                            <ToDate>2023-04-01T00:00:00</ToDate>
                        </OperatingPeriod>
                    </operatingPeriods>                    
                    <dayTypeAssignments>
                        <DayTypeAssignment order="1" version="any" id="SE:253:DayTypeAssignment:a33m5mgb2thf88dnl75h8a8jt21i3iqu">
                            <OperatingPeriodRef ref="SE:253:OperatingPeriod:221108221209" version="any"/>
                            <DayTypeRef ref="SE:253:DayType:a33m5mgb2thf88dnl75h8a8jt21i3iqu" version="any"/>
                        </DayTypeAssignment>
                        <DayTypeAssignment order="1" version="any" id="SE:253:DayTypeAssignment:4vfuvln5ed1bte5nrbf56qees9vakerf">
                            <OperatingPeriodRef ref="SE:253:OperatingPeriod:221212230331" version="any"/>
                            <DayTypeRef ref="SE:253:DayType:4vfuvln5ed1bte5nrbf56qees9vakerf" version="any"/>
                        </DayTypeAssignment>
                        <DayTypeAssignment order="2" version="any" id="SE:253:DayTypeAssignment:4vfuvln5ed1bte5nrbf56qees9vakerf_221226">
                            <Date>2022-12-26</Date>
                            <DayTypeRef ref="SE:253:DayType:4vfuvln5ed1bte5nrbf56qees9vakerf" version="any"/>
                        </DayTypeAssignment>                        
                        <DayTypeAssignment order="3" version="any" id="SE:253:DayTypeAssignment:4vfuvln5ed1bte5nrbf56qees9vakerf_230107">
                            <Date>2023-01-07</Date>
                            <DayTypeRef ref="SE:253:DayType:4vfuvln5ed1bte5nrbf56qees9vakerf" version="any"/>
                            <isAvailable>false</isAvailable>
                        </DayTypeAssignment>
                        <!-- More DayTypeAssignment elements -->
                    </dayTypeAssignments>
                </ServiceCalendarFrame>
            </frames>
        </CompositeFrame>
    </dataObjects>
</PublicationDelivery>

_stops.xml

This is a shortened example of the file _stops.xml with explanations on how the different fields and elements are mapped to the Noptis format.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<PublicationDelivery xmlns="http://www.netex.org.uk/netex" xmlns:ns2="http://www.opengis.net/gml/3.2" xmlns:ns3="http://www.siri.org.uk/siri">
    <PublicationTimestamp>2019-11-27T12:50:21</PublicationTimestamp> <!-- Timestamp of export -->
    <ParticipantRef>SAM</ParticipantRef>
    <dataObjects>
        <SiteFrame version="20191127125021" id="SE:253:SiteFrame:1"> <!-- Version is timestamp of export (YYYYMMDDHHmmSS), id is always 1 -->
            <ValidBetween>
                <FromDate>2005-01-01T00:00:00</FromDate> <!-- Always set to 2005-01-01 -->
            </ValidBetween>
            <codespaces>
                <Codespace id="253"> <!-- id is same as Xmlns -->
                    <Xmlns>253</Xmlns> <!-- From Samtrafiken's registry of producer numbers, based on data source -->
                    <XmlnsUrl>http://www.samtrafiken.se/ns/Östgötatrafiken</XmlnsUrl> <!-- "Östgötatrafiken" is based on data source -->
                </Codespace>
            </codespaces>
            <FrameDefaults>
                <DefaultLocale>
                    <TimeZone>Europe/Stockholm</TimeZone>
                    <DefaultLanguage>se</DefaultLanguage>
                </DefaultLocale>
                <DefaultLocationSystem>4326</DefaultLocationSystem> <!-- All coordinates are WGS84 -->
            </FrameDefaults>
            <!-- WIP, TopographicPlace is based on Noptis.Zone . TopographicPlaces are referenced from Quays through ZoneProjections -->
            <topographicPlaces>
                <TopographicPlace version="any" id="SE:253:TopographicPlace:1">
                    <ValidBetween>
                        <FromDate>2016-12-13T00:00:00</FromDate> <!-- Noptis.Zone.ExistsFromDate -->
                        <!-- ToDate = Noptis.Zone.ExistsToDate, in this case "ExistsToDate" is null -->
                    </ValidBetween>
                    <Name>Boxholm</Name> <!-- Noptis.Zone.Name -->
                    <PrivateCode>0560</PrivateCode> <!-- Noptis.Zone.Number -->
                    <TopographicPlaceType>municipality</TopographicPlaceType> <!-- Based on Noptis.Zone.ZoneTypeCode -->
                </TopographicPlace>
            </topographicPlaces>
            <groupsOfStopPlaces> <!-- GroupOfStopPlace is based on Noptis.Site -->
              <GroupOfStopPlaces version="20120623" id="SE:001:GroupOfStopPlaces:9091001000000103"> <!-- version=Noptis.Site.ExistsFromDate, id=Noptis.Site.Gid -->
                    <ValidBetween>
                        <FromDate>2012-06-23T00:00:00</FromDate> <!-- Noptis.Site.ExistsFromDate -->
                    </ValidBetween>
                    <Name>Nämdöböte</Name> <!-- Noptis.Site.Name -->
                    <Description>Nämdö</Description> <!-- Noptis.Site.PublicNote -->
                    <PrivateCode>103</PrivateCode> <!-- Noptis.Site.Number -->
                    <members>
                        <!-- StopPlaceRefs are based on Noptis.SiteNeighbouringStopArea -->
                        <StopPlaceRef ref="SE:001:StopPlace:9021001000103000" version="20210224"/> <!-- ref=Noptis.StopArea.Gid, version=Noptis.StopArea.ExistsFromDate -->
                        <StopPlaceRef ref="SE:001:StopPlace:9021005000001000" version="20161213"/> <!-- ref=Noptis.StopArea.Gid, version=Noptis.StopArea.ExistsFromDate -->
                    </members>
                    <Centroid>
                        <Location srsName="WGS84"> <!-- Noptis.Site.CoordinateSystemName -->
                            <Longitude>18.739921</Longitude> <!-- Noptis.Site.CentroidEastingCoordinate -->
                            <Latitude>59.208826</Latitude> <!-- Noptis.Site.CentroidNorthingCoordinate -->
                        </Location>
                    </Centroid>
                </GroupOfStopPlaces>
            </groupsOfStopPlaces>
            <stopPlaces> <!-- StopPlace is based on Noptis.StopArea -->
                <StopPlace version="20161213" id="SE:253:StopPlace:9021005000001000"> <!-- version=Noptis.StopArea.ExistsFromDate, id=Noptis.StopArea.Gid -->
                    <ValidBetween>
                        <FromDate>2016-12-13T00:00:00</FromDate> <!-- Noptis.StopArea.ExistsFromDate -->
                        <!-- ToDate = Noptis.StopArea.ExistsToDate, in this case "ExistsToDate" is null -->
                    </ValidBetween>
                    <Name>Norr Tull</Name> <!-- Noptis.StopArea.Name -->
                    <ShortName>Norr Tull</ShortName> <!-- Noptis.StopArea.ShortName -->
                    <PrivateCode>1</PrivateCode> <!-- Noptis.StopArea.Number -->
                    <Centroid>
                        <Location>
                            <Longitude>16.176723</Longitude> <!-- Noptis.StopArea.CentroidEastingCoordinate -->
                            <Latitude>58.594850</Latitude> <!-- Noptis.StopArea.CentroidNorthingCoordinate -->
                        </Location>
                    </Centroid>
                    <OrganisationRef ref="SE:253:Authority:9010005000000000"/> <!-- Noptis.StopArea.IsDefinedByTransportAuthortiy -->
                    <entrances> <!-- Entrances are based on Noptis.StationEntrancePoint -->
                        <StopPlaceEntrance version="20120623" id="SE:275:StopPlaceEntrance:9023001006651001"> <!-- version=Noptis.StationEntrancePoint.ExistsFromDate, id=Noptis.StationEntrancePoint.Gid -->
                            <ValidBetween>
                                <FromDate>2014-03-11T00:00:00</FromDate>  <!-- Noptis.StationEntrancePoint.ExistsFromDate but not earlier than parent StopPlace.FromDate -->
                                <!-- ToDate = Noptis.StationEntrancePoint.ExistsToDate, in this case "ExistsToDate" is null, not later than parent StopPlace.ToDate -->
                            </ValidBetween>
                            <Name>Djursholms Ösby</Name> <!-- Noptis.StationEntrancePoint.Name -->
                            <Centroid>
                                <Location>
                                    <Longitude>18.058320</Longitude> <!-- Noptis.StationEntrancePoint.LocationEastingCoordinate -->
                                    <Latitude>59.397925</Latitude> <!-- Noptis.StationEntrancePoint.LocationNorthingCoordinate -->
                                </Location>
                            </Centroid>
                        </StopPlaceEntrance>
                        <!-- More StopPlaceEntrance elements -->
                    </entrances>
                    <TransportMode>bus</TransportMode> <!-- See the section "General Noptis to Netex mappings" below -->
                    <tariffZones>
                        <TariffZoneRef ref="SE:005:TariffZone:9081005201004216" version="160620"/> <!-- Tariff zones this stop area belongs to , Noptis.JourneyPatternPointInZone aggregated on StopArea level -->
                    </tariffZones>
                    <StopPlaceType>busStation</StopPlaceType> <!-- See the section "General Noptis to Netex mappings" below -->
                    <Weighting>interchangeAllowed</Weighting> <!-- See the section "General Noptis to Netex mappings" below -->
                    <quays> <!-- Quay is based on Noptis.StopPoint and Noptis.JourneyPatternPoint -->
                        <Quay version="20180419" id="SE:253:Quay:9022005000001001"> <!-- version=Noptis.StopPoint.ExistsFromDate, id=Noptis.StopPoint.Gid -->
                            <ValidBetween>
                                <FromDate>2019-04-26T00:00:00</FromDate> <!-- Noptis.StopPoint.ExistsFromDate but not earlier than parent StopPlace.FromDate -->
                                <!-- ToDate = Noptis.StopPoint.ExistsToDate, in this case "ExistsToDate" is null, not later than parent StopPlace.ToDate -->
                            </ValidBetween>
                            <Name>Norr Tull</Name> <!-- Noptis.StopPoint.Name -->
                            <ShortName>Norr Tull</ShortName> <!-- Noptis.StopPoint.ShortName -->
                            <PrivateCode>1</PrivateCode> <!-- Noptis.StopPoint.LocalNumber -->
                            <Centroid>
                                <Location>
                                    <Longitude>16.177052</Longitude> <!-- Noptis.JourneyPatternPoint.LocationEastingCoordinate -->
                                    <Latitude>58.595038</Latitude> <!-- Noptis.JourneyPatternPoint.LocationNorthingCoordinate -->
                                </Location>
                            </Centroid>
                            <!-- WIP, Netex.ZoneProjections are based on Noptis.JourneyPatternPointInZone -->
                            <projections>
                                <ZoneProjection version="any" id="TEST:ZoneProjection:1">
                                    <ProjectedZoneRef ref="TEST:TopographicPlace:1"/>
                                </ZoneProjection>
                            </projections>
                            <PublicCode>A</PublicCode> <!-- Noptis.StopPoint.Designation -->
                            <equipmentPlaces> <!-- Based on Noptis ConnectionLink, ObstacleOnLink, BridgingDevice -->
                              <EquipmentPlace version="any" id="SE:001:EquipmentPlace:14010000311143397"> <!-- id = Noptis.BridgingDevice.Id -->
                                  <placeEquipments>
                                      <EntranceEquipment version="any" id="SE:001:EntranceEquipment:14010000311143397"> <!-- id = Noptis.BridgingDevice.Id -->
                                          <Door>true</Door> <!-- Noptis.BridgingDevice (TypeCode = DOOR) -->
                                      </EntranceEquipment>
                                  </placeEquipments>
                              </EquipmentPlace>
                            </equipmentPlaces>
                        </Quay>
                        <!-- More Quay elements -->
                    </quays>
                </StopPlace>
                <!-- More StopPlace elements -->
            </stopPlaces>
            <tariffZones>
                <TariffZone version="160620" id="SE:005:TariffZone:9081005201004216"> <!-- Noptis.Zone where TypeCode == "TARIFFZO". version=Noptis.Zone.ExistsFromDate id=Noptis.Zone.Gid -->
                    <ValidBetween>
                        <FromDate>2016-06-20T00:00:00</FromDate> <!-- existsFromDate -->
                    </ValidBetween>
                    <Name>Norrköping</Name> <!-- Name -->
                    <ShortName>Norrköping</ShortName> <!-- Shortname -->
                    <PrivateCode>1004216</PrivateCode> <!-- Number -->
                </TariffZone>
            </tariffZones>
            <navigationPaths> 
                <!-- NavigationPath is based on Noptis.ConnectionLink when 'From' and 'To' are both Quay references -->
                <!-- NavigationPath is based on Noptis.StationEntryLink when 'From' is a StopPlaceEntrance reference and 'To' is a Quay reference -->
                <!-- NavigationPath is based on Noptis.StationExitLink when 'From' is a Quay reference and 'To' is a StopPlaceEntrance reference -->
                <!-- NavigationPath may contain validityConditions and timebands if they have limited dates and opening hours -->  
                <NavigationPath version="20180504" id="SE:253:NavigationPath:55700000046273098"> <!-- version=Noptis.ConnectionLink.ExistsFromDate, id=Noptis.ConnectionLink.Id -->
                    <Distance>0</Distance> <!-- version=Noptis.ConnectionLink.DistanceMeters. If null, Distance will be 0 -->
                    <From>
                        <PlaceRef ref="SE:253:Quay:9022005000100216" version="20140218"/> <!-- version=Noptis.StopPoint.ExistsFromDate id=Noptis.StopPoint.Gid from Noptis.ConnectionLink.StartsAtJourneyPatternPoint -->
                    </From>
                    <To>
                        <PlaceRef ref="SE:253:Quay:9022005000102017" version="20181204"/> <!-- version=Noptis.StopPoint.ExistsFromDate id=Noptis.StopPoint.Gid from Noptis.ConnectionLink.EndsAtJourneyPatternPoint -->
                    </To>
                    <TransferDuration>
                        <DefaultDuration>PT6M</DefaultDuration> <!-- version=Noptis.ConnectionLink.DefaultDurationSeconds -->
                    </TransferDuration>
                    <AccessibilityAssessment version="20180504" id="SE:275:AccessibilityAssessment:4010000565163766"> <!-- SE:<producerNumber>:AccessibilityAssessment:<obstacleOnLinkId> , version=ObstacleOnLink.ExistsFromDate -->
                      <MobilityImpairedAccess>unknown</MobilityImpairedAccess>  <!-- Always unknown, required field but data is not available  -->
                      <limitations>
                          <AccessibilityLimitation>
                              <WheelchairAccess>unknown</WheelchairAccess> <!-- Always unknown, required field but data is not available  -->
                              <StepFreeAccess>false</StepFreeAccess>  <!-- BridgingDevice.TypeCode, “false” if there is a BridgingDevice for which TypeCode == 'STAIRWAY'.  -->
                              <EscalatorFreeAccess>unknown</EscalatorFreeAccess> <!-- BridgingDevice.TypeCode, “false” if there is a BridgingDevice for which TypeCode == 'ESCALAT'.  -->
                              <LiftFreeAccess>unknown</LiftFreeAccess> <!-- BridgingDevice.TypeCode, “false” if there is a BridgingDevice for which TypeCode == 'ELEVATOR'.  -->
                          </AccessibilityLimitation>
                      </limitations>
                   </AccessibilityAssessment>
                </NavigationPath>
                <NavigationPath version="20120623" id="SE:251:NavigationPath:14010000311143757"> <!-- version=Noptis.StationEntryLink.ExistsFromDate, id=Noptis.StationEntryLink.Id -->
                    <Distance>2.0</Distance> <!-- version=Noptis.StationEntryLink.DistanceMeters. If null, Distance will be 0 -->
                    <From>
                        <PlaceRef ref="SE:251:StopPlaceEntrance:9023001006651002" version="20120623"/> <!-- version=Noptis.StationEntrancePoint.ExistsFromDate id=Noptis.StationEntrancePoint.Gid -->
                    </From>
                    <To>
                        <PlaceRef ref="SE:251:Quay:9022003719007001" version="20150827"/> <!-- version=Noptis.StopPoint.ExistsFromDate id=Noptis.StopPoint.Gid from Noptis.StationEntryLink.EndsAtJourneyPatternPoint -->
                    </To>
                    <TransferDuration>
                        <DefaultDuration>PT3M1S</DefaultDuration> <!-- version=Noptis.StationEntryLink.DefaultDurationSeconds -->
                    </TransferDuration>
                </NavigationPath>
                <NavigationPath version="20120623" id="SE:251:NavigationPath:14010000311147186"> <!-- version=Noptis.StationExitLink.ExistsFromDate, id=Noptis.StationExitLink.Id -->
                    <Distance>3.0</Distance> <!-- version=Noptis.StationExitLink.DistanceMeters. If null, Distance will be 0 -->
                    <From>
                        <PlaceRef ref="SE:251:Quay:9022003719007002" version="20150827"/> <!-- version=Noptis.StopPoint.ExistsFromDate id=Noptis.StopPoint.Gid from Noptis.StationExitLink.StartsAtJourneyPatternPoint -->
                    </From>
                    <To>
                        <PlaceRef ref="SE:251:StopPlaceEntrance:9023001006661001" version="20120623"/> <!-- version=Noptis.StationEntrancePoint.ExistsFromDate id=Noptis.StationEntrancePoint.Gid -->
                    </To>
                    <TransferDuration>
                        <DefaultDuration>PT3M2S</DefaultDuration> <!-- version=Noptis.StationExitLink.DefaultDurationSeconds -->
                    </TransferDuration>
                </NavigationPath>
                <pathLinksInSequence>
                    <PathLinkInSequence order="1" version="any" id="SE:001:PathLinkInSequence:14010000311183662-1">
                        <LinkSequenceRef ref="SE:001:PathLink:14010000311183662-1" version="20120623"/> <!-- ref=Noptis.ConnectionLink.Id-1, version=Noptis.ConnectionLink.ExistsFrom -->
                    </PathLinkInSequence>
                    <PathLinkInSequence order="2" version="any" id="SE:001:PathLinkInSequence:14010000311183662-2">
                        <LinkSequenceRef ref="SE:001:PathLink:14010000311183662-2" version="20120623"/> <!-- ref=Noptis.ConnectionLink.Id-2, version=Noptis.ConnectionLink.ExistsFrom -->
                    </PathLinkInSequence>
                </pathLinksInSequence>
                <!-- More NavigationPath elements -->
            </navigationPaths>
            <pathLinks>
              <PathLink version="20120623" id="SE:001:PathLink:14010000311183662-1">  <!-- id=Noptis.ConnectionLink.Id-1, version=Noptis.ConnectionLink.ExistsFrom -->
                <ValidBetween>
                  <FromDate>2019-02-13T00:00:00</FromDate> <!-- Noptis.ConnectionLink.ExistsFromDate -->
                  <!-- ToDate = Noptis.ConnectionLink.ExistsToDate, in this case "ExistsToDate" is null -->
                </ValidBetween>
                <From>
                  <PlaceRef ref="SE:001:Quay:9022001070462002" version="20140603"/> <!-- id=Noptis.StopPoint.Gid, version=Noptis.StopPoint.Gid -->
                </From>
                <To>
                  <PlaceRef ref="SE:001:EquipmentPlace:14010000311143397" version="any"/> <!-- id=Noptis.BridgingDevice.id -->
                </To>
              </PathLink>
              <PathLink version="20120623" id="SE:001:PathLink:14010000311183662-2">  <!-- id=Noptis.ConnectionLink.Id-2, version=Noptis.ConnectionLink.ExistsFrom -->
                <From>
                  <PlaceRef ref="SE:001:EquipmentPlace:14010000311143397" version="any"/> <!-- id=Noptis.BridgingDevice.id -->
                </From>
                <To>
                  <PlaceRef ref="SE:001:Quay:9022001070462001" version="20140603"/> <!-- id=Noptis.StopPoint.Gid, version=Noptis.StopPoint.Gid -->
                </To>
              </PathLink>
            </pathLinks>
        </SiteFrame>
    </dataObjects>
</PublicationDelivery>

line_{Noptis.TransportAuthority.Number}_{Noptis.Line.Number}_
{Noptis.Line.Gid}.xml (line_253_53_9011005005300000.xml)

This is an example of a line file with explanations on how the different fields and elements are mapped to the Noptis format.

General Noptis to Netex mappings

Netex.ServiceJourney.TransportSubmode

Netex.ServiceJourney.TransportSubmode and Netex.Line.TransportSubmode is always mapped to UNKNOWN since that information is not available in NOPTIS.

Netex.ServiceLink.VehicleMode, Netex.ServiceJourney.TransportMode, Netex.Line.TransportMode

(Netex.AllModesEnumeration or Netex.AllVehicleModesOfTransportEnumeration)
Noptis.TransportModeCode.BUS = Netex.BUS
Noptis.TransportModeCode.TRAIN = Netex.RAIL
Noptis.TransportModeCode.TRAM = Netex.TRAM
Noptis.TransportModeCode.METRO = Netex.METRO
Noptis.TransportModeCode.TAXI = Netex.TAXI
Noptis.TransportModeCode.SHIP = Netex.WATER
Noptis.TransportModeCode.FERRY = Netex.WATER
Noptis.TransportModeCode.UNSPECIFIED = Netex.UNKNOWN

Netex.StopPlace.TransportMode

Netex.StopPlace.TransportMode has no corresponding field in Noptis. It is instead generated from the Noptis.StopArea.TypeCode:

Noptis.StopAreaTypeCode.AIRPORT = Netex.VehicleModeEnumeration.AIR
Noptis.StopAreaTypeCode.BUSTERM = Netex.VehicleModeEnumeration.BUS
Noptis.StopAreaTypeCode.FERRYBER = Netex.VehicleModeEnumeration.FERRY
Noptis.StopAreaTypeCode.SHIPBER = Netex.VehicleModeEnumeration.FERRY
Noptis.StopAreaTypeCode.METROSTN = Netex.VehicleModeEnumeration.METRO
Noptis.StopAreaTypeCode.RAILWSTN = Netex.VehicleModeEnumeration.RAIL
Noptis.StopAreaTypeCode.TRAMSTN = Netex.VehicleModeEnumeration.TRAM
Noptis.StopAreaTypeCode.TAXITERM = Netex.VehicleModeEnumeration.OTHER;
Noptis.StopAreaTypeCode.UNKNOWN = Netex.VehicleModeEnumeration.OTHER

Netex.StopPlace.StopPlaceType

Noptis.StopAreaTypeCode.AIRPORT = Netex.StopTypeEnumeration.AIRPORT
Noptis.StopAreaTypeCode.BUSTERM = Netex.StopTypeEnumeration.BUS_STATION
Noptis.StopAreaTypeCode.FERRYBER = Netex.StopTypeEnumeration.FERRY_STOP
Noptis.StopAreaTypeCode.SHIPBER = Netex.StopTypeEnumeration.FERRY_STOP
Noptis.StopAreaTypeCode.METROSTN = Netex.StopTypeEnumeration.METRO_STATION
Noptis.StopAreaTypeCode.RAILWSTN = Netex.StopTypeEnumeration.RAIL_STATION
Noptis.StopAreaTypeCode.TRAMSTN = Netex.StopTypeEnumeration.TRAM_STATION
Noptis.StopAreaTypeCode.TAXITERM = Netex.StopTypeEnumeration.OTHER
Noptis.StopAreaTypeCode.UNKNOWN = Netex.StopTypeEnumeration.OTHER

Netex.StopPlace.Weighting

Noptis.StopPlace.InterchangePriority is used to create the Netex.StopPlace.Weighting. Noptis.StopPlace.InterchangePriority is a value between 1 - 16. A lower number means higher priority in Noptis.

case 1, 2, 3, 4:
return PREFERRED_INTERCHANGE;
case 5, 6, 7, 8, 9, 10, 11, 12:
return RECOMMENDED_INTERCHANGE;
case 13, 14, 15, 16:
return INTERCHANGE_ALLOWED;
default: // interchangePriority < 1 or interchangePriority > 16, this is applicable for other formats than Noptis.
return NO_INTERCHANGE;

Netex.StopPointInJourneyPattern.ForAlighting

Noptis.ArrivalType.NO_STOP(0),
Noptis.ArrivalType.NO_ALIGHTING(1) = False

Noptis.ArrivalType.STOP_IF_ALIGHTING(2),
Noptis.ArrivalType.ALWAYS_STOP(3),
Noptis.ArrivalType.FLEXIBLE_ALIGHTING_UPTO_HERE(5) = True

Netex.StopPointInJourneyPattern.ForBoarding

Noptis.DepartureType.NO_STOP(0),
Noptis.DepartureType.NO_BOARDING(1) = False

Noptis.DepartureType.STOP_IF_BOARDING(2),
Noptis.DepartureType.ALWAYS_STOP(3),
Noptis.DepartureType.FLEXIBLE_BOARDING_FROM_HERE(5) = True

Netex.StopPointInJourneyPattern.RequestStop

True if Noptis.ArrivalType.STOP_IF_ALIGHTING(2) or Noptis.DepartureType.STOP_IF_BOARDING(2), otherwise false.