La rentrée 2024 de PRIM est marquée par l'arrivée de deux nouvelles fonctionnalités. Dès à présent, pensez à renseigner votre&nbsp;<a href="http://prim.iledefrance-mobilites.fr/fr/organisations" rel="noreferrer">Organisation</a> et partager vos&nbsp;<a href="http://prim.iledefrance-mobilites.fr/fr/reutilisations" rel="noreferrer">Réutilisations</a> !

Découvrez les nouvelles fonctionnalités de PRIM !

&nbsp;Le service jeux de données a pour objectif de partager et d’ouvrir les données du transport d’Île-de-France Mobilités au&nbsp; grand public. Il regroupe un ensemble de jeux de données, de cartes du réseau et d’autres informations autour de la donnée du&nbsp; transport.​Le service des jeux de données&nbsp;en quelques chiffres :&nbsp;​<ul><li>Plus de 75 Jeux de données publiés​</li><li>Plus de 60 jeux de données produits par Ile-de France mobilités​</li><li>Plus de 3 millions de téléchargements par mois​​</li></ul><h2 id=""></h2><a href="http://prim.iledefrance-mobilites.fr/catalogue-data?type=jeu_de_donnees" rel="noreferrer">Découvrir les Jeux de données disponibles sur PRIM</a>

Explorer un jeu de données

Une organisation est une collectivité, un opérateur de transport, une entreprise, ou tout organisme qui produit ou réutilise des données du catalogue PRIM ( jeux de données, API ou widget) en format ouvert.<h3 id="la-d%C3%A9claration-des-organisations-un-partenariat-gagnant-gagnant%E2%80%8B">La déclaration des organisations, un partenariat gagnant-gagnant!​</h3>Pour vous : Mettre en avant votre organisation en tant que réutilisateur de données permet de donner de la visibilité à votre organisation et au travail réalisé; tout en inspirant d’autres organisations ou réutilisateurs. ​Pour IDFM : Mettre en avant les organisations des réutilisateurs de données permet de renforcer l’image de PRIM en tant que plateforme de référence pour les données de mobilités en Île-de-France. ​​Les utilisateurs de PRIM peuvent ainsi déclarer leur organisation afin que celle-ci soit visible sur PRIM : un utilisateur peut déclarer une seule organisation. ​

Qu'est-ce qu'une organisation ?

<h3 id="acc%C3%A9der-aux-organisations%E2%80%8B">Accéder aux organisations​</h3>La consultation et le partage des organisations est accessible à deux endroits sur le site PRIM : ​<ol><li>Depuis la page «&nbsp;Organisations&nbsp;» accessible via le menu «&nbsp;Données&nbsp;» du portail PRIM. ​</li><li>Depuis la page «&nbsp;Contribuer&nbsp;» du portail PRIM.​</li></ol><h3 id="d%C3%A9clarer-une-organisation%E2%80%8B">Déclarer une organisation​</h3>Pour déclarer l’organisation à laquelle vous appartenez, il vous suffit de cliquer sur le bouton «&nbsp;compléter le formulaire&nbsp;» depuis la page «&nbsp;Organisations&nbsp;» ou de cliquer sur le bouton «&nbsp;Déclarer votre organisation» depuis la page «&nbsp;contribuer&nbsp;». Il faudra ensuite vous connecter à votre compte PRIM, si ce n’est pas déjà le cas, puis compléter le formulaire de déclaration d'une organisation. ​Une fois le formulaire complété et soumis, celui-ci est traité par nos équipes qui pourront procéder à sa validation. Le délai de traitement est d’environ deux semaines. Lorsque votre demande de déclaration d'une organisation est validée, vous recevez un mail et l’organisation est automatiquement publiée et mise en avant sur PRIM.​<h3 id="refus-d%E2%80%99une-demande-de-d%C3%A9claration-d%E2%80%99organisation">Refus d’une demande de déclaration d’organisation</h3>Il peut arriver qu’une demande de déclaration d’organisation soit refusée. Lorsque votre demande de déclaration d’organisation est refusée, vous recevez un mail dans lequel le motif de refus est systématiquement indiqué et l’organisation n’apparaîtra pas sur PRIM.

Déclarer une organisation

<h3 id="modification-d%E2%80%99une-organisation">Modification d’une organisation</h3>Pour une raison ou une autre, le contenu d’une déclaration d’organisation, peut être modifiée par nos équipes avant ou après sa publication sur PRIM.​ Les éléments qui peuvent être modifiés sont par exemple le site ou la description de l’organisation. En fonction du degré d’importance de la modification apportée, vous serez prévenu ou pas, par mail de la modification effectuée à votre déclaration d’organisation.​Toutefois, il n’est pas possible de modifier des certaines informations telles que: le mail ou le type de l’organisation déjà publiée ou attente de validation. Il faudra nécessairement soumettre une nouvelle demande de déclaration d’organisation si vous souhaitez que des modifications soient apportées à ces éléments.​<h3 id="suppression-d%E2%80%99une-organisation-%E2%80%8B">Suppression d’une organisation ​</h3>Suite à une demande de votre part, ou bien pour une raison ou une autre, une organisation déjà publiée sur PRIM, peut être supprimées par nos équipes. Lorsque votre organisation est supprimée, vous recevez un mail dans lequel le motif de suppression est systématiquement indiqué et l’organisation n’est plus mise en avant sur PRIM.

Modifier et supprimer une organisation

Les organisations

Le système d’authentification pour les jeux de données permet à tous les utilisateurs de n’avoir qu’un seul et unique jeton d’authentification à insérer afin d’automatiser le téléchargement des jeux de données soumis à la Licence Mobilité.&nbsp;&nbsp;​​Les jeux de données soumis à cette licence sont identifiables via la mention «&nbsp;Connexion Requise&nbsp;» :&nbsp;Le système d’authentification pour les jeux de données à accès restreint sur le site «&nbsp;PRIM&nbsp;»1) L'accès à la page "Mes jetons d’authentification", qui vous permettra de générer ce jeton d’authentification, se fera directement depuis votre menu personnel, une fois connecté2) Une fois sur la page "Mes jetons d'authentification" sélectionnez l'onglet "JEUX DE DONNÉES" et cliquer sur&nbsp; "Générer un jeton"&nbsp;3) Une fois généré, vous pourrez voir le jeton dans son entièreté et le copier dans votre presse-papier (le jeton entier a été caché dans l’exemple ci-dessus)Le&nbsp;jeton précédemment généré sera toujours visible&nbsp;et ne sera pas&nbsp;masqué au rechargement de la page.&nbsp;​​Vous pouvez également regénérer votre jeton : il vous suffit de cliquer sur «&nbsp;générer mon nouveau jeton » puis sur «&nbsp;confirmer&nbsp;».&nbsp;​​Attention&nbsp;: ce jeton rendra le précédent jeton obsolète.&nbsp;4) Une fois votre jeton généré sur le site PRIM, il vous suffit de sélectionner "API Key" comme type d'authentification, puis de renseigner :&nbsp;​<ul><li>"Authorization" dans le champ "Key"&nbsp;​</li><li>"apikey" + la valeur de votre clé (les deux devant être séparés d'un espace comme illustré sur la capture) dans le champ "Value"&nbsp;</li></ul><figure class="kg-card kg-image-card kg-card-hascaption"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/10/jdd-lien.png" class="kg-image" alt="" loading="lazy" width="1394" height="525" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/10/jdd-lien.png 600w, http://prim.iledefrance-mobilites.fr/content/images/size/w1000/2024/10/jdd-lien.png 1000w, http://prim.iledefrance-mobilites.fr/content/images/2024/10/jdd-lien.png 1394w" sizes="(min-width: 720px) 720px"><figcaption>Exemple sur l'application Postman</figcaption></figure>

Générer un jeton pour accéder aux jeux de données restreints

Les jeux de données

Le service API a pour objectif de partager les données dynamiques de transport au grand public. Le service API regroupe un ensemble de données théoriques et en temps réel sur les thématiques d’horaires de prochains passages, de recherche d’itinéraires et de lieux, de perturbations, de calcul d’isochrones, d’exploration du réseau de transport d’Ile-de France.Le service des API en quelques chiffres: ​<ul><li>Plus de 8 API publiées​</li><li>Plus de 6 API produites par Ile-de France mobilités​</li><li>Plus de 170 millions de requêtes par mois​</li></ul>​<a href="http://prim.iledefrance-mobilites.fr/fr/catalogue-data?type=api" rel="noreferrer">Découvrir les API disponibles sur PRIM</a>

