Table des matières

Rechercher sur le site

Train Formation Service (formation des trains)

#AutoTranslate

Description rapide

Les données de formation sont des informations sur les voitures (et les locomotives) d’un train, y compris la composition d’un train. Les données de formation contiennent non seulement la position des différentes voitures dans un train, mais aussi leurs propriétés.

Nos données sur la formation vous permettent p. ex. de savoir quelle voiture d’un train donné (avec un numéro de train précis) dispose d’un accès à plancher surbaissé, c’est-à-dire d’un accès pratique pour les fauteuils roulants ou les poussettes.

Depuis l’automne 2024, nous proposons une API REST qui fournit les données de formation d’un train pour un numéro de train donné et un jour d’exploitation donné sous forme de structure de données JSON.

Accès à l’API

Remarque: Une description de la manière d’accéder aux API peut être trouvée ici: Howto: Accéder à nos API avec des clés API.

Description métier

Qui est à l’origine de tout cela?

Le service est fourni en Suisse par l’équipe Tâches systémiques Information à la clientèle Plus (SKI+), sur mandat de l’Office fédéral des transports (OFT).

Nous tirons les données sur les formations de deux systèmes:

  1. Le service de formation (FOS) Interface des CFF entre les différentes entreprises de transport ferroviaire (EVU) fournissent leurs données de formation.
  2. Interface du système en temps réel (CUS) des tâches systémiques d’information à la clientèle (SKI), qui gère les données en temps réel de tous les moyens de transport des transports publics.

Tandis que l’interface FOS ne fournit «que» les détails des compositions, l’interface CUS complète les données avec des détails, comme la position des voitures (secteurs) sur la voie des arrêts.

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

Les connaissances sur la formation d’un train peuvent être utilisées pour informer les utilisatrices et utilisateurs:

  • le secteur d’une voie d’une gare où l’embarquement pour les personnes en fauteuil roulant est possible, ce qui est particulièrement important dans le contexte de la loi sur l’égalité pour les handicapés (LHand).
  • dans quelles voitures les crochets pour vélos sont-ils disponibles
  • combien de places sont généralement disponibles dans une voiture
  • types de locomotives et de wagons qui circulent sur quels tronçons, p. ex. pour les Trainspotter ou les entreprises de transport qui combinent leurs services avec les chemins de fer

Description technique

Quels services (points terminaux de l’interface) l’interface de données de formation propose-t-elle?

L’interface des données de formation prend en charge les variantes de demandes suivantes. Les détails des demandes sont également documentés via l’interface OpenAPI:

  1. Basée sur les arrêts – https://api.opentransportdata.swiss/formation/v2/formations_stop_based:
    • Ce que le service fait:
      • Déterminer les formations pour chaque arrêt de la marche d’un train.
    • Ce dont le service a besoin:
      • Le nom d’un EVU: La liste des EVU est limité aux personnes qui ont donné leur consentement pour l’utilisation de leurs données de formation.
      • Un jour d’exploitation: Jour pour lequel la formation doit être demandée. La date ne peut pas se situer dans le passé. La date ne peut être que aujourd’hui (en raison de l’intégration des données en temps réel de CUS).
      • Le numéro de train, également appelé numéro du moyen de transport: Le train pour lequel vous souhaitez demander la formation. Ce numéro peut être obtenu de différentes manières, notamment via nos données d’horaire dans différents formats de données.
    • Ce que le service de retour donne:
      • Les arrêts d’un train, les détails des arrêts, la formation avec laquelle le train part des arrêts, quand, de quelle voie et avec quelles locomotives/voitures et jusqu’à quelle destination. Il est essentiel d’indiquer la formation dans une notation compacte, qui provient du CUS!
      • Cette requête ne contient pas tous les détails sur chaque wagon.
      • L’interprétation de la chaîne courte de formation est décrite ci-dessous!
    • Cas d’application possible: Afficher la formation d’un train sur une voie pour un arrêt spécifique.
  2. Basé sur le train – https://api.opentransportdata.swiss/formation/v2/formations_vehicle_based
    • Ce que le service fait:
      • Déterminer les formations par véhicule (donc par élément de formation) du train.
    • Ce dont le service a besoin:
      • Les paramètres sont les mêmes que pour formations_stop_based
      • Pour le jour d’exploitation: Jour pour lequel la formation doit être consultée. La date peut se situer jusqu’à trois jours dans le futur.
    • Ce que le service offre:
      • Les éléments de la formation avec les détails de chaque véhicule, la position du véhicule dans la formation, ainsi que les arrêts auxquels le véhicule s’arrête en cours de route avec les détails de la halte, ainsi que la voie et le secteur où le véhicule s’arrête à chaque halte.
      • Cette requête n’inclut pas la vue d’ensemble du train le long des arrêts.
    • Cas d’application possible: Le suivi d’un wagon spécifique.
  3. En fonction des arrêts et des trains – https://api.opentransportdata.swiss/formation/v2/formations_full
    • Ce que le service fait:
      • Émettre les compositions aussi bien par arrêt que par véhicule.
    • Ce dont le service a besoin:
      • Les paramètres sont les mêmes que pour formations_stop_based et formations_vehicle_based
    • Ce que le service offre:
      • Les arrêts ET les éléments de formation sont identiques aux variantes décrites ci-dessus.
  4. Informations sur le statut du service – https://api.opentransportdata.swiss/formation/v2/health
    • Ce que le service fait:
      • Fournit le statut de l’état de fonctionnement actuel.
    • Ce dont le service a besoin:
      • Rien, aucun paramètre.
    • Ce que le service offre:
      • Statut relatif à l’état de fonctionnement actuel.

