{"type":"doc","content":[{"type":"paragraph","content":[{"text":"This page contains documentation on how Samtrafiken exports data from its stops register in the NeTEx format according to the ","type":"text"},{"text":"Nordic NeTEx Profile","type":"text","marks":[{"type":"link","attrs":{"href":"https://enturas.atlassian.net/wiki/spaces/PUBLIC/pages/728891481/Nordic+NeTEx+Profile"}}]},{"text":". It also shows how this stops register data is mapped from Noptis (DOI/DII) data (see ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.noptis.com/"}},{"text":"), which is the format that many PTA:s use to deliver their data to Samtrafiken.","type":"text"}]},{"type":"paragraph","content":[{"text":"Aside from the mapping between different formats for the import and the export of this data, this dataset contains a mapping in itself, between local stops (which are reported in to Samtrafiken through Noptis, NeTEx etc) and national stops, which groups local stops from different operators together when these local stops describe the same national stop. This stops data export has the same structure as Samtrafikens regional NeTEx exports, which are documented in more detail here: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://samtrafiken.atlassian.net/wiki/spaces/SamtrafikenOpenData/pages/989233182"}},{"text":" .","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Example: Mapping stops together","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Company A delivers “Stockholm Central”. Company B delivers “Stockholms Central”. These two local stops are deemed to be the same stop (based on both automatic rules and/or manual adjustments) and grouped into 1 national stop “Stockholm Centralstation”. ","type":"text"}]},{"type":"paragraph","content":[{"text":"This national stop still contains references to the local stops which are included.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Since NeTEx-imports use the same terminology as this export, documentation regarding how terminologies of different datasets are mapped focusses on Noptis ↔︎ NeTEx. If you are not interested in mappings, but need documentation regarding the output format, please read the Trafiklab documentation ","type":"text"},{"text":"https://www.trafiklab.se/api/trafiklab-apis/stops-data/","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.trafiklab.se/api/trafiklab-apis/stops-data/"}}]},{"text":" .","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"This data has been enriched","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"This is data which has been enriched by Samtrafiken. Data from multiple datasources have been combined to obtain a complete dataset for the entire country. While Samtrafikens goal is to conserve the source data as much as possible, some fields may be changed manually to ensure correctness, especially when multiple stops of a single “owner” are combined.","type":"text"}]},{"type":"paragraph","content":[{"text":"See the comments below to see which fields are generated by Samtrafiken, which come straight from the source data, and which fields may have been modified.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you need unmodified local data, please see our regular NeTEx regional exports (","type":"text"},{"text":"https://www.trafiklab.se/api/trafiklab-apis/netex-regional/","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.trafiklab.se/api/trafiklab-apis/netex-regional/"}}]},{"text":" ,","type":"text"},{"type":"inlineCard","attrs":{"url":"https://samtrafiken.atlassian.net/wiki/spaces/SamtrafikenOpenData/pages/989233182"}},{"text":" ).","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Owners and data providers","type":"text"}]},{"type":"paragraph","content":[{"text":"Throughout the entire stop dataset, there are two important key-values: ","type":"text"},{"text":"owner","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"data-from","type":"text","marks":[{"type":"code"}]},{"text":". Samtrafikens stops register is based on the principle that the PTA who operates in a province is responsible for all stops in that province. This is the owner, indicated by its THM number, which ranges from 1 to 25. These numbers coincide with the province numbers defined by SCB: ","type":"text"},{"text":"https://www.scb.se/hitta-statistik/regional-statistik-och-kartor/regionala-indelningar/lan-och-kommuner/lan-och-kommuner-i-kodnummerordning/","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.scb.se/hitta-statistik/regional-statistik-och-kartor/regionala-indelningar/lan-och-kommuner/lan-och-kommuner-i-kodnummerordning/"}}]},{"text":". Typically, the owner provides data for its stops, and ","type":"text"},{"text":"data-from","type":"text","marks":[{"type":"code"}]},{"text":" matches ","type":"text"},{"text":"owner","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"However, in some cases a stop is reported by another PTA before the owner has defined this stop in their province. In these cases, this can be seen in the ","type":"text"},{"text":"data-from","type":"text","marks":[{"type":"code"}]},{"text":" field, where the THM number of the providing PTA is stored. This is not limited to the numeric range from 1 to 25, as even private operators can be the first to provide a stop place. As soon as the owner starts delivering data for this stop, the owner will take over as data provider. The ","type":"text"},{"text":"data-from","type":"text","marks":[{"type":"code"}]},{"text":" key-value will then start matching ","type":"text"},{"text":"owner","type":"text","marks":[{"type":"code"}]},{"text":" key value. In the case described here when a stop is reported by another PTA than the owner, the new stop gets a key-value ","type":"text"},{"text":"preliminary","type":"text","marks":[{"type":"code"}]},{"text":" which is set to true. When the the data has been verified as correct the ","type":"text"},{"text":"preliminary","type":"text","marks":[{"type":"code"}]},{"text":" key-value will disappear. ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Tariff Zones","type":"text"}]},{"type":"paragraph","content":[{"text":"For PTAs which deliver tariff zone information to Samtrafiken, Tariff zones are included in the stops data as well. A full example can be found at the bottom of this page.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n \n 2020-06-15T00:00:00 \n \n Jönköping \n \n 6:981 \n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Multimodal Stop places","type":"text"}]},{"type":"paragraph","content":[{"text":"In NeTEx, Quays (Noptis StopPoints) do not have any way to define the stop type / transport type. Instead, this is defined on StopPlace level, and identical for all quays. This works well for stop places with only one type of transport, for example a bus stop along the road.","type":"text"}]},{"type":"paragraph","content":[{"text":"Certain StopPlace objects however, such as train stations with connected bus stations (e.g. “resecentrum”), have multiple modes of transportation. In the NeTEx format, these multimodal stop place are represented by a parent StopPlace, which does not have any quays, and child StopPlace objects, one per transport mode. This way, all the quays belong to a StopPlace with the correct transport mode, while still being grouped together into 1 parent stop StopPlace. ","type":"text"}]},{"type":"paragraph","content":[{"text":"An example for a single-modal stop, Jönköping Kungsgatan, and a multimodal stop, Knivsta station, is shown in the diagram below, as well as in the code example below","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":454,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":454,"alt":"bild-20241111-121936.png","id":"83b80100-a19f-4e6e-92ab-32f408b55891","collection":"contentId-3701309442","type":"file","height":590}},{"type":"caption","content":[{"text":"Knivsta station, which has 2 train tracks and 5 bus stops","type":"text"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"drawio","parameters":{"macroParams":{"mVer":{"value":"2"},"zoom":{"value":"1"},"simple":{"value":"0"},"inComment":{"value":"0"},"custContentId":{"value":"4382490725"},"pageId":{"value":"3701309442"},"lbox":{"value":"1"},"diagramDisplayName":{"value":"Untitled Diagram-1731326207060.drawio"},"contentVer":{"value":"4"},"revision":{"value":"4"},"baseUrl":{"value":"https://samtrafiken.atlassian.net/wiki"},"diagramName":{"value":"Untitled Diagram-1731326207060.drawio"},"pCenter":{"value":"0"},"width":{"value":"1081"},"links":{"value":""},"tbstyle":{"value":""},"height":{"value":"721"}},"macroMetadata":{"macroId":{"value":"d288fae2-0a31-4aa7-b362-316194fd26f2"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"https://ac.draw.io/connectImage?mVer=2&zoom=1&simple=0&inComment=0&custContentId=4382490725&pageId=3701309442&lbox=1&diagramDisplayName=Untitled+Diagram-1731326207060.drawio&contentVer=4&revision=4&baseUrl=https%3A%2F%2Fsamtrafiken.atlassian.net%2Fwiki&diagramName=Untitled+Diagram-1731326207060.drawio&pCenter=0&width=1081&links=&tbstyle=&height=721"}}],"title":"draw.io Diagram"}},"localId":"aa4c7bd9-c23d-4cad-b9f8-995b24ba811c"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"XML example","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"marks":[{"type":"breakout","attrs":{"mode":"full-width"}}],"content":[{"text":"\n \n 2023-06-29T07:57:33 \n SAM \n \n \n \n 2005-01-01T00:00:00 \n \n \n \n SE:050 \n http://www.samtrafiken.se/ns/sweden \n \n \n \n \n Europe/Stockholm\n se\n \n 4326 \n \n \n \n NO\n \n Norway\n \n country\n \n \n \n SE\n \n Sweden\n \n country\n \n \n \n 01\n SE-01\n \n Stockholms län\n \n county\n \n \n \n \n 0160\n \n Täby kommun\n \n municipality\n \n \n \n \n 0162\n \n Danderyds kommun\n \n municipality\n \n \n \n \n \n \n \n \n \n 2020-06-15T00:00:00 \n \n \n \n \n owner\n 6 \n \n \n data-from\n 6 \n \n \n rikshallplats\n 740023267 \n \n \n stip.StopArea.DefaultInterchangeDurationSeconds\n 0 \n \n \n local-name \n 6:9021006001317000:Kungsgatan|14:9021014075317000:Kungsgatan\n \n \n local-gid \n 6:9021006001317000|14:9021014075317000\n \n \n local-number \n 6:1317|14:75317\n \n \n sellable\n false \n \n \n Kungsgatan \n Kungsgatan \n 18042 \n \n \n 14.154820\n 57.779054\n \n \n \n \n Kungsgatan \n KUN \n \n \n \n bus\n \n \n \n \n \n onstreetBus\n interchangeAllowed\n \n \n \n \n stip.StopPoint.ExistsFromDate\n 2020-06-15\n \n \n stip.StopPoint.ExistsUpToDate\n null\n \n \n local-journeypatternpoint-gid\n 6:9025006000131701|14:9025014007531701\n \n \n local-stoppoint-gid\n 6:9022006001317001|14:9022014075317001\n \n \n local-designation\n 6:A|14:A\n \n \n Kungsgatan\n Kungsgatan\n 1\n \n \n 14.155801\n 57.778923\n \n \n A \n \n \n \n \n \n Kungsgatan\n Kungsgatan\n 2\n \n \n 14.153855\n 57.779194\n \n \n B\n \n \n \n \n \n 2022-12-10T00:00:00 \n \n \n \n \n owner\n 3 \n \n \n data-from\n 3 \n \n \n rikshallplats\n 740000559 \n \n \n trafikverket-name\n Knivsta \n \n \n trafikverket-signatures\n KN \n \n \n stip.StopArea.DefaultInterchangeDurationSeconds\n 240 \n \n \n local-name \n 3:9021003780050000:Knivsta station (Knivsta)|1:9021001005006000:Knivsta|1:9021001068633000:Knivsta\n station|74:9021074005590000:Knivsta|100:9021074000559000:Knivsta station|159:9021001000559000:Knivsta\n \n \n \n local-gid \n 3:9021003780050000|1:9021001005006000|1:9021001068633000|74:9021074005590000|100:9021074000559000|159:9021001000559000\n \n \n \n local-number\n 3:780050|1:5006|1:68633|74:5590|100:559|159:559\n \n \n sellable\n true|false \n \n \n Knivsta station (Knivsta) \n Knivsta station\n 559 \n \n \n 17.787276\n 59.726035\n \n \n \n \n Knivsta station (Knivsta) \n Kni \n \n \n \n rail \n railStation \n preferredInterchange \n \n \n \n \n \n 2022-12-10T00:00:00\n \n \n \n \n Knivsta station (Knivsta)\n Knivsta station\n 559 \n \n \n 17.787276\n 59.726035\n \n \n \n \n Knivsta station (Knivsta)\n Kni\n \n \n \n \n bus \n onstreetBus \n preferredInterchange\n \n \n \n \n stip.StopPoint.ExistsFromDate\n 2021-03-07 \n \n \n stip.StopPoint.ExistsUpToDate\n null \n \n \n local-journeypatternpoint-gid\n 3:9025003078005001|1:9025001000068635 \n \n \n local-stoppoint-gid\n 3:9022003780050001|1:9022001068633002 \n \n \n local-designation\n 3:A|1:B \n \n \n Knivsta station \n Knivsta station \n 1 \n \n \n 17.786599 \n 59.727518 \n \n \n A \n \n \n \n \n stip.StopPoint.ExistsFromDate\n 2021-03-07\n \n \n stip.StopPoint.ExistsUpToDate\n null\n \n \n local-journeypatternpoint-gid\n 3:9025003078005002|1:9025001000068634\n \n \n local-stoppoint-gid\n 3:9022003780050002|1:9022001068633001\n \n \n local-designation\n 3:B|1:A\n \n \n Knivsta station\n Knivsta station\n 2\n \n \n 17.786305\n 59.727047\n \n \n B\n \n \n \n \n \n \n \n \n \n \n \n 2022-12-10T00:00:00\n \n \n \n \n Knivsta station (Knivsta)\n Knivsta station\n 559\n \n \n 17.787276\n 59.726035\n \n \n \n \n Knivsta station (Knivsta)\n Kni\n \n \n \n \n rail \n railStation\n preferredInterchange\n \n \n \n \n stip.StopPoint.ExistsFromDate\n 2021-03-07\n \n \n stip.StopPoint.ExistsUpToDate\n null\n \n \n local-journeypatternpoint-gid\n 3:9025003078005005|1:9025001000005009|74:9025074005590020\n \n \n local-stoppoint-gid\n 3:9022003780050005|1:9022001005006002|74:9022074005590020\n \n \n local-designation\n 3:2|1:2|74:2\n \n \n Knivsta station\n Knivsta station\n 4\n \n \n 17.787219\n 59.725067\n \n \n 2\n \n \n \n \n \n \n \n \n \n \n \n \n 2020-06-15T00:00:00 \n \n Jönköping \n \n 6:981 \n \n \n \n \n","type":"text"}]}],"version":1}

Browser not supported