Explorer les API

<ul><li>Les quotas d’appels sont à la journée et à la seconde: il est fortement recommandé de lisser le nombre de requêtes dans le temps afin de ne pas perturber le fonctionnement pour les autres utilisateurs.</li><li>Compte tenu de la taille très importante de la réponse à la requête globale «&nbsp;Prochains Passages&nbsp;» , elle sera transmise en mode compressé.</li><li>Il est recommandé d’activer dans les headers de vos requêtes l’élément «&nbsp;Accept-encoding : gzip, deflate&nbsp;» afin d’optimiser le temps de réponse de l’API.</li></ul>

Bonnes pratiques d'utilisation des API

La page «&nbsp;Notre offre&nbsp;»​Il existe sur PRIM dans la rubrique « Données&nbsp;»,&nbsp; une page «&nbsp;Notre offre&nbsp;» qui met à disposition l'offre d'Île-de-France Mobilités dédiée aux API disponibles dans le catalogue. Sur cette page, vous pouvez retrouver les quotas de requêtes mensuelles et/ou quotidiennes pour chacune des API du catalogue. Pour information, aucune redevance n’est demandée par d’Île-de France Mobilités aux utilisateurs des API du portail PRIM.​<figure class="kg-card kg-image-card kg-card-hascaption"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/10/NOTRE-OFFRE.png" class="kg-image" alt="" loading="lazy" width="814" height="679" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/10/NOTRE-OFFRE.png 600w, http://prim.iledefrance-mobilites.fr/content/images/2024/10/NOTRE-OFFRE.png 814w" sizes="(min-width: 720px) 720px"><figcaption>Extrait de la page <a href="http://prim.iledefrance-mobilites.fr/fr/notre-offre" rel="noreferrer">Notre offre</a></figcaption></figure>La page «&nbsp;État des API&nbsp;»​Toujours dans la rubrique « Données&nbsp;» de PRIM, la page «&nbsp;État des API&nbsp;» affiche la disponibilité à l’instant T et également sur les 30 derniers jours des API​. ​Les indicateurs (en pourcentage) présentés sur cette page, permettent de connaitre l’état des services des API concernées mais n’évaluent pas la qualité des données diffusées.​La page « État des API » contient également une section « Agenda » qui permet d’informer les utilisateurs des prochaines interruptions de services prévues liées à des mises en production, des corrections d’anomalies etc… ​​<figure class="kg-card kg-image-card kg-card-hascaption"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/10/APICapture.png" class="kg-image" alt="" loading="lazy" width="710" height="422" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/10/APICapture.png 600w, http://prim.iledefrance-mobilites.fr/content/images/2024/10/APICapture.png 710w"><figcaption>Extrait de la page <a href="http://prim.iledefrance-mobilites.fr/fr/etat-des-api" rel="noreferrer">Etat des API</a></figcaption></figure>La page «&nbsp;Ma consommation d’API »​Une fois la connexion effectuée sur PRIM, la page «&nbsp;Ma consommation d’API&nbsp;» devient disponible depuis son espace. Deux services distincts sont accessibles depuis cette page : «&nbsp;Mon suivi&nbsp;» et «&nbsp;Mes alertes&nbsp;». Le premier permet de suivre visuellement sa consommation d’API. Les quotas sont séparés entre les API à quotas journaliers et les API à quotas mensuels. ​ Le deuxième service, «&nbsp;Mes alertes&nbsp;», permet de recevoir un mail d’alerte dès lors qu’un certain seuil d’utilisation des quotas a été franchi, afin d’anticiper d’éventuels dépassements de quotas.<figure class="kg-card kg-image-card kg-card-hascaption"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/10/quotas.png" class="kg-image" alt="" loading="lazy" width="859" height="734" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/10/quotas.png 600w, http://prim.iledefrance-mobilites.fr/content/images/2024/10/quotas.png 859w" sizes="(min-width: 720px) 720px"><figcaption>Extrait de la page <a href="http://prim.iledefrance-mobilites.fr/fr/ma-consommation-api" rel="noreferrer">Ma consommation API</a></figcaption></figure>Depuis cette page, il vous est possible d'augmenter vos quotas API si votre consommation le nécessite.

Services PRIM associés aux API

Le système d’authentification pour les données dynamiques permet à tous les utilisateurs des API ou widget de n’avoir qu’un seul et unique jeton d’authentification à insérer dans leurs requêtes API.<ul><li>L’accès à la page "Mes jetons d’authentification", qui vous permettra de générer ce jeton d’authentification, se fera directement depuis votre menu personnel, une fois connecté.</li><li>Une fois sur la page "Mes jetons d'authentification", au sein de l'onglet "API" un bouton «&nbsp;Générer mon jeton" vous permettra de générer ce jeton.&nbsp;</li><li>Une fois généré, vous pourrez voir le jeton dans son entièreté (le jeton entier a été caché dans l’exemple ci-contre)</li><li>Le jeton précédemment généré ne sera visible qu’une seule fois dans son entièreté : vous avez donc la possibilité de le copier afin de le coller dans un&nbsp;endroit sûr.&nbsp;</li><li>Après avoir généré votre premier jeton, vous avez la possibilité de n’en apercevoir qu’une partie (4 premiers et 4 derniers caractères) en actualisant ou en revenant sur la page.​</li><li>Vous pouvez regénérer votre jeton d’API si vous avez perdu le premier jeton : il vous suffit de cliquer sur «&nbsp;Générer un nouveau jeton d’API&nbsp;».&nbsp;​</li></ul>​Attention : ce jeton rendra le précédent jeton obsolète et ne sera visible dans son entièreté qu’une seule fois&nbsp;Une fois votre jeton généré sur le site PRIM, il vous suffit d’ajouter le champ «&nbsp;API Key&nbsp;» dans le header de votre requête et de renseigner la clé générée dans la partie «&nbsp;Value&nbsp;»&nbsp;<figure class="kg-card kg-image-card kg-card-hascaption"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/10/CAPTUREAPI.png" class="kg-image" alt="" loading="lazy" width="1365" height="506" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/10/CAPTUREAPI.png 600w, http://prim.iledefrance-mobilites.fr/content/images/size/w1000/2024/10/CAPTUREAPI.png 1000w, http://prim.iledefrance-mobilites.fr/content/images/2024/10/CAPTUREAPI.png 1365w" sizes="(min-width: 720px) 720px"><figcaption>Exemple sur l'application Postman</figcaption></figure>

Générer un jeton pour accéder aux API

Les API

Le service Widget a pour objectif de mettre à disposition du grand public des services sous forme d’applications interactives ou de sites internet. Les réutilisateurs des widgets disponibles sur PRIM peuvent ainsi faire bénéficier à leurs consommateurs ou clientèle direct de services PRIM dans le cadre de leur activité.​Il existe aujourd'hui un widget disponible sur PRIM qui est : la marque blanche Recherche d'itinéraires

Découvrir le service des widgets sur PRIM

