Les API Prochains Passages
Structure des requêtes - Paramètres d’appel
Service prochains passages – Requête unitaire
Stop (requis)
Ce service permet d’obtenir les prochains horaires de passages en temps réel d’un arrêt donné.
Les paramètres d'appel tolérés sont tous les niveaux d’arrêts décrits dans le Référentiel des arrêts d’Île-de-France (arrets.xls), à savoir :
- ARr, zone d'embarquement (anciennement ZDER) : « STIF:StopPoint:Q:[ArRId]: » Exemple : Quais M4 - Châtelet : STIF:StopPoint:22092: (aller) et STIF:StopPoint:463158: (retour)
Attention:
Un quai contient 2 identifiants de zone d’embarquement (ArRId) différents : un pour le sens aller et un pour le sens retour. Une requête sur un quai renverra les prochains passages dans une unique direction.
Pour les gares RER et Transilien, la SNCF renseigne les données à un ArR fictif qui représente toute la gare. --> Privilégier des requêtes aux ZdA / ZdC
- ZdA , zone d’arrêts monomodale (anciennement ZDL : Zone de lieu) : « STIF:StopArea:SP:[ZdAId]: » Exemple Zone d’arrêts Metro – Châtelet : STIF:StopArea:SP:42587:
- ZdC (zone de correspondance multimodale) « STIF:StopArea:SP:[ZdCId]: » Exemple Zone de correspondance – Châtelet : STIF:StopArea:SP:71264:
A noter:
- Le jeu de données Référentiel des arrêts : Arrêts propose les arrêts de référence du référentiel des arrêts d'Île-de-France.
- Le jeu de données Référentiel des arrêts : Relations propose l'ensemble des relations entre les objets du référentiel des arrêts d'Île-de-France.
- Le Jeu de données Périmètre des données temps réel disponibles expose la liste des arrêts par ligne/ transporteur concernés par ce service.
- Le jeu de données Arrêts et lignes associées liste toutes les lignes du réseau francilien et les arrêts desservis pour chacune de ces lignes comme dans le GTFS.
Ligne (optionnel)
Ce service permet d’obtenir les prochains horaires de passages en temps réel d’un arrêt donné, pour une ligne donnée.
Les paramètres d'appel tolérés sont les lignes décrites dans le Référentiel des lignes de transport en commun d'Île-de-France, à savoir :
- ID_Line, identifiant de référence de la ligne commerciale : « STIF:Line::[ID_Line]: » Exemple Ligne RER C : STIF:Line::C01727:
Service prochains passages – Requête globale
ALL (requis)
Ce service permet d’obtenir les prochains horaires de passages en temps réel de l'ensemble des arrêts du réseau.
Le seul paramètre d’appel toléré est : ALL. Exemple : LineRef=ALL
Attention:
L’assistant de requêtage disponible sur le portail PRIM n’est pas utilisable pour la requête globale, en vue de la taille de sa réponse. Nous vous recommandons de requêter cette API via une interface de requêtage ou un script.
A noter:
Le jeu de données Périmètre des données temps réel disponibles expose la liste des arrêts par ligne/ transporteur concernés par ce service.