Les paramètres de requête

Les paramètres suivants sont transmis en tant que paramètres de requête (query parameters) après un ‘?’ dans l’URL (GET request):

Paramètres Description de la valeur et exemple de valeur
evu Le EVU pour lequel la demande doit être faite. Autorisé actuellement: BLSP, CFF P, MBC, ÖBB, RhB, SOB, THURBO, TPF, TRN, VDBB, ZB
operationDate La date à laquelle le train circule et pour laquelle on veut faire la demande. P. ex. 2024-09-18
trainNumber Numéro de train dont les données de formation sont demandées. P. ex. 2806

Exemple de demande: https://api.opentransportdata.swiss/formation/v2/formations_stop_based?evu=BLSP&operationDate=2025-08-28&trainNumber=2806

La réponse

Nous ne décrirons pas ici le modèle de données complet, mais ferons plutôt référence au YAML suivant: GitHub.com/openTdataCH/api-explorer/openapi/formation.

Voici l’OpenAPI: opentdatach.github.io/api-explorer/formation/

Interprétation de la chaîne courte de formation:

Fondamentalement, la structure de la chaîne diffère selon qu’une voie comporte des secteurs ou que nous en avons connaissance.

Dans tous les cas, les règles suivantes s’appliquent à la structure:

Élément Description
Secteur Lettre („A“ … „Z“)
Statut „-“ Véhicule fermé
„>“Véhicule avec des groupes montant à ce PE
„=“Véhicule (en partie) réservé pour les groupes en transit
„%“Véhicule ouvert, mais non desservi (voiture-restaurant uniquement)
Remarque: «fermé» ne peut apparaître que seul, les autres caractères peuvent être combinés
 [ Début du groupe de véhicules appartenant au train
Remarque: Cela permet de distinguer les véhicules garés ou à retirer des véhicules appartenant au train en marche.
 ]

Fin du groupe de véhicules appartenant au train
Remarque: Cela permet de distinguer les véhicules garés ou à retirer des véhicules appartenant au train en marche.
 (

aucun passage possible vers le véhicule voisin de ce côté du véhicule
Remarque: Le calcul repose sur des données de base et des hypothèses. Il n’est pas garanti que ces données correspondent toujours à la réalité.
 )

aucun passage possible vers le véhicule voisin de ce côté du véhicule
Remarque: Le calcul repose sur des données de base et des hypothèses. Il n’est pas garanti que ces données correspondent toujours à la réalité.
Type véh.KI

Type de véhicule du point de vue de l’information à la clientèle. Signification:
„1“Voiture 1re classe
„2“Voitures de 2e classe (y compris les voitures A/AB déclassées)
„12“Voiture de 1re et 2e classes
„CC“Voiture-couchettes
„FA“Voiture-familles
„WL“Voiture-lits
„WR“Restaurant (voiture-bistro, voiture-restaurant, etc.)
„W1“voiture-restaurant et voiture à places assises 1re classe
„W2“voiture-restaurant et voiture à places assises de 2e classe
„LK“Véhicule moteur
„D“Fourgon à bagages
„F“wagon fictif
„K“Véhicule sans classe
„X“d’un véhicule en stationnement Remarque: CUS convertit le type de véhicule prélevé à partir de FOS en un type de véhicule générique „KI-Typ“ à l’intérieur.