La marque blanche "Recherche d'itinéraires" d'Île-de-France Mobilités vous permet d'intégrer facilement ce widget sur votre site internet et de faire ainsi bénéficier à vos utilisateurs d'un calculateur d'itinéraire multimodal pour leurs trajets.​ La page "<a href="http://pprod.prim.iledefrance-mobilites.fr/fr/widgets/idfm-marque_blanche-a?tab=integration&ref=prim.iledefrance-mobilites.fr">Intégration</a>" de la marque-Blanche vous permettra de comprendre comment intégrer la marque-blanche "recherche d'itinéraires" à votre site internet.L'utilisation de la marque blanche "recherche d'itinéraire" est conditionnée par la détention d'un compte utilisateur sur le site <a href="https://pprod.connect.iledefrance-mobilites.fr/auth/realms/connect-b2b/protocol/openid-connect/auth?client_id=prim&redirect_uri=https%3A%2F%2Fpprod.prim.iledefrance-mobilites.fr%2Ffr%2Faide-et-contact%2Fdocumentation%2Fdonnees-disponibles%2Fapi%2Fgenerer-un-jeton-pour-acceder-aux-api&response_type=code&scope=openid+email&ref=prim.iledefrance-mobilites.fr">PRIM</a>&nbsp;et la <a href="http://pprod.prim.iledefrance-mobilites.fr/fr/mes-jetons-authentification?ref=prim.iledefrance-mobilites.fr">génération d'un jeton d'API</a> . Pour générer un jeton d'API sur PRIM nous vous invitons à consulter plus haut&nbsp;la rubrique "<a href="http://pprod.prim.iledefrance-mobilites.fr/fr/aide-et-contact/documentation/donnees-disponibles-2/explorer-les-api/generer-un-jeton-pour-acceder-aux-api?ref=prim.iledefrance-mobilites.fr" rel="noreferrer">Générer un jeton pour accéder aux API</a>".Exemple d'intégration&nbsp;de la marque blanche "Recherche d'itinéraires" d'Île-de-France Mobilités sur un site internet :<figure class="kg-card kg-image-card kg-card-hascaption"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/10/image-3.png" class="kg-image" alt="" loading="lazy" width="605" height="362" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/10/image-3.png 600w, http://prim.iledefrance-mobilites.fr/content/images/2024/10/image-3.png 605w"><figcaption>Image du site internet <a href="https://www.sortiraparis.com/?ref=prim.iledefrance-mobilites.fr" rel="noreferrer">Sortir à paris</a></figcaption></figure>

Prise en main de la Marque-Blanche Recherche d'itinéraires

Les widgets

Données disponibles

La Plateforme d’échanges Île-de-France Mobilités récolte les informations, les diffuse aux autres transporteurs, les met à disposition de tous.Les services Les API Prochains passages offrent des données concernant :​<ul><li><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer">Les</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer">prochains</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer">passages</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer">pour</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer">toutes</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer">les</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer">lignes</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer">disponibles</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer">sur</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> le</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> </a><a href="http://rec.prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale?ref=prim.iledefrance-mobilites.fr" rel="noreferrer">réseau</a>​</li><li><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer">Les</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer">prochains</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer">passages</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer"> à</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer">un</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer"> </a><a href="http://rec.prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire?ref=prim.iledefrance-mobilites.fr" rel="noreferrer">arrêt</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer">particulier</a>​</li></ul>Autres données disponibles utiles pour requêter les API Prochains passages :​Pour connaitre les données relatives aux référentiels (arrêts et lignes), disponible sur le portail d’Île-de-France Mobilités, suivez <a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">ce</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> lien</a>.​La liste des données disponibles est mise à jour toutes les semaines.​​<ul><li>Le portail des normes pour les données d'offre du transport collectif : <a href="http://www.normes-donnees-tc.org/?ref=prim.iledefrance-mobilites.fr" rel="noreferrer">http://www.normes-donnees-tc.org/</a>​</li><li>Profil des données : le SIRI Lite​</li><li>Format des horaires : aaaa-mm-jj ‘T‘ hh:mm:ss.SSSZ​</li></ul>

Description du service

<h3 id="identification-des-lignes">Identification des lignes</h3>L’identifiant d’une ligne « LineRef » doit être passé sous la forme :​STIF:Line::CXXXXX: avec CXXXXX l’identifiant de la ligne dans le <a href="https://data.iledefrance-mobilites.fr/explore/dataset/referentiel-des-lignes/table?ref=prim.iledefrance-mobilites.fr" rel="noreferrer">Référentiel</a><a href="https://data.iledefrance-mobilites.fr/explore/dataset/referentiel-des-lignes/table?ref=prim.iledefrance-mobilites.fr" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes" rel="noreferrer">Île-de-France</a><a href="https://data.iledefrance-mobilites.fr/explore/dataset/referentiel-des-lignes/table?ref=prim.iledefrance-mobilites.fr" rel="noreferrer"> </a><a href="https://data.iledefrance-mobilites.fr/explore/dataset/referentiel-des-lignes/table?ref=prim.iledefrance-mobilites.fr" rel="noreferrer">Mobilités</a>​Exemples :​ <ul><li>Pour la ligne B du RER, l’identifiant de la ligne dans le Référentiel Île-de-France Mobilités est C01743, le pattern est donc « STIF:Line::C01743: ».​</li><li>Pour la ligne de bus Phébus A, l’identifiant de la ligne dans le Référentiel Île-de-France Mobilité est C00692, le pattern est donc « STIF:Line::C00692: ».​</li></ul><h3 id="identification-des-arr%C3%AAts">Identification des arrêts</h3>L’identifiant d’un arrêt « MonitoringRef_ZDE » doit être passé sous la forme :​STIF:StopPoint:Q:XXXXX: avec XXXXX l’identifiant du <a href="https://data.iledefrance-mobilites.fr/explore/dataset/arrets/table/?ref=prim.iledefrance-mobilites.fr" rel="noreferrer">référentiel</a><a href="https://data.iledefrance-mobilites.fr/explore/dataset/arrets/table/?ref=prim.iledefrance-mobilites.fr" rel="noreferrer"> </a><a href="https://data.iledefrance-mobilites.fr/explore/dataset/arrets/table/?ref=prim.iledefrance-mobilites.fr" rel="noreferrer">des arrêts</a>​Exemples :Pour l’arrêt « Gare de Massy-Palaiseau » sur la ligne B du RER, l’identifiant du référentiel est 412833, le pattern est​ « STIF:StopPoint:Q:412833: ».

Identification des objets

<ul><li>Ecart d’estimation​</li></ul>Les prochains passages sont des données de prévision et donc par définition un écart peut être rencontré entre​ l’estimation et le passage réel. La précision se dégrade en fonction du temps, notamment au- delà de 20 minutes pour le bus et 30 minutes pour les modes ferrés.​<ul><li>Horaires de passages​</li></ul>Tant que le véhicule n’a pas commencé sa course, le système fournit les horaires de passages planifiés par l’exploitant la veille de la journée en cours.​<ul><li>Profondeur des données​</li></ul>Pour tous les modes, les données sont disponibles sur une profondeur de trois heures au maximum pour les transporteurs qui le permettent.​<ul><li>Prévision de passages​</li></ul>Mode bus : prévision de passage à un arrêt en fonction de la localisation du bus en tenant compte des trajets précédents.​Mode ferré : prévision de passage à un arrêt en fonction de la localisation du véhicule.​

Focus sur les requêtes globale et unitaire​

<h2 id="service-prochains-passages-%E2%80%93-requ%C3%AAte-unitaire%E2%80%8B">Service prochains passages – Requête unitaire​</h2><h3 id="stop-requis%E2%80%8B">Stop (requis)​</h3>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 :​<ul><li>ARr, zone d'embarquement (anciennement ZDER) : « STIF:StopPoint:Q:[ArRId]: »​ Exemple : Quais M4 - Châtelet : STIF:StopPoint:22092: (aller) et STIF:StopPoint:463158: (retour)​</li></ul>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.​ --&gt; Privilégier des requêtes aux ZdA / ZdC​<ul><li>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:​</li><li>ZdC (zone de correspondance multimodale) « STIF:StopArea:SP:[ZdCId]: »​ Exemple Zone de correspondance – Châtelet : STIF:StopArea:SP:71264:​</li></ul>A noter:​<ul><li>Le jeu de données <a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/arrets?staticDataSlug=arrets" rel="noreferrer">Référentiel</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/arrets?staticDataSlug=arrets" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/arrets?staticDataSlug=arrets" rel="noreferrer">des</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/arrets?staticDataSlug=arrets" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/arrets?staticDataSlug=arrets" rel="noreferrer">arrêts</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/arrets?staticDataSlug=arrets" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/arrets?staticDataSlug=arrets" rel="noreferrer">:</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/arrets?staticDataSlug=arrets" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/arrets?staticDataSlug=arrets" rel="noreferrer">Arrêts</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/arrets?staticDataSlug=arrets" rel="noreferrer"> </a>propose les arrêts de référence du référentiel des arrêts d'Île-de-France.​</li><li>Le jeu de données <a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer">Référentiel</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer">des</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer">arrêts</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer">:</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer">Relations</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer"> </a>propose l'ensemble des relations entre les objets du référentiel des arrêts d'Île-de-France.​</li><li>Le Jeu de données <a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">Périmètre</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">des</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">données</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">temps</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">réel</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">disponibles</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a>expose la liste des arrêts par ligne/ transporteur concernés par ce service.​</li><li>Le jeu de données <a href="http://prim.iledefrance-mobilites.fr/jeux-de-donnees/arrets-lignes" rel="noreferrer">Arrêts et lignes associées</a> liste toutes les lignes du réseau francilien et les arrêts desservis pour chacune de ces lignes comme dans le GTFS.​</li></ul><h3 id="%E2%80%8B%E2%80%8Bligne-optionnel%E2%80%8B">​​Ligne (optionnel)​</h3>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 <a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer">Référentiel</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer">des</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer"> </a><a href="http://rec.prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes&ref=prim.iledefrance-mobilites.fr" rel="noreferrer">lignes</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer">de</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer"> </a><a href="http://rec.prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes&ref=prim.iledefrance-mobilites.fr" rel="noreferrer">transport</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer">en</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer">commun</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer">d'Île</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer">-de-France</a>, à savoir :​<ul><li>ID_Line, identifiant de référence de la ligne commerciale : « STIF:Line::[ID_Line]: »​ Exemple Ligne RER C : STIF:Line::C01727:</li></ul><h2 id="service-prochains-passages-%E2%80%93-requ%C3%AAte-globale%E2%80%8B">Service prochains passages – Requête globale​</h2><h3 id="all-requis%E2%80%8B">ALL (requis)​</h3>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 <a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">Périmètre</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">des</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">données</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">temps</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">réel</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">disponibles</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a>expose la liste des arrêts par ligne/ transporteur concernés par ce service.​

