Indice della materia

Ricerca nella pagina

Train Formation Service (formazione dei treni)

#AutoTranslate

Descrizione breve

I dati sulla formazione sono informazioni sulle carrozze (e le locomotive) di un treno, compresa la sua composizione. I dati sulla formazione non comprendono solo la posizione delle singole carrozze in un treno, ma anche le caratteristiche delle singole carrozze.

Con i nostri dati sulla composizione del treno puoi ad esempio scoprire quale carrozza di un determinato treno (con un determinato numero del treno) offre un accesso a pianale ribassato, quindi un accesso comodo per sedie a rotelle o passeggini.

Dall’autunno 2024 offriamo un’API REST, che fornisce come struttura dati JSON i dati sulla formazione di un treno per un determinato numero di treno in un determinato giorno di esercizio.

Accesso al API

Nota: Una descrizione di come accedere alle API può essere trovata qui: Howto: Accesso alle nostre API con API Keys.

Descrizione del funzionamento

Chi c’è dietro tutto questo?

Il servizio viene messo a disposizione in Svizzera dal team Attività di sistema Informazione alla clientela Plus (SKI+) su incarico dell’Ufficio federale dei trasporti (UFT).

I dati relativi alle formazioni provengono da due sistemi:

  1. Il servizio di formazione (FOS) Interfaccia delle FFS nella quale diverse imprese di trasporto ferroviario (EVU) trasmettono i propri dati sulla formazione.
  2. L’interfaccia dei mezzi di trasporto del sistema in tempo reale (CUS) di Attività di sistema Informazione alla clientela (SKI), che gestisce i dati in tempo reale di tutti i mezzi di trasporto dei trasporti pubblici.

Mentre l’interfaccia FOS fornisce «solo» i dettagli delle formazioni, l’interfaccia CUS arricchisce i dati con dettagli, come per es. la posizione delle carrozze (settori) sul binario delle fermate.

Perché la piattaforma Open Data offre questo?

Le conoscenze sulla formazione di un treno possono essere utilizzate per informare gli utenti:

  • in quale settore dei binari della stazione è possibile l’accesso senza barriere architettoniche, aspetto particolarmente importante nel contesto della legge sui disabili (LDis)?
  • in quale carrozza sono disponibili ganci per biciclette
  • quanti posti sono in linea generale disponibili in una carrozza
  • quali tipi di locomotive e carri circolano su quali tratte, ad es. per trainspotter o per imprese di trasporto che combinano i loro servizi con le ferrovie

Descrizione tecnica

Quali servizi (punti finali dell’interfaccia) offre l’interfaccia Dati formazione?

L’interfaccia dati della formazione supporta le seguenti varianti di richiesta. I dettagli delle richieste vengono documentati anche tramite l’interfaccia OpenAPI:

  1. Basato sulla fermata – https://api.opentransportdata.swiss/formation/v2/formations_stop_based:
    • Cosa fa il servizio:
      • Rilevare la formazione per fermata della corsa di un treno.
    • Di cosa ha bisogno il servizio:
      • Il nome di un EVU: L’elenco dei EVU è limitata a coloro che hanno dato il proprio consenso all’utilizzo dei dati relativi alla formazione.
      • Un giorno d’esercizio: Il giorno per il quale deve essere richiesta la formazione. La data non può essere già trascorsa. La data può essere solo oggi (sulla base dell’inoltro dei dati in tempo reale del CUS).
      • Il numero del treno, detto anche numero del mezzo di trasporto: Il treno per il quale si desidera richiedere la composizione. Questo numero può essere ottenuto in diversi modi, tra cui i dati relativi all’orario in diversi formati di dati.
    • Che cosa dà il servizio di ritorno:
      • Le fermate di un treno, con relativi dettagli, la formazione con cui il treno parte dalle fermate, indicando quando, da quale binario e con quali locomotive/carrozze fino a dove. L’importante è indicare la formazione in una scrittura compatta proveniente da CUS!
      • Questa richiesta non contiene tutti i dettagli relativi ai singoli carri.
      • L’interpretazione della stringa breve per la formazione è descritta più avanti!
    • Possibile caso applicativo: Mostrare la formazione di un treno su un binario per una determinata fermata.
  2. Basato sul treno – https://api.opentransportdata.swiss/formation/v2/formations_vehicle_based
    • Cosa fa il servizio:
      • Rilevare la formazione di ogni veicolo (cioè per ogni elemento della formazione) del treno.
    • Di cosa ha bisogno il servizio:
      • I parametri sono gli stessi del formations_stop_based
      • Giorno d’esercizio: Giorno per il quale deve essere richiesta la formazione. La data può estendersi fino a tre giorni nel futuro.
    • Cosa offre il servizio:
      • Gli elementi della formazione con dettagli di ogni veicolo, la posizione del veicolo nella formazione e le fermate alle quali si ferma il veicolo durante la corsa, con dettagli sulla fermata, binario e settore in cui si ferma il veicolo nelle rispettive fermate.
      • Questa ricerca non include la panoramica completa del treno lungo le fermate.
    • Possibile caso applicativo: Il tracciamento di un carro specifico.
  3. In base a fermate e treni – https://api.opentransportdata.swiss/formation/v2/formations_full
    • Cosa fa il servizio:
      • Emettere le formazioni per ogni fermata, ma anche per ogni veicolo.
    • Di cosa ha bisogno il servizio:
      • I parametri sono gli stessi delle formazioni_stop_based e formations_vehicle_based
    • Cosa offre il servizio:
      • Le fermate E gli elementi della formazione come per le rispettive varianti sopra descritte.
  4. Informazioni sullo stato del servizio – https://api.opentransportdata.swiss/formation/v2/health
    • Cosa fa il servizio:
      • Fornisce lo stato sull’attuale stato d’esercizio.
    • Di cosa ha bisogno il servizio:
      • Niente, nessun parametro.
    • Cosa offre il servizio:
      • Stato dell’attuale stato d’esercizio.