Les variantes suivantes sont utilisées:
1. Conversion de véhicules trop longs: Les rames automotrices qui livrent la source non pas par wagon, mais en tant que véhicule (trop long), peuvent être divisées en voitures isolées par CUS sur le plan de la configuration. Dans ce cas, 1 véhicule (généralement du type) n’apparaît pas dans la chaîne „12“), mais 2…n véhicules du type „1“, „2“, „12“ ou „D“. Le nombre est calculé à partir du nombre de véhicules perçus par le client. En règle générale, les véhicules de ce type, qui ne conduisent pas la première classe au milieu du train, sont classés dans des véhicules sans classe de type „K“ transformée.
2. Conversion de véhicules individuels sur la base d’expressions régulières: Tous les véhicules individuels sont convertis en véhicules génériques de l’information à la clientèle à l’aide d’expressions régulières et prioritaires.
3. Conversion de véhicules individuels en fonction du nombre de places assises: Si aucune expression régulière de 2) ne correspond, le type est déterminé sur la base du nombre de places assises en 1re et 2e classes. Si le véhicule ne dispose pas de places assises, le type „D“ attribuées.

Remarque concernant “F”: sur les voies avec secteurs, le delta entre la longueur du train et la longueur de la bordure d’arrêt est comblé à l’avant et/ou à l’arrière avec des wagons fictifs.

Remarque concernant “X”: les wagons garés influent sur l’affectation des véhicules d’un train aux secteurs, mais ne font pas partie intégrante du train concerné.
N° d’ordre Numéro d’ordre pour la réservation de place individuelle affichée sur la voiture pour les passagers (numéro à 1 à 3 chiffres)
Offre Liste des offres liées aux véhicules. Celles-ci comprennent:
„BHP“ Emplacements pour fauteuils roulants
„BZ“Espace affaires
„FZ“Espace familles
„KW“Plate-forme des poussettes
„NF“Véhicule avec accès à plancher surbaissé
„VH“Crochets/plate-forme pour vélos
„VR“crochets/plate-forme pour vélos soumis à réservation

Quels sont les principaux termes et concepts à connaître?

Nous utilisons les éléments suivants dans le cadre de notre interface (sans les éléments du conteneur)

  • StopPoint
    • Un StopPoint est un arrêt le long de l’horaire
  • StopTime
    • L’heure de départ et d’arrivée
  • Track
    • La voie au StopPoint
  • FormationShortString
    • Représentation succincte de la formation (telle que définie par CUS)
  • VehicleGoal
    • Quelles voitures et à quelle destination restent ensemble depuis un arrêt
  • JourneyMetaInformation
    • Identification univoque du convoi
  • TrainMetaInformation
    • Caractéristiques descriptives du train
  • FormationMetaInformation
    • Informations détaillées sur l’ensemble de la formation, p. ex. nombre de véhicules
  • ScheduledStop
    • StopPoint, StopTime, Track, Informations sur la gestion du train à l’arrêt (p. ex. arrêt ou passage) et sur les écarts du trajet (p. ex. retards à l’arrivée)
  • VehicleIdentifier
    • Les attributs qui identifient clairement un véhicule, p. ex. european vehicle number (EVN). Une particularité réside dans le fait qu’un véhicule peut faire partie d’un train articulé et donc EVN mais une seule «générée». Dans ce cas, le «Parent-EVN«.
  • WheelchairSymbolProperties
  • AccessibilityProperties
    • Autres caractéristiques pouvant être utilisées pour une représentation adaptée aux personnes handicapées
  • PictoProperties
    • Indique si les différents pictogrammes sont représentés sur un véhicule
  • DirectTrolleyInformation
    • Si la formation représente des voitures directes
  • VehicleRelation
    • Cet élément permet de suivre les courses précédente et suivante de la formation donnée, qui peut également être une course directe de wagon
  • VehicleProperties
    • Caractéristiques d’un véhicule en tant que partie d’une formation, c’est-à-dire élément de formation, ainsi que de quel point à quel point le wagon fait partie de la formation
  • FormationVehicleAtScheduledStop
    • Représentation de la formation par arrêt (pour la demande vehicle_based)
  • VehicleRelationship
    • La relation de voyage, c’est-à-dire la manière dont la course change entre deux courses (p. ex. en cas de suppression)
  • VehicleRelationshipDetails
    • Détails d’une relation de voyage.

Restrictions

  1. Les données se limitent aux entreprises de transport ferroviaire (EVU) qui fournissent leurs formations via les Chemins de fer fédéraux suisses (CFF) et ont accepté la publication de leurs données sous forme de données ouvertes.
  2. Le service ne met à disposition toutes les données et les données basées sur le véhicule que si toutes les sources disposent de toutes les données requises. C’est particulièrement important si l’on considère que CUS ne dispose que des données pour le jour.
  3. Concrètement, les données proviennent du système en temps réel SKI (CUS – CUstomer (Information) System – VerkehrsMittel (VM)) et les Formation-Services (FOS) des CFF.