Aggiornato a ottobre 2024: Potete trovare informazioni sulle continue modifiche nel nostro Changelog.
Fondo
Cosa sono i dati di formazione?
I dati di formazione sono informazioni sui carri (e sulle locomotive) di un treno. Contengono non solo la posizione dei singoli carri in un treno, ma anche le loro caratteristiche. Ad esempio, i dati di formazione possono essere utilizzati per scoprire quale vagone di un treno specifico (ad es. Il treno numero 1234) è a pianale ribassato, cioè consente un facile accesso alle sedie a rotelle o ai passeggini.
Chi sta dietro tutto ciò?
Il servizio è fornito dal gruppo di lavoro del sistema Customer Information Plus (SKI+) per conto dell’Ufficio federale dei trasporti (UFT) in Svizzera.
Otteniamo i dati sulle formazioni da due sistemi:
- Il Servizio di Formazione (FOS) è l’interfaccia delle FFS a cui le varie imprese ferroviarie (IF) trasmettono i loro dati di formazione.
- L’interfaccia dei mezzi di trasporto del sistema in tempo reale (CUS) del Customer Information System (SKI), che gestisce i dati in tempo reale di tutti i mezzi di trasporto pubblico.
Mentre l’interfaccia FOS fornisce “solo” i dettagli delle formazioni, l’interfaccia CUS arricchisce i dati con dettagli quali la posizione dei carri (settori) sul binario alle 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 di un binario di una stazione ferroviaria è possibile l’accesso con sedia a rotelle (particolarmente importante nel contesto della legge sulla discriminazione dei disabili (BehiG))
- in cui sono disponibili ganci per biciclette per carrozze
- quanti posti sono generalmente disponibili in una carrozza
- In combinazione con le nostre previsioni di occupazione, è possibile visualizzare l’occupazione (a livello di treno).
- quali tipi di locomotive e carri circolano su quali tratte (ad esempio, per i trainspotter o per le aziende di trasporto che combinano i loro servizi con le ferrovie)
Come si accede ai dati/interfacce?
| Dati
Poiché i dati di formazione sono in continua evoluzione, non li offriamo come esportazione di dati, ma solo come interfaccia. Interfacce I dati sulla formazione sono riportati qui: https://opentransportdata.swiss/dataset/formations |
Descrizione tecnica
Quali servizi (endpoint dell’interfaccia) offre l’interfaccia dati di formazione?
L’interfaccia dati di formazione supporta le seguenti varianti di richiesta. I dettagli delle richieste sono documentati anche attraverso l’interfaccia OpenAPI:
- Arresto basato su
- Per questo si usa l’endpoint: formations_stop_based
- Cosa fa il servizio:
- Determinare le formazioni per ogni fermata del viaggio di un treno.
- Cosa serve al servizio:
- Il nome di un’IF: l’elenco delle IF autorizzate è limitato a quelle che hanno dato il consenso all’utilizzo dei propri dati di formazione.
- Un giorno operativo: il giorno per il quale la formazione deve essere interrogata. La data non può essere passata. La data può essere solo oggi +3 giorni (a causa dell’inclusione dei dati in tempo reale di CUS).
- Il numero del treno (noto anche come numero del mezzo di trasporto): il treno per il quale si desidera richiedere la formazione. Questo numero può essere ottenuto in vari modi, anche attraverso i dati dell’orario (in vari formati).
- Cosa offre il servizio:
- Le fermate di un treno, con i dettagli delle fermate, la formazione con cui il treno parte dalle fermate, e quando, da quale binario, e con quali locomotive/vagoni rimangono insieme fino a dove. Il fattore decisivo qui è che specifichiamo la formazione in una notazione compatta che ha la sua origine in CUS!
- Questa ricerca non contiene tutti i dettagli per ogni carro.
- L’interpretazione della stringa corta di formazione è descritta di seguito!
- Possibile caso d’uso: visualizzare la formazione di un treno su un binario per una fermata specifica.
- Basato sul treno
- Per farlo, utilizzare l’endpoint: formazioni_autoveicolo_base
- Cosa fa il servizio:
- Determinare le formazioni per veicolo (cioè per elemento di formazione) del treno.
- Cosa serve al servizio:
- I parametri sono gli stessi di formazioni_arresto_based
- Cosa offre il servizio:
- Gli elementi della formazione con i dettagli di ciascun veicolo, la posizione del veicolo nella formazione, nonché le fermate in cui il veicolo si ferma lungo il percorso con i dettagli della fermata, il binario e il settore in cui il veicolo si ferma alle rispettive fermate.
- Questa interrogazione non include la vista complessiva del treno lungo le fermate.
- Possibile caso d’uso: tracciamento di un veicolo specifico.
- Fermate e treni basato su
- Per farlo, utilizzare l’endpoint: formations_full
- Cosa fa il servizio:
- Le formazioni possono essere emesse sia per fermata che per veicolo.
- Cosa serve al servizio:
- I parametri sono gli stessi di formations_stop_based e formations_vehicle_based
- Cosa offre il servizio:
- Gli arresti E gli elementi di formazione come nelle rispettive varianti sopra descritte.
Interpretazione della stringa corta di formazione:
| Fondamentalmente, la struttura della stringa varia a seconda che una traccia abbia dei settori o che questi siano noti. | ||||||||||||||||||
  |