Structure des requêtes - Paramètres d’appel​

<blockquote>Requête : https://prim.iledefrance-mobilites.fr/marketplace/stop-monitoring?MonitoringRef=STIF:StopPoint:Q:463158:</blockquote><blockquote>Attention : </blockquote><blockquote>L'heure diffusée dans le champ ResponseTimestamp est exprimées en heure<a href="https://time.is/fr/Paris?ref=prim.iledefrance-mobilites.fr"> locale</a> (en été GMT+02, hiver GMT+01). Toutes les autres heures sont exprimées en&nbsp; <a href="https://time.is/fr/GMT?ref=prim.iledefrance-mobilites.fr">GMT</a>.</blockquote><figure class="kg-card kg-image-card"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/10/image---2024-10-09T105346.089.png" class="kg-image" alt="" loading="lazy" width="745" height="532" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/10/image---2024-10-09T105346.089.png 600w, http://prim.iledefrance-mobilites.fr/content/images/2024/10/image---2024-10-09T105346.089.png 745w" sizes="(min-width: 720px) 720px"></figure>

<style type="text/css">
.tg {border-collapse:collapse;border-spacing:0;}
.tg td{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 overflow:hidden;padding:10px 5px;word-break:normal;}
.tg th{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 font-weight:normal;overflow:hidden;padding:10px 5px;word-break:normal;}
.tg .tg-fymr{border-color:inherit;font-weight:bold;text-align:left;vertical-align:top}
.tg .tg-0pky{border-color:inherit;text-align:left;vertical-align:top}
</style>
<table class="tg"><thead>
 <tr>
 <th class="tg-fymr">Numéro</th>
 <th class="tg-fymr">Description</th>
 </tr></thead>
<tbody>
 <tr>
 <td class="tg-0pky">1</td>
 <td class="tg-0pky">Heure de la réponse</td>
 </tr>
 <tr>
 <td class="tg-0pky">2</td>
 <td class="tg-0pky">Description des passages à l'arrêt</td>
 </tr>
 <tr>
 <td class="tg-0pky">3</td>
 <td class="tg-0pky">Date et heure à laquelle ces données ont été produites</td>
 </tr>
 <tr>
 <td class="tg-0pky">4</td>
 <td class="tg-0pky">Identifiant du point d'arrêt concerné par la requête</td>
 </tr>
 <tr>
 <td class="tg-0pky">5</td>
 <td class="tg-0pky">Description de la course</td>
 </tr>
 <tr>
 <td class="tg-0pky">6</td>
 <td class="tg-0pky">Identifiant de la ligne Les réponses aux requêtes sur les arrêts multilignes (zones monomodales ou multimodales) devront être filtrées sur le LineRef.</td>
 </tr>
 <tr>
 <td class="tg-0pky">7</td>
 <td class="tg-0pky">Identifiant de l'exploitant (opérateur)</td>
 </tr>
 <tr>
 <td class="tg-0pky">8</td>
 <td class="tg-0pky">Identification de la course</td>
 </tr>
 <tr>
 <td class="tg-0pky">9</td>
 <td class="tg-0pky">Contexte d'identification de la course</td>
 </tr>
 <tr>
 <td class="tg-0pky">10</td>
 <td class="tg-0pky">Identifiant de la course</td>
 </tr>
 <tr>
 <td class="tg-0pky">11</td>
 <td class="tg-0pky">Nom de la direction</td>
 </tr>
</tbody></table>

<figure class="kg-card kg-image-card"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/10/image-2--2-.png" class="kg-image" alt="" loading="lazy" width="595" height="522"></figure>

<style type="text/css">
.tg {border-collapse:collapse;border-spacing:0;}
.tg td{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 overflow:hidden;padding:10px 5px;word-break:normal;}
.tg th{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 font-weight:normal;overflow:hidden;padding:10px 5px;word-break:normal;}
.tg .tg-1wig{font-weight:bold;text-align:left;vertical-align:top}
.tg .tg-0lax{text-align:left;vertical-align:top}
</style>
<table class="tg"><thead>
 <tr>
 <th class="tg-1wig">Numéro</th>
 <th class="tg-1wig">Description</th>
 </tr></thead>
<tbody>
 <tr>
 <td class="tg-0lax">12</td>
 <td class="tg-0lax">Identifiant du dernier arrêt de la course</td>
 </tr>
 <tr>
 <td class="tg-0lax">13</td>
 <td class="tg-0lax">Nom de l'arrêt de destination</td>
 </tr>
 <tr>
 <td class="tg-0lax">14</td>
 <td class="tg-0lax">Texte complémentaire décrivant la course</td>
 </tr>
 <tr>
 <td class="tg-0lax">15</td>
 <td class="tg-0lax">Informations horaires concernant l'arrêt considéré</td>
 </tr>
 <tr>
 <td class="tg-0lax">16</td>
 <td class="tg-0lax">Nom du point d'arrêt</td>
 </tr>
 <tr>
 <td class="tg-0lax">17</td>
 <td class="tg-0lax">La valeur true indique que le véhicule est à l'arrêt. Valeur par défaut : false</td>
 </tr>
 <tr>
 <td class="tg-0lax">18</td>
 <td class="tg-0lax">Destination telle qu'elle est affichée sur la girouette du véhicule à cet arrêt (ou sur l'afficheur local)</td>
 </tr>
 <tr>
 <td class="tg-0lax">19</td>
 <td class="tg-0lax">Heure d'arrivée estimée par le SAE</td>
 </tr>
 <tr>
 <td class="tg-0lax">20</td>
 <td class="tg-0lax">Heure de départ estimée par le SAE</td>
 </tr>
 <tr>
 <td class="tg-0lax">21</td>
 <td class="tg-0lax">Caractérisation de l'horaire de départ attendu (ou mesuré si le véhicule est à quai). Valeur par défaut : onTime. Si le passage est supprimé, la valeur est cancelled.</td>
 </tr>
</tbody></table>

Exemple de réponses – Niveau Quai (retour)​

