Indice della materia

Ricerca nella pagina

Tools & More

#AutoTranslate

Descrizione breve

Che cos’è Tools & More?

Questa pagina offre una panoramica dei diversi strumenti, sistemi e link di approfondimento che possono aiutare gli utenti di OpenTransportData.swiss.

Chi sta dietro tutto questo?

Gli strumenti, i sistemi e i link qui presentati sono stati aggiornati dal nostro team Attività di sistema Informazione alla clientela + (SKI+), ai nostri partner o a imprese esterne.

Perché l’offerta Piattaforma Open Data a questi strumenti?

Molti di questi strumenti aiutano a osservare e utilizzare meglio i dati e le interfacce su OpenTransportData.swiss.

Descrizione del funzionamento

Per la gestione di Dati relativi all’orario HRDF

HRDF Duplicates

  • Link: https://tools.opentransportdata.swiss/hrdf-duplicates-report/report
  • Codice di programma: https://github.com/openTdataCH/OJP-Showcase/tree/develop/apps/hrdf-duplicates-report
  • Destinazione d’uso: questo strumento consente di identificare le corse contraddittorie nei dati HRDF e verificare se si tratta di duplicati o convalidare analogie. Concretamente, il sistema cerca *Z voci del numero di corsa appartenenti alla stessa impresa di trasporto. Secondo la definizione HRDF vale che «…Numero corsa un numero univoco per ogni consegna all’interno di un’amministrazione…» come funzionalità aggiuntiva. Lo strumento tiene conto anche dei periodi di validità delle corse definiti nel campo BITFELD.
  • Istruzioni:
    • In primo luogo, il record di dati HRDF (vedi https://data.opentransportdata.swiss/dataset/timetable-54-2026-hrdf) ovvero il giorno. È quindi necessario selezionare l’impresa di trasporto, poiché l’univocità vale per ciascuna impresa di trasporto.
      • Il sistema rileva quindi per l’impresa di trasporto tutti i numeri di corsa che compaiono più volte, tenendo conto dei loro effettivi periodi di validità. Il risultato viene emesso raggruppato per categoria d’offerta o tipo di mezzo di trasporto. Nell’esempio, per il tipo di mezzo di trasporto «EC» ci sono 4 numeri di corsa (310, 320, 322, 328) che sono duplicati. Il numero di corsa 771 del tipo IC 3 sembra avere 19 duplicati.

      • Nella vista dettagliata dei duplicati, un utente può ora osservare e verificare più da vicino i possibili duplicati. Un’ispezione visiva delle prime tre voci mostra chiaramente le differenze, quindi le varianti visualizzate non sono duplicati «veri». Secondo il contratto di distribuzione HRDF (quindi teoricamente) sarebbero però lo sarebbero.
      • Nota: lo strumento offre una rappresentazione alternativa attraverso la selezione «Consolidated Report» (Rapporto consolidato). In cui tutti i duplicati identificati di tutte le imprese di trasporto e di tutti i giorni vengono visualizzati sotto forma di tabella.

HRDF Bitfields

  • Codice di programma: https://github.com/openTdataCH/OJP-Showcase/tree/develop/apps/bitfeld-viz
  • Destinazione d’uso: Rappresentazione visiva dei periodi di validità forniti come codice bit nel file BITFELD in formato HRDF. Nello specifico, sono forniti come numeri esadecimali, che a loro volta rappresentano l’ordine dei bit.
  • Istruzioni:
    • Per prima cosa si inserisce il valore del campo bit da visualizzare. Poi si seleziona il periodo d’orario da applicare.

    • Successivamente verrà visualizzata una visualizzazione dei dati inseriti

    • Avvertenza: è anche possibile inserire campi bit «reali», cioè una sequenza di zeri e uno (011000101…).

HRDF Query

Per la gestione di Orario GTFS e dati in tempo reale

GTFS-Static & GTFS-RT Comparer

  • Codice di programma: https://github.com/openTdataCH/OJP-Showcase/tree/develop/apps/gtfs-rt-status
  • Destinazione d’uso: questo strumento consente di confrontare i dati statici GTFS (Static) con i dati in tempo reale (Real-time) per individuare elementi di dati mancanti nei rispettivi record di dati. Gli elementi di dati sono le imprese di trasporto, nonché le corse / i viaggi specifici.
  • Istruzioni:
    • I file GTFS-Static e GTFS-Realtime sono già stati preimpostati. È possibile specificare l’intervallo di tempo nel quale verificare la presenza di scostamenti. Premere il pulsante «Compare» per effettuare il confronto.
    • Dopo il confronto, le differenze rispetto al record di dati statico vengono innanzitutto visualizzate a partire dal record di dati in tempo reale. In concreto, una piccola panoramica con il numero di scostamenti («Stats»). In seguito, le imprese di trasporto sono disponibili per i dati in tempo reale, ma non nella scheda corrispondente (https://data.opentransportdata.swiss/dataset/go-realtime) («Agencies missing from GO-Realtime»). Le imprese di trasporto che sono presenti nel registro, ma per le quali non sono stati trovati dati in tempo reale («Agencies without GTFS-RT»). Un elenco di record di dati in tempo reale GTFS per i quali non è stato trovato alcun corrispettivo adeguato nel record di dati statici («Missing GTFS static entries»).
    • Alla panoramica per GTFS Realtime, segue una panoramica per GTFS Static. Per prima cosa, come in precedenza, il numero di scostamenti («stats») con «segno al contrario». Poi c’è l’elenco dei dati statici per i quali mancano i dati in tempo reale. Nella colonna «Stops» le fermate già raggiunte sono indicate in grigio chiaro, mentre le fermate future sono indicate in nero.

GTFS-Static & GTFS-RT Comparer Report

  • Codice di programma: https://github.com/openTdataCH/OJP-Showcase/tree/develop/apps/gtfs-rt-static-report
  • Destinazione d’uso: Questa è una rappresentazione visivamente accattivante del rapporto comparativo descritto sopra. Può essere utilizzata, ad esempio, per visualizzare movimenti insoliti nelle quantità di dati. Nonché per riconoscere modelli ricorrenti o insoliti. Rispetto al comparatore «puro», questa vista serve per la panoramica mensile dei dati ivi ricavati.
  • Istruzioni:
    • Per prima cosa si può selezionare il mese da visualizzare e i valori da visualizzare nel confronto. Il risultato viene visualizzato nella tabella sottostante, dove vengono visualizzati i valori per giorno e ora per il giorno in questione. Nella figura qui è riportato il numero dei dati in tempo reale relativi ai giorni e alle ore del mese di settembre 2024. Le diverse tonalità di blu rappresentano diversi record di dati GTFS.

    • A seconda della cella selezionata, è possibile visualizzare i dettagli dei dati sul lato destro. Il tag «DATA» indica problemi del server o problemi di file. MATCH significa che troppi record sono diversi. Mentre «RT age» indica un record RT che differisce troppo temporaneamente. I dettagli possono essere letti anche qui: https://github.com/openTdataCH/OJP-Showcase/blob/develop/tools/gtfs-rt-static-compare/docs/gtfs-rt-static-compare.md

GTFS Shapes Checker

  • Codice di programma: GbC
  • Destinazione d’uso: Consente di visualizzare i file shape GTFS precedentemente caricati (da noi), come https://tools.opentransportdata.swiss/gtfs-shapes-analyse-v2/data/gtfs-db-lookups-2023-09-05-mentz.json) visivamente.
  • Istruzioni:
    • Si può cercare un Trip desiderato nel file delle forme oppure fare clic con il tasto sinistro del mouse sulla mappa, vicino alle «graph shapes» raffigurate, visibili come linee blu sulla mappa (esempio evidenziato in giallo nello screenshot). In seguito vengono visualizzati tutti i Trip nelle vicinanze e si può selezionarne uno facendo clic sul pulsante blu sulla destra (contenuto con l’ID del Trip) per evidenziarlo visivamente sulla mappa. Inoltre, i dettagli sono visualizzati con testo in basso a destra.

Creazione di forme

  • Codice di programma: https://github.com/ad-freiburg/pfaedle
  • Scopo d’utilizzazione: Creazione di mappe matching per i feed GTFS sulla base dei dati OSM
  • Istruzioni: Seguire le istruzioni nel repository.

Per la gestione di Dati eventi SIRI

SIRI SX Overview

  • Con ?debug=1  maggiori dettagli sono disponibili alla fine dell’URL. Per la ricerca di testo, è necessario inserire uno SBOID o un SSTID (non una ricerca di testo intero)!
  • Codice di programma: https://github.com/openTdataCH/siri-sx-situation-monitor
  • Destinazione d’uso: Visualizza le informazioni sugli eventi in arrivo in formato SIRI SX come semplice elenco.
  • Istruzioni: Non c’è una configurazione particolare (a meno che non si imposta ?debug=1)

SIRI SX Map

  • Codice di programma: https://github.com/openTdataCH/siri-sx-map?tab=readme-ov-file
  • Destinazione d’uso: rappresentazione georeferenziata dei messaggi SIRI-SX su una mappa.
  • Istruzioni:
    • È una mappa su cui sono rappresentati gli eventi. Facendo clic sui marker colorati o sulle linee si ottengono maggiori dettagli al riguardo. È inoltre possibile selezionare la lingua e alcuni altri parametri per la ricerca e la visualizzazione.

GTFS Query 

  • Codice di programma: OJP-Showcase/apps/gtfs-query at develop · openTdataCH/OJP-Showcase (github.com)
  • Destinazione d’uso: questo sistema consente di visualizzare i dettagli dell’orario GTFS corretti sulla base dei dati dell’evento forniti da SIRI-SX.
  • Istruzioni:
    • Innanzitutto, lo strumento deve Panoramica di SIRI SX (vedi sopra) con l’aggiunta ?debug=1 (alla fine dell’URL).
    • Quindi è necessario aprire la vista Sviluppatore con la vista Protocollo di rete del browser.
    • Dopodiché è necessario fare clic sul pulsante «Build Link». Nella richiesta presentata, nelle informazioni header è presente un link che inizia con https://tools.odpch.ch/gtfs-rt-status/api/gtfs-query/trips? (Esempio evidenziato in giallo nella schermata sottostante):

    • Se si richiama questo link nel browser, si apre la vista seguente. Qui vengono visualizzati i dettagli dell’orario per la parte GTFS interessata dall’evento. Nel caso in questione la linea 22 è interessata in GTFS per la data indicata con 59 inserimenti.

Per la gestione del Open Journey Planner

App demo OJP

  • OJP-1.0: opentdatach.github.io/ojp-demo-app/search?v=1
  • OJP 2.0: opentdatach.github.io/ojp-demo-app/search
  • Destinazione d’uso: uno strumento per testare l’interfaccia OJP e le sue funzionalità. L’app serve principalmente a dimostrare le funzionalità del sistema e non è concepita come un’app a tutti gli effetti! L’app consente di inviare richieste tipiche al sistema OJP nello standard OJP. Ciò è possibile in vari endpoint (ad es. test o integrazione) per le versioni standard dell’OJP 1 e 2. Tutte le funzionalità previste possono essere testate nella versione BETA, che risulta spesso instabile.
  • Istruzioni:
    • Journey Search
      • Per default è selezionata la scheda «Journey Search» (Ricerca viaggio) ed è possibile effettuare una classica ricerca di un itinerario inserendo i campi «Da» e «A» di partenza e destinazione del viaggio desiderato. Inoltre è possibile scegliere la (multi)modalità di trasporto desiderata, ad esempio «Mode at End» e «Bicycle Sharing», ovvero percorrere l’ultimo miglio in bicicletta. Come descritto in precedenza, questa configurabilità serve a scopo dimostrativo – un programma per utenti finali probabilmente lo farebbe in modo diverso. Si può anche impostare il giorno e l’ora (partenza o arrivo). Per gli ambienti si dovrebbe lasciare PROD (sistema e server Produzione). LA beta è l’acronimo di Linking-Alps beta e consente di eseguire interrogazioni nell’ambito del Comunità LinkingAlps da testare (collegamenti internazionali verso l’Alto Adige/Austria/Slovenia). Con il pulsante «Debug XML» è possibile visualizzare la richiesta XML.

      • Dopo aver effettuato la ricerca, sono disponibili altre funzionalità. Con il pulsante «XML» nella sezione di ricerca è possibile visualizzare l’XML di richiesta e di query. Inoltre, ora vengono visualizzate le possibili corse (viaggi), con varie metainformazioni, come la durata del viaggio. Il pulsante «MAP» focalizza la vista sulla mappa sul segmento di corsa corrispondente (Trip Leg). Lo stesso effetto ha anche il clic sulla modalità (ad es. «1. treno – …»). Cliccando sul nome della linea e sul numero del treno (ad es. «IC6 960») si ottiene una panoramica delle fermate del mezzo di trasporto in generale. Degno di nota è il pulsante «Permalink», che consente di salvare in un link una richiesta predefinita per condividerla in un secondo momento (ad es. per la risoluzione di errori). Vengono inoltre fornite informazioni sui ritardi, sulle caratteristiche del mezzo di trasporto e sull’accessibilità, oltre a informazioni di massima sui prezzi.

      • La scheda risultati si comporta come di consueto altrove.
    • Station Board
      • Selezionando la scheda «Station Board» è possibile visualizzare il monitor partenze/arrivi per una fermata specifica. Esempio «Berna, Wankdorf Center». Tutte le altre funzioni funzionano come per la «Ricerca viaggio».

      • Dopo la ricerca vengono visualizzati i risultati con le singole linee, i rispettivi numeri di treni e mezzi di trasporto, gli orari di arrivo e di partenza previsti e i possibili ritardi.

    • Trip Info
      • La scheda «Trip Info» consente di richiamare la vista dettagliata di un determinato treno. Come descritto sopra, è visibile anche facendo clic sul numero della linea e del treno specifico (ad es. IC1 709) nella ricerca del viaggio. È anche il modo per ottenere un «JourneyRef», ovvero uno Swiss Journey ID (SJYID – ID corsa svizzera), ad es. «ch:1:sjyid:100001:709-001» (maggiori informazioni sugli Swiss ID https://www.oev-info.ch/de/branchenstandard/technische-standards/strukturelle-standards). Questo SJYID viene quindi inserito nella schermata.

      • Il risultato indica le diverse fermate della corsa.

Esplora risorse API

  • Codice di programma: https://github.com/openTdataCH/api-explorer2
  • Destinazione d’uso: API Explorer consente di inviare richieste OJP 1.0 e 2.0 in formato XML al nostro back-end. Il suo funzionamento è simile a quello dell’app demo OJP, ma si limita ai tipi di richieste OJP e a una visualizzazione «solo testuale» con domande e risposte XML. Si presuppone l’autenticazione adeguata (vedere anche Howto: Accesso alle nostre API con le chiavi API).
  • Istruzioni:
    • Un’interfaccia Swagger standard fornisce gli endpoint che possono essere richiesti, incluse le richieste di esempio.

Per la gestione dei dati in tempo reale per i test

Su GitHub vengono messe a disposizione richieste e risposte OJP, talvolta con dati SIRI e GTFS registrati dall’esercizio. Possono essere utilizzati come dati simulati per i propri test e mostrano in modo esemplificativo come i dati in tempo reale vengano comunicati attraverso diversi canali, che possono variare a seconda del mezzo di trasporto o del gestore.

Come ulteriore possibilità per testare le proprie applicazioni con adattamenti in tempo reale, su OJP 2.0 INT vengono importati costantemente casi concreti. Per queste modifiche sono disponibili richieste con condizioni di test su GitHub come Postman e Bruno Collection. I casi d’uso in tempo reale inseriti possono essere utilizzati a scopo di test. Tuttavia, per l’accesso OJP 2.0 INT serve una chiave API con motivazione a opendata@sbb.ch richiesta.

Ulteriori informazioni sono riportate nel relativo Repo su GitHub per l’apprendimento.

App demo OJP

E altro ancora

La seguente pagina web contiene un elenco di strumenti utili soprattutto per la gestione dei dati GTFS: https://github.com/MobilityData/awesome-transit