Real-Time Data
These APIs allow your server to subscribe to real-time data from all included real-time feeds in Norway on SIRI 2.0. It is available as SIRI XML, SIRI Lite (REST) and GTFS-RT.
Available data streams
| SIRI | GTFS-RT | ||||||
|---|---|---|---|---|---|---|---|
| Codespace | Source | ET | VM | SX | Trip Updates | Vehicle Positions | Service Alerts |
| Entire Norway | |||||||
| AKT | Agder (AKT) | ||||||
| ATB | Trøndelag (AtB) | ||||||
| AVI | Avinor | ||||||
| BNR | Vy/Flytoget/Go-Ahead/SJ Nord (via Bane NOR) | ||||||
| BRA | Viken (Brakar) | ||||||
| FIN | Troms og Finnmark (Snelandia) | ||||||
| FLT | Flytoget | ||||||
| GJB | Vy (formerly NSB) Gjøvikbanen | ||||||
| GOA | Go-Ahead | ||||||
| INN | Innlandet (Innlandstrafikk) | ||||||
| KOL | Rogaland (Kolumbus) | ||||||
| MOR | Møre og Romsdal (Fram) | ||||||
| NBU | Connect Bus Flybuss | ||||||
| NOR | Nordland fylkeskommune | ||||||
| NSB | Vy | ||||||
| OST | Viken (Østfold kollektivtrafikk) | ||||||
| RUT | Oslo region (Ruter) | ||||||
| SJN | SJ Nord | ||||||
| SKY | Vestland (Skyss) | ||||||
| SOF | Vestland (Kringom) | ||||||
| TEL | Vestfold og Telemark (Farte) | ||||||
| TRO | Troms og Finnmark (Troms fylkestrafikk) | ||||||
| VKT | Vestfold og Telemark (VKT) | ||||||
| VOT | Vestfold og Telemark | ||||||
| VYB | Vy Buss (SE) | ||||||
| VYG | Vy Group | ||||||
| VYX | Vy Express | ||||||
SIRI
SIRI is a CEN Technical Standard that specifies a European interface standard for exchanging information about the planned, current or projected performance of real-time public transport operations between different computer systems.
Publish/subscribe
When using publish/subscribe you'll first get one (or more) set with initial data, and then continuous updates with changes. This option requires an accessible endpoint which accepts HTTP POST requests from the Entur SIRI service.
Request/response
For Request/Response, the <RequestorRef> attribute is used to track changes and must therefore remain the same for all subsequent requests in order to only get changes. The attribute MoreData=true means the data comes in bunches, just like paging, and more data can be fetched immediately after the first "page" is received. Eg. if there are 20,000 objects, these will be split up in smaller parts and repeated requests are needed to get the full set.
Types of data
ET – Estimated Timetable
Real-time estimates for each service journey. Included are planned-, actual- and estimated departure times, cancellations and changes in stop patterns.
VM – Vehicle Monitoring
Vehicle-centric real-time data with the position of a vehicle, as well as any deviation from scheduled timetable on a given departure.
SX – Situation Exchange
Textual messages displayed to end users. They are always associated with a departure, line, stop etc., or combinations of these.
SIRI Lite
With simple HTTP GET calls to retrieve data, you can use the requestorId URL-parameter to only retrieve changes made since the last time you asked. If you do not use this, you will always get the full dataset, not just the first time you make a request. You must use a unique UUID.
More information
SIRI standard: http://www.transmodel-cen.eu/standards/siri/
Norwegian SIRI-profile: https://enturas.atlassian.net/wiki/spaces/PUBLIC/pages/637370420/Norwegian+SIRI+profile.
Example SIRI-XML that follow the Norwegian SIRI-profile: https://github.com/entur/profile-norway-examples/tree/master/siri/
GTFS-RT
GTFS Realtime is a feed specification that allows public transportation agencies to provide realtime updates about their fleet to application developers. It is an extension to GTFS (General Transit Feed Specification), an open data format for public transportation schedules and associated geographic information.
Request/response
Only supports request/response currently. Endpoints exist for each data type that download the full dataset, filtered by datasource (codespace) if provided. This dataset is updated every 15 seconds. Later we will support publish/subscribe and continuous updates.
Types of data
Trip updates
Delays, cancellations, changed routes. Similar to SIRI ET.
Vehicle positions
Information about the vehicles including location and congestion level. Similar to SIRI VM.
Service alerts
Stop moved, unforeseen events affecting a station, route or the entire network. Similar to SIRI SX.
More information
- GTFS-RT documentation: https://developers.google.com/transit/gtfs-realtime
- Trip updates example: https://developers.google.com/transit/gtfs-realtime/examples/trip-updates-full