<h3 id="aimedarrival-departuretime-%E2%80%8B">AimedArrival/ DepartureTime: ​</h3>Horaires théoriques de départ et d’arrivée établis la veille par le transporteur en prenant en compte la disponibilité des conducteurs et des véhicules. Ces horaires ne sont pas toujours disponibles.​<h3 id="expectedarrival-departuretime-%E2%80%8B">ExpectedArrival/ DepartureTime: ​</h3>Prédictions d’horaires de prochains passages prenant en compte la position réelle du véhicule, le temps restant pour atteindre un arrêt et les temps de parcours observés sur les trajets précédents.​<h3 id="arrival-departurestatus-%E2%80%8B">Arrival/ DepartureStatus : ​</h3>Caractérisent les horaires de départ ou d’arrivée attendus (ou mesurés si le véhicule est à quai).​Ces champs peuvent prendre les valeurs suivantes :​<ul><li>onTime : A l'heure prévue​</li><li>early : En avance​</li><li>delayed : Retardé​</li><li>cancelled : Passage à un arrêt annulé (ne concerne pas l'entièreté du trajet).​</li><li>missed : Le véhicule n'a pas marqué l'arrêt alors qu'il aurait dû, mais la course continue.​</li><li>arrived : Arrivé​</li><li>departed : Parti​</li><li>notExpected : Non planifié (cas de TAD encore non déclenché)​</li><li>noReport : Non communiqué Valeur par défaut : « onTime ».​</li></ul>Attention : La réponse de l'API contient les données à partir de 30 minutes avant le moment de la requête et jusqu’à 2 heures après.​<h3 id="directionref">DirectionRef:</h3>Il n’y a pas de référentiel&nbsp; partagé à l’échelle d’Île-de-France Mobilités, le&nbsp; champ est donc facultatif. Cependant le champ « DestinationRef »&nbsp; (terminus de la course) est toujours renseigné.<h3 id="datedvehiclejourney-ref">DatedvehicleJourney&nbsp; Ref:</h3>L’identifiant de la course identifie de manière unique une&nbsp; course pour tous les transporteurs. Dans une réponse à une requête globale, la course&nbsp;est reconstituée car on&nbsp; obtient les prochains passages à tous les arrêts de cette course.<h3 id="vehiclefeatureref">VehicleFeatureRef:</h3>Indique la longueur des trains. Ce champ peut prendre deux valeurs :<ul><li>La valeur « shortTrain » signale qu’il &nbsp;s’agit d’un train court.</li><li>La valeur « longTrain » signale qu’il &nbsp;s’agit d’un train long.</li></ul>Cependant, ce champ est facultatif pour&nbsp;les transporteurs, ainsi s’il ne figure pas dans la réponse cela signifie que le transporteur n’a pas transmis&nbsp;l’information.Attention : La RATP ne fournit pas d’identifiants de courses mais un compteur technique sans lien métier avec la notion de course.Nous obtenons alors dans la réponse à la requête globale pour une même ligne et un même sens tous les véhicules s’arrêtant à la même&nbsp;heure quel que soit l’arrêt. Par conséquent, dans les réponses aux requêtes globales, les courses RATP ne sont pas correctement reconstituées. Les prochains passages aux arrêts sont cependant tous renseignés dans la réponse.

Prise en compte de la réponse

Les API Prochains Passages

