Table des matières

Rechercher sur le site

Tools & More

Description Rapide

Qu’est-ce que Tools & More?

Cette page offre un aperçu des différents outils, systèmes et liens complémentaires qui peuvent aider les utilisateurs d’OpenTransportData.swiss.

Qui est à l’origine de tout cela?

Les outils, systèmes et liens présentés ici ont été développés soit par notre équipe Tâches systémiques Information clientèle + (SKI+), soit par nos partenaires, soit par des externes.

Pourquoi la plate-forme Open Data propose-t-elle cela?

De nombreux outils aident à mieux observer et exploiter les données et les interfaces sur OpenTransportData.swiss.

Description spécifique 

Pour le traitement des données d’horaire HRDF

HRDF Duplicates

  • Link: https://tools.odpch.ch/hrdf-check-duplicates
  • Code: https://github.com/openTdataCH/OJP-Showcase/tree/develop/apps/hrdf-duplicates-report
  • Affectation: Cet outil permet d’identifier les courses contradictoires dans les données HRDF, de vérifier s’il s’agit de doublons et de valider les similitudes. Concrètement, le système recherche les entrées de numéro de course *Z qui appartiennent à la même entreprise de transport. Selon la définition HRDF, le «…numéro de course est un numéro univoque pour chaque livraison au sein d’un gestionnaire…». À titre de fonctionnalité supplémentaire, l’outil prend également en compte les périodes de validité des courses définies dans le BITFELD.
  • Mode d’emploi:
    • Il faut tout d’abord sélectionner la série de données HRDF (voir https://data.opentransportdata.swiss/dataset/timetable-54-2024-hrdf), c’est-à-dire le jour. Il faut ensuite sélectionner l’entreprise de transport, le caractère univoque s’applique à chaque entreprise de transport.
      • Le système détermine ensuite pour l’entreprise de transport tous les numéros de circulation qui apparaissent plusieurs fois, en tenant compte de leurs périodes de validité effectives. Le résultat est généré de manière groupée par catégorie d’offre ou type de moyen de transport. Dans l’exemple, le type de moyen de transport «EC» comporte quatre numéros de circulation (310, 320, 322, 328) qui sont des doublons. Le numéro de circulation 771 du type IC 3 semble avoir 19 doublons.
      • Dans la vue détaillée des doublons, l’utilisateur peut désormais visualiser et contrôler plus en détail les éventuels doublons. Un examen visuel des trois premières entrées montre clairement les différences, de sorte que les variantes affichées ne sont pas de «véritables» doublons. Ce serait pourtant le cas selon les directives HRDF (en théorie).
      • Remarque: l’outil propose une autre représentation via la sélection «Consolidated Report» (Rapport consolidé). Tous les doublons identifiés, toutes entreprises de transport confondues, sont édités sous forme de tableau tous les jours.

HRDF Bitfields

  • Code: https://github.com/openTdataCH/OJP-Showcase/tree/develop/apps/bitfeld-viz
  • Affectation: Représentation visuelle des périodes de validité telles qu’elles sont fournies sous forme de code binaire dans le fichier BITFELD au format HRDF. Concrètement, elles sont fournies sous forme de nombres hexadécimaux qui représentent à leur tour l’ordre des bits.
  • Mode d’emploi:
    • Insère tout d’abord la valeur du champ d’éléments binaires à visualiser. Ensuite, sélectionne la période d’horaire à utiliser.
    • Les données saisies s’affichent alors
    • Remarque: Vous pouvez également entrer de «vrais» champs de bits, c’est-à-dire une suite de zéros et de uns (011000101…).

HRDF Query

Pour la gestion des données d’horaire et en temps réel GTFS

GTFS-Static & GTFS-RT Comparer

  • Code: https://github.com/openTdataCH/OJP-Showcase/tree/develop/apps/gtfs-rt-status
  • Affectation: Cet outil permet de comparer les données statiques GTFS (Static) avec les données en temps réel (Realtime) afin d’identifier les éléments manquants dans les blocs de données correspondants. Les éléments de données sont les entreprises de transport ainsi que des trajets/voyages spécifiques.
  • Mode d’emploi:
    • Les fichiers GTFS-Static et GTFS-Realtime sont présélectionnés. Il est possible d’indiquer la période sur laquelle les écarts doivent être vérifiés. Appuyer sur le bouton «Comparer» pour effectuer la comparaison.
    • Une fois la comparaison effectuée, les différences par rapport au bloc de données Static sont tout d’abord affichées à partir du bloc de données Realtime. Concrètement, un petit aperçu avec le nombre d’écarts («stats»). Ensuite, les entreprises de transport pour les données en temps réel, mais qui ne sont pas mentionnées dans le registre correspondant (https://data.opentransportdata.swiss/dataset/go-realtime) («Agencies missing from GO-Realtime»). Les entreprises de transport mentionnées dans le registre, mais pour lesquelles aucune donnée en temps réel n’a été trouvée («Agencies without GTFS-RT»). Ainsi qu’une liste des blocs de données GTFS Realtime pour lesquels aucun équivalent correspondant n’a été trouvé dans le bloc de données Static («Missing GTFS static entries»).
    • La vue d’ensemble GTFS Realtime est suivie d’une vue d’ensemble GTFS-Static. Tout d’abord, comme précédemment, le nombre d’écarts («stats») avec un signe inversé. Ensuite, la liste des données statiques pour lesquelles il manque des données en temps réel. Dans la colonne «Arrêts», les arrêts déjà desservis sont indiqués en gris clair et les futurs arrêts en noir.

GTFS-Static & GTFS-RT Comparer Report

  • Code: https://github.com/openTdataCH/OJP-Showcase/tree/develop/apps/gtfs-rt-static-report
  • Affectation: Il s’agit d’une représentation visuellement attrayante du rapport comparatif décrit ci-dessus. Elle peut être utilisée p. ex. pour signaler des mouvements inhabituels dans des volumes de données. Ainsi que pour détecter des schémas récurrents ou inhabituels. Contrairement au comparateur «pur», cette vue sert à la vue d’ensemble mensuelle des données obtenues.
  • Mode d’emploi:
    • En haut, il est possible de sélectionner le mois à visualiser et les valeurs à comparer. Le résultat est ensuite affiché dans le tableau en dessous, où sont affichées les valeurs par jour et par heure du jour concerné. Dans l’image ici, le nombre de données en temps réel pour les jours et les heures de septembre 2024. Les différentes nuances de bleu représentent différents blocs de données GTFS.
    • Selon la cellule sélectionnée, vous pouvez afficher les détails des données sur le côté droit. La balise «DATA» indique soit un problème de serveur, soit un problème de fichier. MATCH signifie qu’un trop grand nombre d’enregistrements divergent. Alors que «RT age» indique un enregistrement RT, celui-ci diverge trop temporairement. Les détails peuvent également être lus ici: https://github.com/openTdataCH/OJP-Showcase/blob/develop/tools/gtfs-rt-static-compare/docs/gtfs-rt-static-compare.md

GTFS Shapes Checker

  • Code: TBC
  • Affectation: Permet de valider visuellement les fichiers de formes GTFS précédemment chargés (par exemple https://tools.odpch.ch/gtfs-shapes-analyse-v2/data/gtfs-db-lookups-2023-09-05-mentz.json).
  • Mode d’emploi:
    • Soit on recherche un Trip souhaité dans le fichier Shapes, soit on clique avec le bouton gauche de la souris sur la carte, à proximité des «graph shapes» représentées, qui sont visibles sous forme de lignes bleues sur la carte (surlignées en jaune sur l’exemple sur la capture d’écran). Tous les Trips à proximité s’affichent alors et on peut en sélectionner un en cliquant sur un bouton bleu à droite (avec l’identifiant Trip) pour le mettre en évidence sur la carte. De plus, des détails sont représentés sous forme de texte en bas à droite.

Erstellen von Shapes

  • Code: https://github.com/ad-freiburg/pfaedle 
  • Affectation: Création de correspondances de cartes pour les flux GTFS basés sur les données OSM
  • Mode d’emploi: Les instructions figurant dans le Repo doivent être respectées.

Pour la gestion des données d’événements SIRI

SIRI SX Overview

  • Pour plus de détails, cliquer sur ?debug=1 à la fin de l’URL. Il faut alors saisir un SBOID ou une SSTID lors d’une recherche textuelle (pas de recherche plein texte)!
  • Code: https://github.com/openTdataCH/siri-sx-situation-monitor
  • Affectation: Représente les informations sur les événements reçues au format SIRI-SX sous la forme d’une simple liste.
  • Mode d’emploi: Il n’y a pas de configuration particulière (sauf si vous définissez?debug=1)

SIRI SX Map

  • Code: https://github.com/openTdataCH/siri-sx-map?tab=readme-ov-file
  • Affectation: Représentation géoréférencée des messages SIRI-SX sur une carte.
  • Mode d’emploi:
    • Il s’agit d’une carte sur laquelle les événements sont représentés. Il suffit de cliquer sur les marqueurs ou les lignes de couleur pour obtenir plus de détails. Il est également possible de sélectionner la langue et d’autres paramètres pour la requête et l’affichage.

GTFS Query 

  • Code: OJP-Showcase/apps/gtfs-query at develop · openTdataCH/OJP-Showcase (github.com)
  • Affectation: Ce système permet d’afficher les détails GTFS appropriés sur la base des données d’événements de SIRI-SX.
  • Mode d’emploi:
    • Il faut tout d’abord ouvrir l’outil SIRI SX Overview (voir ci-dessus) en ajoutant?debug=1 (à la fin de l’URL). Ensuite, ouvrir la vue développeur avec la vue protocole réseau du navigateur. Il faut ensuite cliquer sur le bouton «Build Link» (Build Link). Dans la demande, trouve-t-on dans les informations de l’en-tête un lien commençant par https://tools.odpch.ch/gtfs-rt-status/api/gtfs-query/trips? (Exemple surligné en jaune dans la capture d’écran ci-dessous):
    • Lorsque l’on clique sur ce lien dans le navigateur, la vue suivante s’affiche. On y voit les détails de l’horaire pour la partie de GTFS concernée par l’événement. Dans le cas présent, il s’agit de la ligne 22 concernée dans GTFS pour la date donnée avec 59 entrées.

Concernant l’utilisation de l’Open Journey Planner

OJP Demo App

  • OJP-1.0: https://opentdatach.github.io/ojp-demo-app/search
  • OJP-1.0 BETA: https://tools.odpch.ch/beta-ojp-demo/search
  • OJP-2.0: https://tools.odpch.ch/ojp-demo-v2/search
  • Affectation: Un outil pour tester l’interface OJP et ses fonctionnalités. L’appli sert avant tout à démontrer les capacités du système et n’est pas conçue comme une appli à part entière! L’appli permet d’effectuer des requêtes typiques au système OJP dans le standard OJP. Cela est possible à différents points d’extrémité (p. ex. test ou intégration), respectivement pour les versions 1 et 2 du standard OJP. Toutes les fonctionnalités prévues peuvent être testées dans la version bêta, mais celle-ci est souvent instable.
  • Mode d’emploi:
    • Journey Search
      • L’onglet «Journey Search» (Recherche de voyage) est sélectionné par défaut et il est possible d’effectuer une recherche classique d’itinéraire en saisissant le départ et la destination du voyage souhaité dans les champs «From» (De) et «To» (À). Il est également possible de sélectionner la (multi-)modalité de transport souhaitée, p. ex. «Mode at End» (Mode at End) et «Bicycle Sharing), c’est-à-dire de parcourir le dernier kilomètre avec un vélo. Comme décrit précédemment, cette possibilité de configuration sert de démonstration – un programme d’utilisateur final procéderait probablement différemment. Il est également possible de régler le jour et l’heure (départ ou arrivée). Pour les environnements, il convient de laisser PROD (système et serveur de production). Le CD Beta est l’acronyme de LinkingAlps Beta. Il permet de tester des requêtes dans le cadre de la communauté LinkingAlps (liaisons internationales vers le Tyrol du Sud/l’Autriche/la Slovénie). Le bouton «Debug XML» (Déboguer XML) permet de consulter la requête XML.
      • Une fois la recherche effectuée, d’autres fonctionnalités sont disponibles. Le bouton «XML» dans la section de recherche permet d’afficher le XML de la requête et de la requête. En outre, les trajets possibles (Trips) sont désormais affichés, avec diverses méta-informations comme la durée du voyage. Le bouton «MAP» focalise la vue sur la carte sur le segment de trajet correspondant (Trip Leg). Le même effet est obtenu en cliquant sur la modalité (p. ex. «1er train – …»). Un clic sur le nom de la ligne et le numéro du train (p. ex. «IC6 960») permet d’obtenir un aperçu des arrêts du moyen de transport dans son ensemble. Il convient de mentionner le bouton «Permalien» qui permet d’enregistrer une requête prédéfinie dans un lien afin de la partager ultérieurement (p. ex. pour corriger des erreurs). Le résultat contient en outre des informations sur les retards, les caractéristiques du moyen de transport, l’accessibilité ainsi qu’une indication approximative du prix.
      • La carte de résultat se comporte comme ailleurs.
    • Station Board
      • L’onglet «Station Board» permet d’afficher l’écran des départs/arrivées d’un arrêt spécifique, p. ex. «Bern, Wankdorf Center». Toutes les autres fonctionnalités se comportent de la même manière que pour la recherche de voyage.
      • Après la recherche, le résultat s’affiche avec les différentes lignes, leurs numéros de train/moyen de transport, les heures d’arrivée ou de départ prévues ainsi que les éventuels retards.
    • Trip Info
      • L’onglet «Trip Info» permet d’afficher la vue détaillée d’un train spécifique. Comme décrit ci-dessus, il est également possible de la consulter en cliquant sur le numéro de ligne et de train spécifique (p. ex. IC1 709) dans Journey Search. C’est aussi le moyen d’obtenir une «JourneyRef», c’est-à-dire un Swiss Journey ID (SJYID – ID de trajet suisse), p. ex. «ch:1:sjyid:100001:709-001» (plus d’informations sur les ID suisses https://www.oev-info.ch/de/branchenstandard/technische-standards/strukturelle-standards). Ce SJYID est ensuite saisi dans le masque.
      • Le résultat indique les différents arrêts du trajet.

API Explorer

  • Code: https://github.com/openTdataCH/api-explorer2
  • Affectation: L’API Explorer permet d’envoyer des requêtes OJP 1,0 et 2,0 au format XML à notre backend. Sur le plan fonctionnel, il est donc similaire à l’appli de démonstration OJP, mais se limite aux types de requêtes pour OJP et à une vue «purement textuelle» avec des questions et réponses XML. L’authentification appropriée est requise (voir aussi https://opentransportdata.swiss/cookbook/verwendung-der-api/).
  • Mode d’emploi:
    • Une interface Swagger standard fournit les points de terminaison qui peuvent être demandés, y compris des exemples de demandes.

& More

Le site Web suivant contient une liste d’outils utiles, en particulier pour la gestion des données GTFS: https://github.com/MobilityData/awesome-transit