Sanntid

I håndbok N801 er det beskrevet hva kollektivtilbydere må levere inn av data, og hvilken rolle Entur har i Norge. Entur har også en aktiv rolle i internasjonalt samarbeid om videreutvikling av SIRI-protokollene, og har bidratt mye til den nordiske profilen.

Praktiske eksempler på hvordan meldingene skal se ut finnes på GitHub. (Les mer under Mottak og distribusjon)

Entur tilbyr i dag et verktøy for innsending av SX-data og enkelte meldinger i ET-format. Grensesnittet lar brukeren knytte tekstlige beskjeder til avganger, stoppesteder eller linjer for å informere reisende ved avvik, samt legge inn kanselleringer og ekstraturer.

For å kunne benytte tjenesten, må det etableres en avtale med Entur og opprettes en bruker knyttet til organisasjonen. For å bli partner med Entur, les mer på entur.no eller ta kontakt på kollektivdata@entur.org.

Valideringen sjekker formatet på meldingene og noe logikk, for å vurdere om dette er data som kan leses korrekt og vil vise riktig informasjon til de reisende. Selve grensesnittet viser bare hva som vil gå gjennom og hva som vil feile, og feil blir ikke forkastet her. Det som er kategorisert som alvorlige feil, blir forkastet i selve sanntidstjenesten eller i reisesøkmotoren (OTP). Valideringsrapportene er åpne for alle, og alle som sender inn SX-, VM- og/eller ET-meldinger kan bruke verktøyet til å se om dataene de sender inn feiler eller ikke. Hva de ulike feilmeldingene betyr, og hvordan man søker opp sine data er beskrevet i brukerveiledningen.

Sanntidshuben tar imot rundt 70 strømmer med ET-, VM- og SX-meldinger fra aktører i Norge, og gjør dem tilgjengelig på tvers av alle som sender inn. Tjenesten er et åpen kildekode-prosjekt, Anshar, tilgjengelig på GitHub sammen med dokumentasjon på hvordan den mottar og sender data i henhold til SIRI-protokollen. På GitHub finnes det også et eksempeloppsett av en applikasjon som viser i praksis hvordan kommunikasjon mellom tjenesten og innsender kan se ut, samt eksempler på meldinger i de ulike formatene.

All data er åpent tilgjengelig fra sanntidshuben, og Entur tilbyr ulike formater for å konsumere den. Det er mulig å abonnere direkte på ET-, VM- og SX-strømmene i SIRI-format. Det er disse strømmene som brukes videre i reisesøket, sammen med plandata og andre datakilder. Det tilbys også et SIRI Lite REST API, for periodisk uthenting av data. GTFS-RT er formatet blant annet Google Maps bruker, og er et lettvektsformat med mindre rik data. Dataen kan også lastes ned eller brukes direkte fra BigQuery til for eksempel analyseformål. Hvordan ta i bruk disse formatene er beskrevet på Enturs utviklerportal eller dataportal.

Entur tilbyr et API som kan sende pushvarsler på gitte strekninger til reisende i sin valgte reiseapp. APIet er dokumentert på utviklerportalen, og det er også bygget et grensesnitt som viser hva abonnenter vil se.

For enklere bruk av VM- og ET-data om kjøretøyposisjoner, fyllingsgrad og estimerte ankomsttider er det utviklet et eget API som lar deg vise sanntidsdata direkte til en sluttbruker. Det finnes også et grensesnitt som viser hvordan denne dataen kan brukes i praksis.

Real Time Archive er en tjeneste som gir et bilde av hvilke data som faktisk ble sendt fra sanntidshuben til reisesøkmotoren. Tjenesten tilbys både som et API og som et grensesnitt. Den viser kun ET-meldinger, men det er mulig å søke opp avganger fra alle kollektivtilbydere, og se hver enkelt ET-melding som ble sendt inn til sanntidshuben. Dette gjør det enklere å gjenskape situasjonen slik den var på et gitt tidspunkt, og kan hjelpe aktørene å forstå hva som ble vist til de reisende, og hva som kan ha gått galt hvis reisende opplever å få feil informasjon.

Kvalitetsdashbordet er bygget på historiske data fra BigQuery og viser et overordnet bilde av kvaliteten på sanntidsdata fra de ulike aktørene, for hver av de ulike strømmene. Det er også mulig å gå mer i detalj og se på ulike deler av dataen i hver enkelt strøm. Dashbordet kan også brukes til å måle effekten av eventuelle tiltak for å bedre kvaliteten.

Det finnes flere dashboard å utforske på dataportalen, som du finner her.