La mise à jour des données est réalisée quotidiennement.&nbsp;Les données couvrent les trois prochaines semaines.L'intégralité des horaires des RER A et B sont transmis par la SNCF.Les horaires des lignes SNCF incluent les adaptations faites lors de travaux prévus, ainsi que les substitutions faites en bus (ex : un trajet en bus sera proposé si un tronçon est coupé pour cause de travaux).Les horaires des lignes RATP n'incluent pas en règle générale, les adaptations faites lors de travaux prévus.&nbsp; (ex : Fermeture d'une station de métro).Contrairement aux fichiers issus du GTFS, les données des API prennent en compte les Interdictions de Trafic Local (ITL) qui existent parfois sur certaines lignes de bus OPTILE.

Qualité des données

<h3 id="route">route</h3>Une «&nbsp;route&nbsp;» est un ensemble d’itinéraires regroupés sous un même nom, cet objet fait référence à l’identifiant de la ligne disponible dans le <a href="https://data.iledefrance-mobilites.fr/explore/dataset/referentiel-des-lignes/information/?ref=prim.iledefrance-mobilites.fr">référentiel des lignes</a>.&nbsp;Ex : IDFM:C01371 (Métro 1)<h3 id="trip">trip</h3>Une «&nbsp;trip&nbsp;» définit un parcours sur une ligne donnée, il s’agit d’un enchaînement structuré d’arrêts. Ex : IDFM:RATP:9541-C01371-10_3736592_955496 (Métro 1 – Sens la Défense)<h3 id="service">service</h3>Une course «&nbsp;service&nbsp;» est la déclinaison d’un itinéraire à un horaire donné. Une course attribue à chaque arrêt de l’itinéraire un horaire de passage.Sur une journée, une course est unique : deux véhicules d’une même ligne effectuent chacun une course différente.Ex : IDFM:100071 (Métro 1 - une course qui circule que les samedis du 21 août 2021 au 28 août 2021)<h3 id="agency">agency</h3>Une «&nbsp;agency&nbsp;» est un réseau commercial ou un opérateur de transport.Ex :&nbsp; IDFM:1051 (Poissy - Les Mureaux) ou IDFM:Operator_100 (RATP)<h3 id="stop">stop</h3>Un «&nbsp;stop&nbsp;» est un objet qui décrit un type d’arrêt, il s’agit de :<ol><li> Un point d’arrêt d’un seul et unique transporteur, pour ce cas il prend les formes suivantes :</li></ol><ul><li>StopPoint Ferré (RER,Transilien): «IDFM:[ID ZdA] »</li><li>StopPoint (reste): « IDFM:[ID ArR] »</li></ul>Ex : IDFM:3640 (Jean de La Fontaine)<ol start="2"><li> Un «&nbsp;stop_area&nbsp;» est un regroupement d’arrêts physiques portant le même nom dit aussi un arrêt commercial:</li></ol><ul><li>StopArea : «IDFM:[ID ZdC]»</li></ul>Ex : IDFM:70604 (Porte de Choisy)À noter:«&nbsp;stop_point&nbsp;» est une donnée non pérenne pour le bus. Elle est susceptible d’être changée chaque jour à la publication du GTFS. Les «&nbsp;stop_points&nbsp;» sont plutôt stables pour le réseau ferré.

Paramètres d'appel

Le paramètre {URI} signifie que les paramètres d’appel sont intégrés dans l’URL de la requête et ne se trouve pas, comme la plupart du temps, à la fin de l’URL de requête.Exemple&nbsp;: Pour récupérer tous les «&nbsp;stop_points&nbsp;» de la ligne du métro 1 (line:IDFM:C01373 )On utilise la méthode : /v2/navitia/{uri}/stop_points/{id}&nbsp;Avec le paramètre d’appel à la place de {id}: lines%2Fline:IDFM:C01373&nbsp;

Utiliser le paramètre {URI} dans l’API générique Navitia

Le <a href="http://prim.iledefrance-mobilites.fr/playground/index.html" rel="noreferrer">playground de Navitia</a> est un outil interactif&nbsp;permettant de tester et explorer les API <a href="http://prim.iledefrance-mobilites.fr/fr/apis/idfm-navitia-general-v2" rel="noreferrer">Calculateur Ile-de-France Mobilités - Accès générique (v2)</a>, <a href="http://prim.iledefrance-mobilites.fr/fr/apis/idfm-navitia-isochrones-v2" rel="noreferrer">Calculateur Ile-de-France Mobilités - Isochrones (coverage idfm)</a> et <a href="http://prim.iledefrance-mobilites.fr/fr/apis/idfm-navitia-line_reports-v2" rel="noreferrer">Calculateur Ile-de-France Mobilités - Messages Info Trafic (coverage idfm)</a>.​Afin d'utiliser le playground intégré sur PRIM, un jeton vous sera demandé. Vous pouvez utiliser votre jeton API disponible sur PRIM ou le générer en suivant <a href="http://prim.iledefrance-mobilites.fr/fr/aide-et-contact/documentation/donnees-disponibles/api/generer-un-jeton-pour-acceder-aux-api" rel="noreferrer">cette documentation</a>.<h2 id="la-page-daccueil">La page d'accueil</h2><figure class="kg-card kg-image-card"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/11/playground.jpg" class="kg-image" alt="" loading="lazy" width="1372" height="647" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/11/playground.jpg 600w, http://prim.iledefrance-mobilites.fr/content/images/size/w1000/2024/11/playground.jpg 1000w, http://prim.iledefrance-mobilites.fr/content/images/2024/11/playground.jpg 1372w" sizes="(min-width: 720px) 720px"></figure>1 : Accédez à plusieurs exemples de requêtes populaires afin de récupérer rapidement certaines informations. ​2 : Renseignez l'URL PRIM de l'environnement souhaité, cliquez sur GO et commencez à utiliser le Playground préconfiguré pour requêter cette URL​.3 : Accédez directement à la page du Playground sans aucune pré-configuration​.4 : Visualisez une réponse à partir d'un fichier JSON au préalablement téléchargé. <h2 id="la-page-principale">La page principale </h2>La page principale du playground permet de configurer les différentes requêtes et visualiser leur réponse.​<figure class="kg-card kg-image-card"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/11/main-page.png" class="kg-image" alt="" loading="lazy" width="1750" height="928" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/11/main-page.png 600w, http://prim.iledefrance-mobilites.fr/content/images/size/w1000/2024/11/main-page.png 1000w, http://prim.iledefrance-mobilites.fr/content/images/size/w1600/2024/11/main-page.png 1600w, http://prim.iledefrance-mobilites.fr/content/images/2024/11/main-page.png 1750w" sizes="(min-width: 720px) 720px"></figure><h3 id="1les-champs-api-et-token">1 - Les champs API et Token </h3><ul><li>Le champ API décrit l'URL permettant d'utiliser le Playground préconfiguré à partir de cette URL. Il sera toujours <a href="http://prim.iledefrance-mobilites.fr/marketplace/v2">https://prim.iledefrance-mobilites.fr/marketplace/v2</a>.</li><li>Le champ Token correspond au jeton que vous avez généré sur la plateforme PRIM.</li></ul><h3 id="2le-champ-navitia">2 - Le champ Navitia</h3>Le champ Navitia permet d'indiquer l'API Navitia que vous souhaitez requêter.Par défaut, sans valeur renseignée, cela va appeler l'API Calculateur Ile-de-France Mobilités - Accès générique (coverage idfm).

<style type="text/css">
.tg {border-collapse:collapse;border-spacing:0;}
.tg td{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 overflow:hidden;padding:10px 5px;word-break:normal;}
.tg th{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 font-weight:normal;overflow:hidden;padding:10px 5px;word-break:normal;}
.tg .tg-wp8o{border-color:#000000;text-align:center;vertical-align:top}
</style>
<table class="tg"><thead>
 <tr>
 <th class="tg-wp8o">Valeur renseignée</th>
 <th class="tg-wp8o">API appelée</th>
 </tr></thead>
<tbody>
 <tr>
 <td class="tg-wp8o">N/A</td>
 <td class="tg-wp8o">Calculateur Ile-de-France Mobilités - Accès générique (coverage idfm)</td>
 </tr>
 <tr>
 <td class="tg-wp8o">isochrones</td>
 <td class="tg-wp8o">Calculateur Ile-de-France Mobilités - Isochrones (coverage idfm)</td>
 </tr>
 <tr>
 <td class="tg-wp8o">line_reports</td>
 <td class="tg-wp8o">Calculateur Ile-de-France Mobilités - Messages Info Trafic (coverage idfm)</td>
 </tr>
</tbody>
</table>

Pour requêter l'API Calculateur Ile-de-France Mobilités - Messages Info Trafic (coverage idfm), il est nécessaire de renseigner 2 fois le champ line-reports :<ul><li>Dans le champ Feature, comme pour le fonctionnement normal</li><li>Dans le champ Navitia</li></ul>Cela engendre un doublon de la chaîne de caractères line_reports dans l'URL finale, ce qui est souhaité pour le bon fonctionnement de cette API. Le paramètre count de l'API Calculateur Ile-de-France Mobilités - Messages Info Trafic (coverage idfm) est plafonné à 100 sur PRIM.Pour requêter l'API Calculateur Ile-de-France Mobilités - Isochrones (coverage idfm), il est également nécessaire de renseigner 2 fois le champ isochrones dans les champs Feature et Navitia.<h3 id="3le-champ-path">3 - Le champ Path</h3>Le champ path permet de filtrer la réponse qui sera obtenue via divers filtres tels que le mode de transport utilisé, la ligne de transport ou encore l'arrêt. Il fonctionne avec un système de clef et de valeur, tous deux ayant une autocomplétion.Exemple : Valeurs possibles pour le path physical_modes : <figure class="kg-card kg-image-card"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/11/physical-mode.png" class="kg-image" alt="" loading="lazy" width="405" height="373"></figure><h3 id="4le-champ-feature">4 - Le champ Feature</h3>Le champ feature permet de spécifier le type de recherche dans le calculateur. Une autocomplétion est mise en place pour indiquer les différentes features disponibles. Exemple : Features disponibles pour l'API Navitia Journeys :<figure class="kg-card kg-image-card"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/11/feature.png" class="kg-image" alt="" loading="lazy" width="529" height="401"></figure><h3 id="5les-champs-parameters">5 - Les champs Parameters </h3>Les champs permettent de spécifier les paramètres de la recherche renseignée via le champ Feature. Ils fonctionnent avec un système de clef et de valeur, tous deux ayant une autocomplétion.<figure class="kg-card kg-image-card"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/11/param-key.png" class="kg-image" alt="" loading="lazy" width="438" height="257"></figure><figure class="kg-card kg-image-card"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/11/param-value.png" class="kg-image" alt="" loading="lazy" width="698" height="434" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/11/param-value.png 600w, http://prim.iledefrance-mobilites.fr/content/images/2024/11/param-value.png 698w"></figure><h3 id="6r%C3%A9capitulatif-de-lurl-finale">6 - Récapitulatif de l'URL finale</h3>Au clic sur le bouton Submit, l'URL paramétrée est appelée.Elle s'actualise automatiquement en fonction des paramètres sélectionnés dans les champs précédents.Pour garantir un bon fonctionnement de l'outil, le format de l'URL devra toujours respecter le format suivant : https://prim.iledefrance-mobilites.fr/marketplace/v2/navitia/${API_NAVITIA}/${PATH}/${FEATURE}?${QUERY_PARAMS}<h3 id="7visualisation-de-la-r%C3%A9ponse">7 - Visualisation de la réponse</h3>Une fois la requête effectuée, la réponse est formatée pour être visualisée dans cette section. Il est possible de déplier chaque partie correspondant à des sous-sections du JSON original et les visualiser sous plusieurs formes ( JSON, cartes etc. ).

Utilisation du Playground​

Les API Calculateur Île-de-France Mobilités

<h2 id="optimiser-vos-requ%C3%AAtes-d%E2%80%99appel-%C3%A0-l%E2%80%99api-calculateur-ile-de-france-mobilite%CC%81smessages-info-trafic-v2">Optimiser vos requêtes d’appel à l’API Calculateur Ile-de-France Mobilités - Messages Info Trafic (v2)</h2>Pour rappel:​Le nombre d'éléments renvoyés pour une requête ne peut être supérieur à 100. Si vous en demandez plus, l’API retournera les 100 premiers résultats, et vous devrez paginer en utilisant le paramètre start_page pour obtenir les 100 suivants.​Nous vous recommandons d'ajouter à vos requêtes certains paramètres disponibles afin d'obtenir des réponses plus précises qui s'adaptent réellement à vos besoins.Quelques exemples de requêtes avec le paramètre {URI} pour affiner vos recherches (méthode : /v2/navitia/{uri}/line_reports)1- Objectif : &nbsp;Récupérer les infos trafic pour tous les «&nbsp;stop_points&nbsp;» d’une ligneExemple de requête pour le RER C (line:IDFM:C01727): <a href="http://prim.iledefrance-mobilites.fr/marketplace/v2/navitia/line_reports/lines/line%3AIDFM%3AC01727/line_reports?count=100">https://prim.iledefrance-mobilites.fr/marketplace/v2/navitia/line_reports/lines/line%3AIDFM%3AC01727/line_reports?count=100</a>2- Objectif : &nbsp;Récupérer les Info trafic pour un mode de transport en particulierExemple de requête pour le mode «&nbsp;metro&nbsp;»: <a href="http://prim.iledefrance-mobilites.fr/marketplace/v2/navitia/line_reports/physical_modes/physical_mode%3AMetro/line_reports?count=100">https://prim.iledefrance-mobilites.fr/marketplace/v2/navitia/line_reports/physical_modes/physical_mode%3AMetro/line_reports?count=100</a>3- Objectif : &nbsp;Récupérer toutes les infos trafic sauf exception:&nbsp;Exemple de requête pour récupérer toutes les infos trafic sauf bus : <a href="http://prim.iledefrance-mobilites.fr/marketplace/v2/navitia/line_reports/line_reports?count=100&forbidden_uris%5B%5D=physical_mode%3ABus">https://prim.iledefrance-mobilites.fr/marketplace/v2/navitia/line_reports/line_reports?count=100&amp;forbidden_uris%5B%5D=physical_mode%3ABus</a>

API Calculateur Ile-de-France Mobilités - Messages Info Trafic (v2)

<h2 id="mapping-entre-lapi-calculateur-ile-de-france-mobilite%CC%81smessages-info-trafic-v2-et-lapi-messages-info-traficrequ%C3%AAte-globale">Mapping entre l'API Calculateur Ile-de-France Mobilités - Messages Info Trafic (v2) et l'API Messages Info Trafic - Requête globale</h2><h3 id="lignes-impact%C3%A9es">Lignes impactées </h3>

<style type="text/css">
.tg {border-collapse:collapse;border-spacing:0;}
.tg td{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 overflow:hidden;padding:10px 5px;word-break:normal;}
.tg th{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 font-weight:normal;overflow:hidden;padding:10px 5px;word-break:normal;}
.tg .tg-1wig{font-weight:bold;text-align:left;vertical-align:top}
.tg .tg-0lax{text-align:left;vertical-align:top}
</style>
<table class="tg"><thead>
 <tr>
 <th class="tg-0lax"></th>
 <th class="tg-1wig">Description</th>
 <th class="tg-1wig">API Line_Reports</th>
 <th class="tg-1wig">Exemple de valeur</th>
 <th class="tg-1wig">API Bulk Disruptions</th>
 <th class="tg-1wig">Exemple de valeur</th>
 </tr></thead>
<tbody>
 <tr>
 <td class="tg-0lax">1</td>
 <td class="tg-0lax">Identifiant de la ligne</td>
 <td class="tg-0lax">line.id</td>
 <td class="tg-0lax">line:IDFM:C01110</td>
 <td class="tg-0lax">lines.id</td>
 <td class="tg-0lax">line:IDFM:C01110</td>
 </tr>
 <tr>
 <td class="tg-0lax">2</td>
 <td class="tg-0lax">Nom de la ligne</td>
 <td class="tg-0lax">line.name</td>
 <td class="tg-0lax">75</td>
 <td class="tg-0lax">lines.name</td>
 <td class="tg-0lax">75</td>
 </tr>
 <tr>
 <td class="tg-0lax">3</td>
 <td class="tg-0lax">Nom court de la ligne</td>
 <td class="tg-0lax">line.code</td>
 <td class="tg-0lax">75</td>
 <td class="tg-0lax">lines.shortName</td>
 <td class="tg-0lax">75</td>
 </tr>
 <tr>
 <td class="tg-0lax">4</td>
 <td class="tg-0lax">Mode</td>
 <td class="tg-0lax">line.physical_modes.id</td>
 <td class="tg-0lax">Bus</td>
 <td class="tg-0lax">lines.mode</td>
 <td class="tg-0lax">Bus</td>
 </tr>
 <tr>
 <td class="tg-0lax">5</td>
 <td class="tg-0lax">Identifiant du réseau</td>
 <td class="tg-0lax">line.network.id</td>
 <td class="tg-0lax">network:IDFM:Operator_100</td>
 <td class="tg-0lax">lines.networkId</td>
 <td class="tg-0lax">network:IDFM:Operator_100</td>
 </tr>
</tbody></table>

<h3 id="objets-impact%C3%A9s">Objets impactés</h3>

<style type="text/css">
.tg {border-collapse:collapse;border-spacing:0;}
.tg td{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 overflow:hidden;padding:10px 5px;word-break:normal;}
.tg th{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 font-weight:normal;overflow:hidden;padding:10px 5px;word-break:normal;}
.tg .tg-1wig{font-weight:bold;text-align:left;vertical-align:top}
.tg .tg-0lax{text-align:left;vertical-align:top}
</style>
<table class="tg"><thead>
 <tr>
 <th class="tg-0lax"></th>
 <th class="tg-1wig">Description</th>
 <th class="tg-1wig">API Line_Reports</th>
 <th class="tg-1wig">Exemple de valeur</th>
 <th class="tg-1wig">API Bulk Disruptions</th>
 <th class="tg-1wig">Exemple de valeur</th>
 </tr></thead>
<tbody>
 <tr>
 <td class="tg-0lax">1</td>
 <td class="tg-0lax">Type</td>
 <td class="tg-0lax">pt_objects.embedded_type</td>
 <td class="tg-0lax">[line ; network ; stop_point ; stop_area]</td>
 <td class="tg-0lax">impactedObjects.type</td>
 <td class="tg-0lax">[line ; network ; stop_point ; stop_area]</td>
 </tr>
 <tr>
 <td class="tg-0lax">2</td>
 <td class="tg-0lax">Identifiant de l'objet impacté</td>
 <td class="tg-0lax">pt_objects.[line ; network ; stop_point ; stop_area].id</td>
 <td class="tg-0lax">line:IDFM:C01110</td>
 <td class="tg-0lax">impactedObjects.id</td>
 <td class="tg-0lax">line:IDFM:C01110</td>
 </tr>
 <tr>
 <td class="tg-0lax">3</td>
 <td class="tg-0lax">Nom de l'objet impacté</td>
 <td class="tg-0lax">pt_objects.[line ; network ; stop_point ; stop_area].name</td>
 <td class="tg-0lax">75</td>
 <td class="tg-0lax">impactedObjects.name</td>
 <td class="tg-0lax">75</td>
 </tr>
 <tr>
 <td class="tg-0lax">4</td>
 <td class="tg-0lax">Lien vers les infos trafic</td>
 <td class="tg-0lax">pt_objects.[line ; network ; stop_point ; stop_area].links.id</td>
 <td class="tg-0lax">35088aa0-abdd-11ee-97fc-0a58a9feac02</td>
 <td class="tg-0lax">impactedObjects.disruptionIds</td>
 <td class="tg-0lax">35088aa0-abdd-11ee-97fc-0a58a9feac02</td>
 </tr>
</tbody></table>

<h3 id="informations-trafic">Informations trafic</h3>

<style type="text/css">
.tg {border-collapse:collapse;border-spacing:0;}
.tg td{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 overflow:hidden;padding:10px 5px;word-break:normal;}
.tg th{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 font-weight:normal;overflow:hidden;padding:10px 5px;word-break:normal;}
.tg .tg-1wig{font-weight:bold;text-align:left;vertical-align:top}
.tg .tg-0lax{text-align:left;vertical-align:top}
</style>
<table class="tg"><thead>
 <tr>
 <th class="tg-1wig"></th>
 <th class="tg-1wig">Description</th>
 <th class="tg-1wig">API Line_Reports</th>
 <th class="tg-1wig">Exemple de Valeur</th>
 <th class="tg-1wig">API Bulk Disruptions</th>
 <th class="tg-1wig">Exemple de Valeur</th>
 </tr></thead>
<tbody>
 <tr>
 <td class="tg-0lax">1</td>
 <td class="tg-0lax">Identifiant de l'info trafic</td>
 <td class="tg-0lax">id</td>
 <td class="tg-0lax">35088aa0-abdd-11ee-97fc-0a58a9feac02</td>
 <td class="tg-0lax">disruptions.id</td>
 <td class="tg-0lax">35088aa0-abdd-11ee-97fc-0a58a9feac02</td>
 </tr>
 <tr>
 <td class="tg-0lax">2</td>
 <td class="tg-0lax">Début de période d'application</td>
 <td class="tg-0lax">application_periods.begin</td>
 <td class="tg-0lax">20240102T051500</td>
 <td class="tg-0lax">disruptions.applicationPeriods.begin</td>
 <td class="tg-0lax">20240102T051500</td>
 </tr>
 <tr>
 <td class="tg-0lax">3</td>
 <td class="tg-0lax">Fin de période d'application</td>
 <td class="tg-0lax">application_periods.end</td>
 <td class="tg-0lax">20240512T024500</td>
 <td class="tg-0lax">disruptions.applicationPeriods.end</td>
 <td class="tg-0lax">20240512T024500</td>
 </tr>
 <tr>
 <td class="tg-0lax">4</td>
 <td class="tg-0lax">Date de mise à jour</td>
 <td class="tg-0lax">updated_at</td>
 <td class="tg-0lax">20240105T161506</td>
 <td class="tg-0lax">disruptions.lastUpdate</td>
 <td class="tg-0lax">20240105T161506</td>
 </tr>
 <tr>
 <td class="tg-0lax">5</td>
 <td class="tg-0lax">Cause</td>
 <td class="tg-0lax">cause</td>
 <td class="tg-0lax">[travaux ; perturbation ; information]</td>
 <td class="tg-0lax">disruptions.cause</td>
 <td class="tg-0lax">[TRAVAUX ; PERTURBATION ; INFORMATION]</td>
 </tr>
 <tr>
 <td class="tg-0lax">6</td>
 <td class="tg-0lax">Sévérité</td>
 <td class="tg-0lax">severity.name</td>
 <td class="tg-0lax">[bloquante ; perturbée ; information]</td>
 <td class="tg-0lax">disruptions.severity</td>
 <td class="tg-0lax">[BLOQUANTE ; PERTURBEE ; INFORMATION]</td>
 </tr>
 <tr>
 <td class="tg-0lax">7</td>
 <td class="tg-0lax">Étiquette</td>
 <td class="tg-0lax">tags</td>
 <td class="tg-0lax">Actualité</td>
 <td class="tg-0lax">disruptions.tags</td>
 <td class="tg-0lax">Actualité</td>
 </tr>
 <tr>
 <td class="tg-0lax">8</td>
 <td class="tg-0lax">Titre</td>
 <td class="tg-0lax">messages.text</td>
 <td class="tg-0lax">Bus 75 : Travaux - Arrêt(s) non desservi(s)</td>
 <td class="tg-0lax">disruptions.title</td>
 <td class="tg-0lax">Bus 75 : Travaux - Arrêt(s) non desservi(s)</td>
 </tr>
 <tr>
 <td class="tg-0lax">9</td>
 <td class="tg-0lax">Message</td>
 <td class="tg-0lax">messages.text</td>
 <td class="tg-0lax">La ligne 75 est déviée : les arrêts situés entre Alibert et République ne sont plus desservis en direction de Panthéon. Reprise estimée : dimanche 12 mai 2024, à partir de 02h00. Raison : travaux. Plus d'informations sur le site ratp.fr</td>
 <td class="tg-0lax">disruptions.message</td>
 <td class="tg-0lax">La ligne 75 est déviée : les arrêts situés entre Alibert et République ne sont plus desservis en direction de Panthéon. Reprise estimée : dimanche 12 mai 2024, à partir de 02h00. Raison : travaux. Plus d'informations sur le site ratp.fr</td>
 </tr>
</tbody></table>

API Messages Info Trafic - Requête globale

Médias : Pour la SNCF et le réseau de Bus OPTILE,&nbsp;les APIs temps réel ne disposent pas des&nbsp;informations qui sont fournies sur les médias (site internet, Twitter, …).Écrans des gares<ul><li>RATP : Ensemble des infos trafics&nbsp;disponibles en gares RER et stations de &nbsp;métro et sur les médias RATP.</li><li>SNCF : Informations disponibles sur les&nbsp;écrans disposés dans les gares.</li><li>Bus : Informations disponibles sur les&nbsp;écrans disposés aux arrêts de bus.</li></ul><h3 id="structure-des-requ%C3%AAtesparam%C3%A8tres-d%E2%80%99appel%E2%80%8B">Structure des requêtes - Paramètres d’appel​</h3>Stop : Ce service permet d’obtenir les informations trafic affichées sur les écrans en temps réel d’un arrêt donné. Exemple Gare de Saint-Rémy-Lès-Chevreuse : STIF:StopPoint:Q:412844:Ligne : Ce service permet d’obtenir les informations trafic affichées sur les écrans en temps réel d’une ligne donnée. Exemple Ligne RER C : STIF:Line::C01727:Le paramètre d'appel ALL permet d’obtenir les informations trafic affichées sur les écrans en temps réel de l'ensemble des lignes du réseau. Exemple : LineRef=ALLCanal : Ce service permet d'identifier le canal pour lequel on souhaite obtenir les informations trafic affichées sur les écrans en temps réel.&nbsp; Si ce champ n'est pas présent, la requête concerne tous les canaux. Exemple : InfoChannelRef=Information OU Perturbation OU CommercialAttention : Pour requêter l’API vous pouvez soit indiquer le champ « StopPointRef » soit « LineRef » mais pas les deux en même temps.Un de ces deux champs est requis car le champ « InfoChannelRef » n'est pas requêtable seul.

API Messages affichés sur les écrans

Les API Informations Trafic & Travaux

Prise en main des API

Une réutilisation est une illustration de l’utilisation d’une donnée. Les données disponibles au sein du catalogue de PRIM sont soumises à des licences d’utilisation, dont certaines obligent les utilisateurs à partager leurs réutilisations en Open data. ​Sur le catalogue, certaines données sont soumises à des licences qui imposent le partage de réutilisation, vous pouvez consulter<a href="http://prim.iledefrance-mobilites.fr/fr/licences" rel="noreferrer"> la rubrique dédiée</a> aux licences sur PRIM.Pour faciliter aux utilisateurs du portail PRIM le respect de cette obligation, le parcours de partage des réutilisations a été mis en place sur la plateforme.&nbsp; ​Dans le catalogue des données de PRIM, le nombre de réutilisations disponibles pour chaque API, jeu de données ou widget est indiqué sur les cellules des données. Si aucune réutilisation n’a été partagée pour une donnée, rien n’est indiqué.

Qu’est-ce qu’une réutilisation ?

<h3 id="acc%C3%A9der-aux-r%C3%A9utilisations%E2%80%8B">Accéder aux réutilisations​</h3>La consultation et le partage de réutilisations est accessibles à trois endroits sur le site PRIM : ​<ol><li>Depuis la page «&nbsp;Réutilisations&nbsp;» accessible via le menu «&nbsp;Données&nbsp;» du portail PRIM. Une fois la page «&nbsp;Réutilisations&nbsp;» ouverte, il faudra ouvrir l’onglet «&nbsp;Réutilisations&nbsp;». ​</li><li>Depuis la page «&nbsp;Contribuer&nbsp;» du portail PRIM.​</li><li>Depuis les pages détaillées individuelles des données disponibles dans le «&nbsp;Catalogue des données&nbsp;». Une fois la page détaillée ouverte, il faudra ouvrir l’onglet Réutilisations.​</li></ol><h3 id="partager-des-r%C3%A9utilisations%E2%80%8B">Partager des réutilisations​</h3>Pour partager une nouvelle réutilisation de données, il vous suffit de cliquer sur le bouton «&nbsp;soumettre une réutilisation&nbsp;», puis de compléter le formulaire de demande de partage de réutilisations. Une fois le formulaire complété et soumis, celui-ci est traité par nos équipes qui pourront procéder à sa validation. Le délai de traitement est d’environ deux semaines. Lorsque votre demande de partage de réutilisation d’une donnée est validée, vous recevez un mail et la ​réutilisation est automatiquement publiée sur PRIM.​<h3 id="refus-d%E2%80%99une-demande-de-partage-de-r%C3%A9utilisation">Refus d’une demande de partage de réutilisation</h3>Il peut arriver qu’une demande de partage de réutilisations soit refusée. Lorsque votre demande de partage de réutilisation d’une donnée est refusée, vous recevez un mail dans lequel le motif de refus est systématiquement indiqué et la réutilisation n’est pas publiée sur PRIM.

Publier une réutilisation

<h2 id="modification-d%E2%80%99une-r%C3%A9utilisation">Modification d’une réutilisation</h2>Pour une raison ou une autre, les réutilisations peuvent être modifiées par nos équipes avant ou après leur publication sur PRIM.​ Les éléments qui peuvent être modifiés sont par exemple le titre ou la description d’une réutilisation. En fonction du degré d’importance de la modification apportée, vous serez prévenu ou pas, par mail de la modification effectuée à votre partage de réutilisation.​Il n’est pas possible de modifier des informations personnelles telles que le nom, le mail ou le site web d’une réutilisation déjà publiée ou attente de validation. Il faudra nécessairement soumettre une nouvelle demande de partage de réutilisations si vous souhaitez que des modifications soient apportées à ces éléments.​<h2 id="suppression-d%E2%80%99une-r%C3%A9utilisation">Suppression d’une réutilisation</h2>Suite à une demande de votre part, ou bien pour une raison ou une autre, une réutilisation peut être supprimées par nos équipes. Lorsque votre réutilisation de donnée est supprimée, vous recevez un mail dans lequel le motif de suppression est systématiquement indiqué et la ​réutilisation est supprimée de PRIM. ​