||||||||||||||||||
In jedem Fall gilt folgendes für den Aufbau:
|
Quali sono i termini e i concetti più importanti da conoscere?
Utilizziamo i seguenti elementi come parte della nostra interfaccia (senza elementi contenitori)
- StopPoint
- Un punto di fermata è una fermata lungo l’orario.
- StopTime
- L’orario di partenza e di arrivo
- Track
- Il tracciato al punto di arresto
- FormationShortString
- La rappresentazione breve della formazione (come definita dalla CUS)
- VehicleGoal
- Quali carrozze rimangono insieme fino a quale destinazione, come si vede da una fermata
- JourneyMetaInformation
- Identificazione chiara del viaggio
- TrainMetaInformation
- Proprietà descrittive del treno
- FormationMetaInformation
- Dettagli sull’intera formazione, ad es. numero di veicoli
- ScheduledStop
- StopPoint, StopTime, Track, dettagli sulla gestione del treno alla fermata (ad esempio, se il treno si ferma o passa) e sulle deviazioni del viaggio (ad esempio, se il treno si ferma o passa). Ritardi all’arrivo)
- VehicleIdentifier
- Attributi che identificano in modo univoco un veicolo, come il numero di veicolo europeo (EVN). Una caratteristica particolare è che un veicolo può far parte di un treno articolato e quindi non ha un proprio EVN, ma solo uno “generato”. In questo caso, fare riferimento a “Parental EVN”.
- WheelchairSymbolProperties
- Proprietà necessarie per determinare il simbolo della sedia a rotelle (s. auch Accessibilità nel pianificatore del viaggio, solo in Tedesco & Francese)
- AccessibilityProperties
- Altre caratteristiche che possono essere utilizzate in termini di presentazione a misura di disabile
- PictoProperties
- Se i vari pittogrammi sono visualizzati su un veicolo
- DirectTrolleyInformation
- Se la formazione rappresenta carri diretti
- VehicleRelation
- Questo elemento consente di tracciare il movimento precedente e successivo della formazione data, che può anche essere un movimento diretto del carrello.
- VehicleProperties
- Caratteristiche di un veicolo come parte di una formazione, cioè un elemento della formazione, e da dove a dove il veicolo è parte della formazione
- FormationVehicleAtScheduledStop
- La rappresentazione della formazione per fermata (per la richiesta vehicle_based)
- VehicleRelationship
- La relazione con il viaggio, cioè come cambia il viaggio tra due viaggi (ad esempio, se c’è una cancellazione)
- VehicleRelationshipDetails
- I dettagli di una relazione itinerante.
Restrizioni
- I dati sono limitati alle imprese ferroviarie (IF) che forniscono le loro formazioni attraverso le Ferrovie Federali Svizzere (FFS) e che hanno acconsentito alla pubblicazione dei loro dati come open data.
- Il servizio fornisce tutti i dati e i dati relativi ai veicoli solo se tutte le fonti (vedi nota 1) dispongono di tutti i dati richiesti. Questo è particolarmente importante se si considera che il CUS ha solo i dati di oggi + 3 giorni.
- In particolare, i dati provengono dal sistema in tempo reale SKI (CUS – CUstomer (Information) System – VerkehrsMittel (VM)) e dai Servizi di Formazione (FOS) delle FFS.
Descrizione tecnica
Accesso all’API
Per poter utilizzare l’API/interfaccia è necessario un token. Questo token può essere ottenuto tramite il Portale sviluppatori (Developer Portal).
Gli endpoint specifici
I tre endpoint sopra descritti sono accessibili tramite i seguenti URL:
- https://api.opentransportdata.swiss/formations_stop_based
- https://api.opentransportdata.swiss/formations_vehicle_based
- https://api.opentransportdata.swiss/formations_full
I parametri sono i seguenti:
| Parametro | Descrizione del valore ed esempio di valore |
| evu | L’IF per la quale deve essere effettuata l’interrogazione. Attualmente ammessi: BLSP, SBBP, MBC, OeBB, RhB, SOB, THURBO, TPF, TRN, VDBB, ZB |
| operationDate | La data in cui circola il treno e per la quale si desidera effettuare la richiesta. Ad esempio 2024-09-18 |
| trainNumber | Numero del treno per il quale si desidera interrogare i dati sulla formazione. Ad es. 2806 |
| includeOperationalStops | Se devono essere emesse anche le fermate operative (di solito non rilevanti per i clienti!). Ad esempio, false |
Un esempio di richiesta potrebbe essere: https://api.opentransportdata.swiss/formations_stop_based?evu=BLSP&operationDate=2024-09-18&trainNumber=2806&includeOperationalStops=false
Non descriveremo qui il modello di dati completo, ma faremo riferimento al seguente YAML: formations_yaml_change_file_ending.txt (il file è un “.txt”, deve essere cambiato in “.yaml”).
[una documentazione swagger potrebbe essere disponibile qui in futuro].
Restrizioni
- L’interfaccia esiste come beta dall’ottobre 2024 ed è in continuo sviluppo. Ciò significa che il modello dei dati può ancora cambiare.