Table of Contents |
---|
Innledning
Overordnet
...
Table of Contents |
---|
Innledning
Overordnet
Denne avtalen regulerer og beskriver Ruters krav til digitale tjenester i tilknytning til sin produksjon. Avtalen beskriver utvekslingen av data mellom en Tjenesteyter, som regel et operatørselskap for mobilitetstjenester, og Ruter As (heretter kalt Tjenestemottaker), som er administrasjonsselskap for mobilitetstjenester i Oslo, og deler av Viken.
...
Spesielle krav til Salg/billettering vedlikeholdes i et vedlegg til denne avtalen.
Vedlegg – Krav Salg/Billettering
Spesielle krav til kortlesere for validering av reiserett
...
Spesielle krav til Dynamisk passasjerinformasjon vedlikeholdes i et vedlegg til denne avtalen
Vedlegg – Krav Dynamisk passasjerinformasjon
Spesielle krav til MQTT
For kjøretøy i funksjonskategorier omfattet av MQTT, skal alle Tjenesteyters kjøretøy/fartøy rute datatrafikken gjennom en MQTT broker med bridging mot Tjenestemottaker. Dataemner skal her oversettes mellom kjøretøyets/fartøyets lokale adresser og Tjenestemottakers globale adresser. Tjenestemottaker leverer en konfigurasjonsfil med disse oversettelsene for alle nødvendige dataemner.
...
Intensjonen med ytelsesnivåene er å insentivere tjenesteyter til å fokusere på de viktigste dataemnene først, siden dataemnene på nivåene under har liten eller ingen verdi uten data på nivåene over.
Beregning av datakvalitet
Hvilke avganger måles
...
av datakvalitet
Hvilke avganger måles
Operatør definerer selv hvilke turer et kjøretøy skal betjene, også kalt tjenestevindu / “serviceWindow”.
Det er turene definert i et tjenestevindu / “serviceWindow” som blir målt i en måleperiode.
Eksempler
Her definerer tjenestevinduet at det betjener tur 1, tur 2 og tur 3. Derfor er det disse 3 turene/avgangene som måles.
...
Her definerer tjenestevinduet at tur 1 og tur 2 skal betjenes, da er det disse turene/avgangene som blir målt.
...
Tjenestevinuet kan endres underveis, det gjøres ved å sende en oppdaterings-melding (assignment - UPDATE). Når tjenestevinduet endres, endres også hvilke turer som måles.
...
Det er altså slik tjenestevinduet ser ut ved måleperiodens slutt, forklart under Måleperiode for rutesatt transport, som definerer hvilke avganger som blir målt.
Dersom denne intensjonen senere endrer seg skal det sendes en oppdateringsmelding, som igjen endrer hvilke turer som blir målt.
...
Måleperiode for rutesatt transport
...
Mottak av signoff definerer slutten av måleperioden.
Hvis signoff ikke sendes slutter måleperioden 2 timer etter planlagt ankomst på siste holdeplass i tjenestevinduet (serviceWindow).
Med unntak av dataemne pålogging og avlogging av kjøretøy, så har hele måleperioden samme ytelseskrav. Det er flere grunner til det:
...
Tjenestemottaker bør tilstrebe at ytelsen bare måles der det er relevant og at ytelseskravene for de ulike dataemnene tar høyde for operativt arbeid mellom ruteavganger.
Eksempel
Figuren under illustrerer et vognløp, en blokk og tre avganger.
...
Når kjøretøyet logger på og av på denne blokken, defineres service-vinduet på denne måten:
...
Hvis signoff ikke sendes slutter måleperioden 2 timer etter planlagt ankomst på siste holdeplass i intensjonen som er definert av service-vinduet:
...
arbeid mellom ruteavganger.
Måling av assignment-tjenesten (gjelder rutesatt transport)
Se beskrivelse av ytelseskravene i tabellen under her.
Eksempler
Intensjonen Intensjonen under ytelseskravene for pålogging og avlogging av kjøretøy sier at operatørene skal logge på en blokk i et vognløp, med mindre det skjer noe uforutsette endringer.
Figuren under illustrerer et vognløp, tre blokker og er zoomet inn på en blokk med tre avganger/turer.
...
Hvis signon er mottatt under 20 minutter etter planlagt avreise fra første avgang, og signoff er mottatt under 2 timer etter planlagt ankomst ved siste avgang. Alle avgangene er godkjent.
...
Signon som sendes mer enn 20 minutter etter planlagt avreise fra første avgang i turen godkjennes ikke.
...
Dersom signoff sendes mer enn 2 timer etter planlagt ankomst ved siste avgang godkjennes ikke den siste turen i tjenestevinduet (serviceWindow).
...
Signon signon er mottatt under 20 minutter etter avgang planlagt avreise fra første avgang, og signoff er mottatt under 2 timer etter planlagt ankomst ved siste avgang. Alle avgangene er godkjent.
...
Signon som sendes mer enn 20 minutter etter planlagt avreise fra første avgang i turen, godkjennes ikke.
...
Signon som sendes etter dette godkjennes ikke turene som er sendt for sent.
...
Måleperiodene brukes for å definere når de andre tjenestene måles. De måles over hele perioden og gjelder for alle turene definert av service-vinduet.
...
Dersom signoff sendes mer enn 2 timer etter planlagt ankomst ved siste avgang, godkjennes ikke den siste turen i tjenestevinduet (serviceWindow).
Måleperiode for bestillingstransport
Datakvaliteten måles per planlagt blokk. Fra planlagt start av innleietid til planlagt slutt av innleietid, eller siste registrerte pull-in hvis den er etter avtalt slutt av innleietid.
Måling av Posisjon
Se beskrivelse av ytelseskravene i tabellen under her.
Eksempler
Som alle andre dataemner, med unntak av pålogging og avlogging av kjøretøy, gjøres måling av posisjon over hele måleperioden, slik at alle turene i tjenestevinduet vil få samme status.
Nedenfor er to eksempler på posisjonsmålinger, en godkjent og en ikke godkjent.
...
Måling av DPI
Se beskrivelse av ytelseskravene her.
For at DPI skal godkjennes, må både skjermer og funksjonalitet få status godkjent i måleperioden.
...
Brudd på ytelsesnivå 1 gir 1 poeng trekk, ellers går man videre til neste ytelsesnivå.
Brudd på ytelsesnivå 2 gir 0,5 poeng trekk, ellers går man videre til neste ytelsesnivå.
Brudd på ytelsesnivå 3 gir trekk som følger:
DPI: 0,25 poeng trekk
Rutersalg: 0,10 poeng trekk
APC: 0,05 poeng trekk
Hvert resterende dataemne: trekk 0,1 poeng / antall resterende dataemner (f. eks. antall resterende dataemner i ADT 3.2 er 113 er 11 for rutesatt transport - buss)
Ikke målte dataemner teller som godkjent. "Ikke målt" betyr at Ruter ikke har implementert målingen av dataemnet. Hvis Ruter f.eks. ikke måler datakvaliteten på vindusviskerstatus vil den være godkjent, uavhengig av kvaliteten på innsendte data.
...
Ytelsesnivå | Dataemne | Intensjon | Ytelseskrav | Beregning av datakvalitet | ||
---|---|---|---|---|---|---|
1 | Pålogging og avlogging av kjøretøy Pålogging og avlogging av kjøretøy er en svært kritisk funksjon som binder alle dataemner som produseres av et kjøretøy til Tjenestemottakers digitale kundetjenester samt er det som muliggjør utnyttelse av de samme dataemnene til utarbeidelse av statistikk og innsikt. | Pålogging Pålogging skal sendes senest 5 minutter før kjøretøyet starter på en avgang. For første avgang i blokken ønsker vi dette senest ved utkjøring fra depot. Pålogging skal sendes så snart et kjøretøy skal overta for et annet på samme blokk. Det skal sendes ny pålogging for hver blokk hvis det er flere blokker i vognløpet. Det skal ikke sendes pålogginger utover dette. Avlogging Avlogging skal sendes når et kjøretøy ikke lenger skal betjene avgangene det er logget inn på. Oppdatering Oppdatering skal sendes når et kjøretøy kun skal betjene deler av avgangene det er logget inn på. Unnlatelse Hvis operatøren av ulike grunner ikke kan gjennomføre, eller planlegger å sløyfe en tur, skal turen ikke tildeles et kjøretøy, men registreres som utelatt. Unnlatelse skal sendes så snart operatøren planlegger å sløyfe en tur. | Gyldige meldinger
Pålogging skal være mottatt:
Avlogging skal være mottatt:
Unnlatelse skal være mottatt:
| En avgang blir godkjent hvis og bare hvis den : a) Den har korrekt pålogging og avlogging, eller b) Den har korrekt unnlatelse. | ||
1 | Oppdragsutveksling Ruter Førerapp | Pull-out og Pull-in Så fort som mulig. | Pull-out
Pull-in
| En blokk blir godkjent hvis og bare hvis den har korrekt pull-out og pull-in. | ||
1 | Oppdragsutveksling SUTI Oppdragsbekreftelse gjelder overføring, oppdatering og avslutning av aktuelle oppdrag. |
| Godkjent dersom alle krav er godkjent. | |||
1 | Oppdragsrapportering Y2M | Tjenesteyter utveksler data i henhold til grensesnitt beskrevet for funksjonsnivå Y2M. | Godkjent dersom alle krav er godkjent. | |||
2 | Posisjon Posisjon brukes av Tjenestemottaker til å generere fremdrifts-status på turer og vognløp. Denne fremdrifts-statusen brukes til å gi kunder sanntidsinformasjon om avganger, ankomster, forsinkelser og avvik, både om bord i kjøretøyet, men også i andre kundekanaler. Fremdrifts-status er også viktig for å kunne utarbeide statistikk og innsikt om avviklingen av Tjenestemottakers tjenester. | Posisjon skal konfigureres opp til å sende 1 gang/sekundet med beste kvalitet under rådende forhold. For å ta høyde for dårlig mobildekning tillater vi noe datatap. For å ta høyde for at meldingen sendes over mqtt med QoS=0 telles ikke kortere brudd i datastrømmen. For å ta høyde for at strøm blir skrudd av mellom passasjerturer, feks. ved en pause ignoreres brudd som skjer der kjøretøyet sto stille. Da kan også messageNumber resettes til 0. Brudd i datastrømmen der kjøretøyet stod stille ignoreres. |
| Godkjent dersom >95% av alle posisjoner er korrekt mottatt. | ||
3 | Dynamisk passasjerinformasjon (destinasjon, journey, neste stopp, lydmelding) Fremvisning av korrekt informasjon til passasjerene om bord er viktig for Tjenestemottaker. | Verifiser at:
| Kvitteringsmeldinger
DPI-klienten er ansvarlig for å produsere kvitteringsmeldingen.
Operatør er ansvarlig for å produsere og sende en kvitteringsmelding fra kjøretøyet umiddelbart etter mottak. Tilstandsmeldinger Hver gang Tjenestemottaker sender en Journey-melding skal Tjenestemottaker motta en tilstandsmelding innen 60 sekunder fra hver enkelt skjerm. Verifiser at følgende er korrekt:
DPI-klienten er ansvarlig for å produsere tilstandsmeldingen. Operatør er ansvarlig for å oppdatere filer, overvåke nettverk / hardware, overvåke at browser fungerer osv. | Godkjent dersom minst 1 (en) tilstandsmelding fra hver konfigurerte skjerm, som oppfyller alle ytelseskrav er mottatt i løpet av måleperioden. Godkjent dersom Tjenestemottaker har mottatt minst 97% av sendte kvitteringsmeldinger i løpet av måleperioden.(Teksten har blitt endret 18.6.2024) | ||
3 | Salg av billetter Salg av billetter er viktig for å gi inntektssikring for Tjenestemottaker | Sjåføren skal være pålogget på alle stoppesteder gjennom hele avgangen, f.o.m. første holdeplass t.o.m. siste. | På hver holdeplass/stoppested måler RuterSalg-diagnosemodulen at følgende krav er oppfylt:
| Godkjent dersom minst 95% av målte stoppesteder er godkjent. | ||
3 | Passasjertelling (APC) Passasjertelling brukes av Tjenestemottaker for å vise fyllingsgrad på avganger i sanntid, for å kunne gi bedre informasjon til reisende, for å planlegge rutetilbudet, for å vurdere behov for innsatsbusser samt å utarbeide trafikkstatistikk for Tjenestemottakers nettverk. Tellinger kan bli delt eksternt etter utarbeidede prinsipper for å sikre kundene en mer helhetlig og sømløs reise på tvers av mobilitetsleverandører. Passasjertelling brukes også til å validere at kjøretøyets dørsensorer fungerer. | APC tjeneste
Melding må mottas maksimalt 30 sekunder etter endring av dørstatus. For beregning av tjeneste tillates det avviket som gir færrest manglende meldinger i løpet av en måleperiode. Det tillates enten inntil tre (3) manglende meldinger pr. måleperiode eller melding fra 90% av betjente holdeplasser med dørlukking. For beregning av tjeneste tillates det avviket som gir færrest manglende meldinger i løpet av en måleperiode. Det tillates enten inntil tre (3) manglende meldinger pr. måleperiode eller melding fra 90% av totalt antall kombinasjoner av APC presisjon Presisjon mellom avstigende og påstigende måles per måleperiode. Hvis en måleperiode ikke tilfredsstiller kravet til presisjon, regnes presisjonen som underkjent for alle avganger i måleperioden. Avviket må være mindre enn ti (10) personer, eller 10 % etter formelen for prosentvis avvik:
For beregning av presisjon tillates det avviket som gir minst tellefeil i løpet av en måleperiode. | Godkjent dersom alle krav er godkjent. | |||
3 | Dørstatus Dørstatus brukes for å gi bedre sanntidsinformasjon, å styre trafikkprioritering samt å validere at passasjertellere fungerer. For alternative konfigurasjoner kan dørstatus indikere tilgjengelighet for om bord- og avstigning. F.eks. landgang på ferger. |
| Godkjent dersom alle krav er godkjent. | |||
3 | Stoppsignal Stoppsignal brukes for å gi bedre passasjerinformasjon ombord samt å forbedre fremdrifts-status på turer og vognløp. |
| Godkjent dersom alle krav er godkjent. | |||
3 | Validering/aktivering av reiserett Validering av reisrett reiserett bidrar til Tjenestemottakers inntektssikring | Det skal være mulig å validere reiseretter, og eventuelt ha enkel dialog med kunden, på alle stoppesteder gjennom hele avgangen, f.o.m. første holdeplass t.o.m. siste. | (Spesifiseres senere i.h.t. intensjonen.) | (Spesifiseres senere i.h.t. intensjonen.) | ||
3 | Odometer Odometer brukes av Tjenestemottaker som en redundant løsning for posisjon der mottaksforholdene for posisjon er vanskelige eller satellittdekning ikke er tilgjengelig. | Odometer skal konfigureres opp til å sende 1 gang/sekundet, med høyeste oppløsning gitt av sensoren. For å ta høyde for dårlig mobildekning tillater vi noe datatap. For å ta høyde for at meldingen sendes over mqtt med QoS=0 telles ikke kortere brudd i datastrømmen. For å ta høyde for at strøm blir skrudd av mellom passasjerturer, feks. ved en pause ignoreres brudd som skjer der kjøretøyet sto stille. Da kan også messageNumber resettes til 0. Odometerverdien skal reflektere kjøretøyets totale kilometerstand der det er mulig. Brudd i datastrømmen der kjøretøyet stod stille ignoreres. |
Godkjent dersom >95% av alle odometer-meldinger er korrekt mottatt og det ikke gjøres en «roll-over» av odometerverdien i løpet av måleperioden. | 3 | Innetemperatur / Kabintemperatur Innetemperatur kan brukes for å forbedre kundeopplevelse gjennom forbedret etterlevelse av krav til temperatur og mulighet for bedre forvaltning og styring av materiell. Innetemperatur kan også benyttes til bedre informasjon til reisende. Temperaturmålinger skal skje regelmessig og sendes hvert 10. sekund, med ett målepunkt per sensor
| Godkjent dersom >95% av alle odometer-meldinger er korrekt mottatt og det ikke gjøres en «roll-over» av odometerverdien i løpet av måleperioden. |
3 | Innetemperatur / Kabintemperatur Innetemperatur kan brukes for å forbedre kundeopplevelse gjennom forbedret etterlevelse av krav til temperatur og mulighet for bedre forvaltning og styring av materiell. Innetemperatur kan også benyttes til bedre informasjon til reisende. | Temperaturmålinger skal skje regelmessig og sendes hvert 10. sekund, med ett målepunkt per sensor. Brudd i datastrømmen der odometer viser at kjøretøyet flyttet seg mindre enn 10 meterkjøretøyet stod stille ignoreres. |
| Godkjent dersom alle krav er godkjent. | ||
3 | Utendørstemperatur Utendørstemperatur kan brukes for å forbedre prognose på avgangstider og kalibrering/analyse av passasjertellinger. Utendørstemperatur kan også brukes til å følge opp krav til inneklima. | Temperaturmålinger skal skje regelmessig og sendes hvert 60. sekund.
|
til inneklima. | Temperaturmålinger skal skje regelmessig og sendes hvert 60. sekund. Brudd i datastrømmen der odometer viser at kjøretøyet flyttet seg mindre enn 10 meterkjøretøyet stod stille ignoreres. |
| Godkjent dersom alle krav er godkjent. |
3 | Vindusviskerstatus Vindusviskerstatus brukes for å forbedre prognose på avgangstider. | Sendes ved hver tilstandsendring av vindusviskerfunksjon. Brudd i datastrømmen der kjøretøyet stod stille ignoreres. |
| Godkjent dersom alle krav er godkjent. | ||
3 | Akselerometer Akselerometer kan brukes for å skape ny innsikt om generell kundeopplevelse, sikkerhet og veikvalitet. Det kan også brukes til å bedre følge opp kundehenvendelser. | Akselerometermeldinger skal sendes regelmessig og hvert 10. sekund.
|
brukes til å bedre følge opp kundehenvendelser. | Akselerometermeldinger skal sendes regelmessig og hvert 10. sekund. Brudd i datastrømmen der odometer viser at kjøretøyet flyttet seg mindre enn 10 meterkjøretøyet stod stille ignoreres. |
| Godkjent dersom alle krav er godkjent. |
3 | Energiforbruk (kWh) (kun elektriske busser og fartøy) Energiforbruk kan brukes til å samle innsikt om materiellet til ruteplanlegging og for etterlevelse av miljø- og bærekraftsmål. | Energiforbruket skal sendes regelmessig og hvert 60. sekund. Brudd i datastrømmen der kjøretøyet stod stille ignoreres. |
| Godkjent dersom alle krav er godkjent. | ||
3 | Batterinivå (SOC, kun elbuss) Batterinivå brukes for å samle innsikt om bruk av elektriske kjøretøy og fartøy i rutetilbudet. | Batterinivå skal sendes regelmessig og hvert 60. sekund. Brudd i datastrømmen der odometer viser at kjøretøyet flyttet seg mindre enn 10 meterkjøretøyet stod stille ignoreres. |
| Godkjent dersom alle krav er godkjent. | ||
3 | Batterinivå Ladestatus (SOC, kun elbusskun elektriske busser og fartøy) Batterinivå Ladestatus brukes for å samle innsikt om bruk av el-busser i rutetilbudet. | Batterinivå skal sendes regelmessig og hvert 60. sekund.
|
å gi bedre sanntidsinformasjon samt å samle innsikt om bruk av el-busser i rutetilbudet. | Sendes ved hver tilstandsendring av ladestatus eller endring av ladeeffekt. |
| Godkjent dersom alle krav er godkjent. |
3 | Vanntemperatur (kun fartøy) Vanntemperatur kan brukes for å gi informasjon om badetemperatur i Oslofjorden. | Temperaturmålinger skal skje regelmessig og sendes hvert 60. sekund. |
| Godkjent dersom alle krav er godkjent. | ||
3 | Ladestatus Vind-data (kun elbuss) Ladestatus brukes for å gi bedre sanntidsinformasjon samt å samle innsikt om bruk av el-busser i rutetilbudet. |
Sendes ved hver tilstandsendring av ladestatus eller endring av ladeeffekt.
|
Meldinger skal sendes i forbindelse med all batterilading, både innenfor og utenfor måleperioder. Meldinger skal sendes ved hver tilstandsendring av ladestatus. Dersom meldingen inneholder ladeeffekt, skal det også sendes ny melding ved endring av ladeeffekt på mer enn 10 kW. Det telles som brudd dersom det sendes to påfølgende meldinger med samme innhold. Brudd utenfor måleperiode telles i den påfølgende måleperioden. Det tillates 3 brudd per måleperiode. Måleperioden er ikke godkjent dersom det ikke sendes melding om lading som kan knyttes til en økning av batterinivået med minst 10 prosentpoengfartøy) Vind-data kan brukes for å gi bedre informasjon om værforholdene i Oslofjorden. | Vindmålinger skal skje regelmessig og sendes hvert 60. sekund. |
| Godkjent dersom alle krav er godkjent. |
Godkjenning av dataprodusenter
...