I parametri della query

I seguenti parametri vengono trasmessi come parametri della query (query parameters) dopo un «?» nell’URL (GET request):

Parametri Descrizione del valore e valore esemplificativo
evu Il EVU per il quale deve essere presentata la richiesta. Attualmente consentito: BLSP, FFS P, MBC, OeBB, RhB, SOB, Thurbo, TPF, TRN, VDBB, ZB
operationDate La data di partenza del treno e per la quale si desidera presentare la richiesta. Ad es. 2024-09-18
trainNumber Il numero del treno per il quale si desidera consultare i dati sulla composizione. Ad esempio 2806

Un esempio di richiesta potrebbe quindi essere: https://api.opentransportdata.swiss/formation/v2/formations_stop_based?evu=BLSP&operationDate=2025-08-28&trainNumber=2806

La risposta

In questa sede non descriveremo l’intero modello di dati, ma rimanderemo invece al seguente YAML: GitHub.com/openTdataCH/api-explorer/openapi/formation.

Qui si trova l’OpenAPI: opentdatach.github.io/api-explorer/formation/

Interpretazione della stringa breve per la formazione:

Fondamentalmente la struttura della stringa si differenzia a seconda che un binario abbia dei settori o se li conosciamo.

In ogni caso, per la struttura vale quanto segue:

Elemento Descrizione
Settore Lettera („A“ … „Z“)
Stato „-“ Veicolo chiuso
„>“Veicolo con gruppi che salgono in questo PE
„=“Veicolo (parzialmente) riservato per gruppi in transito
„%“Veicolo aperto, ma non servito (solo nella carrozza ristorante)
Nota: «chiuso» può comparire solo da solo, gli altri caratteri possono essere combinati
 [ Avvio del gruppo di veicoli appartenente al treno
Nota: Consente di distinguere i veicoli ricoverati o da allontanare dai veicoli del treno in corsa.
 ]

Fine del gruppo di veicoli appartenente al treno
Nota: Consente di distinguere i veicoli ricoverati o da allontanare dai veicoli del treno in corsa.
 (

impossibile passare al veicolo attiguo su questo lato del veicolo
Nota: Il calcolo si basa su dati anagrafici e ipotesi. Non vi è alcuna garanzia che questi dati corrispondano alla realtà.
 )

impossibile passare al veicolo attiguo su questo lato del veicolo
Nota: Il calcolo si basa su dati anagrafici e ipotesi. Non vi è alcuna garanzia che questi dati corrispondano alla realtà.
TipoVeicKI

Tipo di veicolo dal punto di vista dell’informazione alla clientela. Significano:
„1“Carrozza viaggiatori 1a classe
„2“Carrozza viaggiatori di 2a classe (anche A/AB declassati)
„12“Carrozza viaggiatori 1a e 2a classe
„CC“Carrozza cuccette
„FA“Carrozza famiglia
„WL“Carrozza letti
„WR“Ristorante (carrozza bistrò, carrozza ristorante ecc.)
„W1“combinazione di carrozza ristorante e carrozza con posti a sedere 1a classe
„W2“combinazione carrozza ristorante e carrozza con posti a sedere 2a classe
„LK“Veicolo motore
„D“Bagagliaio
„F“carrozza fittizia
„K“Veicolo senza classe
„X“carro ricoverato Nota: Il CUS converte il tipo di veicolo ricevuto dal FOS in un „KI-Typ“ dell’esercizio.

