Île-de-France Mobilités broadcasts real-time data on its media, including the PRIM platform. They concern thetimes of upcoming public transport passages and information messages concerning traffic.
Real-time data disseminated by Île-de-France Mobilités comes from carriers
These real-time data, Île-de-France Mobilités receives them from transporteurs Groupe (SNCF, RATP, Transdev, Keolis, etc.) or independent carriers (Albatrans, Stivo, etc.). Indeed, transport operators have Systèmes d'Aides à l'Exploitation et à l'Information Voyageurs (SAEIV) which enable, among other things:
- Guide drivers by GPS,
- Geolocate transports in real time on the line,
- Calculate the delay or advance of the transport in relation to the theoretical schedule.
Data from these systems are aggregated within concentratorswhen the carrier is a group (SNCF, RATP, etc.) or transit directly through the Relais Informations Voyageurs en Temps Réel(Relais IVTR) when they are independent carriers.
The Relais IVTR centralizes the data transmitted by the carriers and then disseminates it in SIRI Lite
The Relais IVTR, in operation since 2015, serves as orchestrator of the data transmitted by the various carriers. It centralizes the exchange of data between carriers, collects the data and disseminates it in the SIRI Lite : format, a standard that defines the protocol for exchanging Real Time information for public transport. This format lends itself easily to querying via APIs and then reusing the data.
After passing through the IVTR Relay, real-time data is therefore disseminated on the media of Île-de-France Mobilités(PRIM platform, mobile application, etc).
Data from Relais IVTR are also broadcast on screens in transport spaces. To note that a certain amount of real-time passenger information is broadcast directly on the screens in stations without first passing through the Relais IVTR.
As illustrated in the diagram above, real-time data broadcast on the PRIM platform comes from the Relais IVTR which is fed by the concentratorsand SAEIV carriers. Thus, if one of these data sources upstream from the PRIM platform is unavailable, certain real-time data cannot go up to the PRIM platform.
The PRIM portal distributes real-time data from Relais IVTR through APIs
On the PRIM portal, real-time data is accessible via APIs. In order to query them, it is necessary to have an account on the PRIM platform,be logged in and generate an API key.
The API source Île-de-France Mobilités available on the PRIM platform pulls up real-time data from the IVTR relay. Here's a brief description of each of them and some advice on how to use them:
- Upcoming passages (Île-de-France Mobilités platform) - Unitary query: This API provides the estimated real-time timeofnext passageof a public transport line at agiven stop. The API call can be parameterized according to the boarding zone, the stop zone or the transfer zone. However, for RER and Transilien trains, requests to stop or transfer zones are to be preferred. This is because SNCF feeds data to a fictitious boarding zone that represents the entire station. The quota of requests on this API is 1,000,000 per day.
- Upcoming passages (Île-de-France Mobilités platform) - Global request : This API reassembles in one single exchange and in real time, the times of upcoming passagesof the lines at all currently available stops in the Ile-de-France transport network. This data is updated every minute. We recommend that you request this API via a query interface or script. Indeed, the query wizard available on the PRIM platform is not usable for this API, whose response size is too consequent. The quota of requests on this API is 1,000 per day.
- Messages displayed on screens (Île-de-France Mobilités platform) : This API retrieves information messages concerning traffic conditions, displayed in real timeon the screens of transport spaces. The quota for requests to this API is 20,000 per day. However, this service is currently only available on a weak part of the Ile-de-France network. So, to track the exhaustiveness of circumstantial traveler information, we invite you to turn instead to the API "Calculator Ile-de-France Mobilités - Trafic messages ".
To date, these APIs cover 88% of the Ile-de-France network. All stops on the network will gradually become available.
In order to find out which stops (by carrier or by line) are currently covered by these APIs, please feel free tolog in to your account on the PRIM platform and then consult the following static dataset: perimeter of real-time data available on the Île-de-France Mobilités exchange platform.
If you would like more information about the SIRI Lite format, the Île-de-France Mobilités source APIs and their precautions for use please feel free to consult this documentation which is also available on the "Need help" page of the PRIM platform.
One of the APIs of the PRIM platform remounts real-time data without going through the Relais IVTR
The API "Ile-de-France Mobilités Calculator - Trafic messages" is based on Hove's Navitia technology. The real-time circumstantial traveler information it returns comes directly from the carriers and does not transit through the Relais IVTR. Thus, results are returned as JSON objects.
This API groups together information messages concerning real-time traffic status, by line or mode of transport. It provides all information concerning traffic disruptions (incidents, scheduled and unscheduled work, etc.). It is a source at the base of the data disseminated onthe Île-de-France Mobilités media (the Île-de-France Mobilités mobile app, the "Me déplacer", website etc.).
The quota of requests on this API is 20,000 per day.
To better understand the Navitia APIs and their precautions for use please feel free to consult this documentation (also available on the "Need help" page of the PRIM platform)as well as the documentation of Navitia.
Feel free to query the PRIM platform APIs and then share your data Reuses with us via the channel #data-reuses from the "Slack" of the "PRIM community".
We remain of course available to welcome your comments and answer your questions at [email protected] but also on the"Slack" of the "PRIM community", which you can join by following this link.