A tale proposito si utilizzano le seguenti varianti:
1. Conversione di veicoli troppo lunghi: Gli elettrotreni che forniscono la fonte non per carrozza, ma come veicolo (eccessivo), possono essere scomposti a livello di configurazione dal CUS in carrozze isolate. Nella stringa non appare quindi 1 veicolo (per lo più del tipo „12“), ma 2…n veicoli del tipo „1“, „2“, „12“ oppure „D“. Il numero si misura in base al numero di veicoli percepito dal cliente. Normalmente i veicoli di questo tipo che non conducono la prima classe al centro del treno vengono trasportati in veicoli senza classe del tipo „K“ trasformato.
2. Conversione dei singoli veicoli sulla base delle espressioni regolari: Tutti i singoli veicoli vengono convertiti in veicoli KI generici tramite espressioni regolari e prioritarie.
3. Conversione di veicoli singoli in base al numero di posti a sedere: Se l’espressione regolare riportata al punto 2) non corrisponde, il tipo viene determinato in base al numero di posti a sedere in 1a e 2a classe. Se il veicolo non dispone di posti a sedere, il tipo „D“ assegnato.

Nota relativa a “F”: Sui binari con settori il delta tra la lunghezza del treno e il bordo fermata viene riempito in testa e/o in coda con carrozze fittizie.

Nota relativa a “X”: i carri ricoverati influenzano l’assegnazione dei veicoli di un treno ai settori, ma non sono parte integrante del treno interessato.
N° Ord Numero d’ordine della prenotazione di posti singoli visualizzato dai viaggiatori sulla carrozza (numero a 3 cifre)
Offerta Elenco delle offerte relative ai veicoli. Queste includono:
„BHP“ Posti per sedie a rotelle
„BZ“Zona business
„FZ“Zona famiglia
„KW“Piattaforma per carrozzine
„NF“Veicolo con accesso a pianale ribassato
„VH“Gancio/piattaforma per biciclette
„VR“gancio/piattaforma per biciclette con obbligo di prenotazione

Quali sono i termini e i concetti più importanti da conoscere?

Come parte della nostra interfaccia utilizziamo i seguenti elementi (senza elementi container)

  • StopPoint
    • Uno StopPoint è una fermata lungo l’orario
  • StopTime
    • Orari di partenza e di arrivo
  • Track
    • Il binario nello stoppoint
  • FormationShortString
    • La rappresentazione breve della formazione (come definita da CUS)
  • VehicleGoal
    • Quali carrozze rimangono insieme a quale destinazione partendo da una fermata
  • JourneyMetaInformation
    • Identificazione univoca della corsa
  • TrainMetaInformation
    • Proprietà descrittive del treno
  • FormationMetaInformation
    • Dettagli sull’intera formazione, ad es. numero di veicoli
  • ScheduledStop
    • StopPoint, StopTime, Track, Dettagli su come gestire il treno alla fermata (ad es. se il treno si ferma o se transita), nonché scostamenti rispetto alla corsa (ad es. ritardi all’arrivo).
  • VehicleIdentifier
    • Attributi che identificano in modo univoco un veicolo, come ad es. european vehicle number (EVN). Una particolarità in questo caso è che un veicolo può essere parte di un treno articolato e quindi non può EVN ma solo un «generato». In questo caso, fare clic su «Parent-EVN» rinviata.
  • WheelchairSymbolProperties
  • AccessibilityProperties
    • Ulteriori caratteristiche che possono essere utilizzate ai fini di una rappresentazione conforme alle esigenze dei disabili
  • PictoProperties
    • Se su un veicolo sono rappresentati i diversi pittogrammi
  • DirectTrolleyInformation
    • Se la formazione rappresenta carrozze dirette
  • VehicleRelation
    • Questo elemento consente di tenere traccia della corsa precedente e successiva della formazione indicata, che può essere anche una corsa con carri diretti
  • VehicleProperties
    • Proprietà di un veicolo come parte di una formazione, cioè di un elemento della formazione e da dove a dove la carrozza fa parte della formazione.
  • FormationVehicleAtScheduledStop
    • Visualizzazione della formazione per fermata (per la richiesta vehicle_based)
  • VehicleRelationship
    • La relazione di corsa, ossia come la corsa cambia tra due corse (ad es. se è presente una soppressione)
  • VehicleRelationshipDetails
    • I dettagli di una relazione di corsa.

Limitazioni

  1. I dati sono limitati alle imprese di trasporto ferroviario (EVU) che mettono a disposizione le proprie formazioni tramite le Ferrovie federali svizzere (FFS) e hanno acconsentito alla pubblicazione dei propri dati come Open Data.
  2. Il servizio rende disponibili tutti i dati e i dati basati sui veicoli solo se tutte le fonti dispongono di tutti i dati necessari. Ciò è particolarmente importante se si considera che il CUS contiene solo i dati per oggi.
  3. Concretamente i dati provengono dal sistema in tempo reale SKI (CUS – CUstomer (Information) System – VerkehrsMittel (VM)) e il Formation-Services (FOS) delle FFS.