Disclaimer: Document is still in draft
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.
...
Hvis kjøretøyet skal levere flere funksjonstyper, skal kjøretøyet levere på alle dataemner til sammen beskrevet i funksjonsnivåtabellen.
Tjenestemottakers Tjenestemottakers transporttjenestekontrakter kan inneholde en beskrivelse av hvilke funksjonsnivåer som skal oppfylles. Komplette funksjonssett gjelder hvis ikke annet er definert.
...
*) Funksjoner med spesialkrav utover det som er definert i ITxPT
...
De aller fleste dataemnene som ønskes overført i sanntid over MQTT, er hentet fra ITxPT sin emnestruktur. Enkelte emner er imidlertid Ruter-spesifikke. Dokumentasjon av API-et er beskrevet i eget versjonert dokument.
Oppdrag og plandata
Plandata for rutesatte turer og vognløp
...
For noe utstyr som ikke er helt eller delvis omfattet av ITxPT standarden kan spesielle krav til maskinvare være vedlagt i egne dokumenter, eller beskrevet i denne avtalen under egne punkter.
For kjøretøy som kun betjener funksjonskategorier for bestillingstransport og/eller er definert som personbil tillates dataleveranser fra utstyr uten ITxPT-merking der tjenesteyter finner det formålstjenlig.
Spesielle krav til Salg/billettering
Spesielle krav til Salg/billettering vedlikeholdes i et vedlegg til denne avtalen
Vedlegg – Krav Salg/Billettering
Spesielle krav til kortlesere for validering av reiserett
...
Tjenesteyter skal besørge montering i henhold til vedlagt spesifikasjon, herunder både strøm og nettverk. Kortleserene skal ha tilgang til nødvendige endepunkter – både om bord, og backoffice.
Tjenesteyter Tjenesteyter skal aktivt overvåke enhetene, både gjennom elektronisk overvåkning i tillegg til daglig visuell inspeksjon.
...
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 skal 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.
...
Kategori | Ytelsesnivå | Dataemne og intensjon | Krav | Terskel for at avgangen skal merkes med |
---|---|---|---|---|
DI | Absolutt | 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. Intensjon Intensjonen er at pålogging og avlogging skal sendes når et kjøretøy starter å betjene og avslutter å betjene et kjøreoppdrag (block). Det skal unngås å sende fiktive manuelle eller systemskapte av- og pålogginger. | Gyldig pålogging skal være mottatt:
Gyldig avlogging skal være mottatt:
| Hvis et eller flere kriterier ikke er oppfylt. |
Sensors | Kritisk | 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. Fremdrifts-status er også viktig for å kunne utarbeide statistikk og innsikt om avviklingen av Tjenestemottakers tjenester. Intensjon Intensjonen er at posisjon skal sendes 1 gang/sekundet med beste kvalitet under rådende forhold. For å ta høyde for dårlig mobildekning tillater vi enkelte brudd i posisjons-strømmen. For å ta høyde for QoS 0 tillater vi at frekvensen på posisjonsmeldinger kan være noe lavere enn ønsket innstilling |
| Hvis et eller flere kriterier ikke er oppfylt. |
Sensors | Kritisk | Odometer Odometer brukes av Tjenestemottaker som en redundant løsning for posisjon der mottaksforholdene for posisjon er vanskelige eller satellittdekning ikke er tilgjengelig. Intensjon Intensjonen er at odometer skal sendes 1 gang/sekundet med beste kvalitet under rådende forhold. For å ta høyde for dårlig mobildekning tillater vi enkelte brudd i datastrømmen. For å ta høyde for QoS 0 tillater vi at frekvensen på meldinger kan være noe lavere enn ønsket innstilling. Odometerverdien skal reflektere kjøretøyets totale kilometerstand der det er mulig |
| Hvis et eller flere kriterier ikke er oppfylt. |
Sensors | Kritisk | Passasjertelling (APC) Passasjertelling brukes av Tjenestemottaker for å vite fyllingsgrad av avganger i sanntid for å kunne gi bedre informasjon til reisende samt å utarbeide trafikkstatistikk for Tjenestemottakers nettverk. Passasjertelling brukes også til å validere at dørsensorer fungerer. |
| Hvis et eller flere kriterier ikke er oppfylt. |
Sensors | - | Klokke Klokkesignalet brukes for å synkronisere tidsfremvisning på enheter som brukes til publikumsinformasjon slik som DPI skjermer. |
| Kravet inngår ikke i ytelseskrav for incentiv ordninger men er omfattet av generelt krav til bruk av API. |
Sensors | - | Kabintemperatur Kabin temperatur brukes for å kunne gjøre en faktabasert behandling av kundeklager samt å utarbeide statistikk for overvåkning av eventuelle andre krav til klima i kjøretøyet. Intensjon Intensjonen er at temperaturmålinger skjer regelmessig, og kan sendes maksimalt 4 ganger i minuttet, men minst en gang i minuttet. med beste kvalitet under rådende forhold. For å ta høyde for dårlig mobildekning tillater vi enkelte brudd i posisjons-strømmen. For å ta høyde for QoS 0 tillater vi at frekvensen på meldinger kan være noe lavere enn ønsket innstilling. | Gjennomsnittlig intervall mellom temperaturmeldinger skal være innenfor et toleransevindu på 14-65 sekunder i løpet av en avgang.
| Kravet inngår ikke i ytelseskrav for incentiv ordninger men er omfattet av generelt krav til bruk av API. Intensjonen er å innføre krav til ytelse i neste major release. |
Sensors | - | Utendørstemperatur Utendørs temperatur brukes for å forbedre prognose på avgangstider og kalibrering/analyse av passasjertellinger. Intensjon Intensjonen er at temperaturmålinger skjer regelmessig, og kan sendes maksimalt 4 ganger i minuttet, men minst en gang i minuttet. med beste kvalitet under rådende forhold. For å ta høyde for dårlig mobildekning tillater vi enkelte brudd i posisjons-strømmen. For å ta høyde for QoS 0 tillater vi at frekvensen på meldinger kan være noe lavere enn ønsket innstilling. |
| Kravet inngår ikke i ytelseskrav for incentiv ordninger men er omfattet av generelt krav til bruk av API. Intensjonen er å innføre krav til ytelse i neste major release. |
Sensors / PE | Normal | 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. |
| Hvis et eller flere kriterier ikke er oppfylt. |
Sensors | - | Stoppsignal Stoppsignal brukes for å gi bedre passasjerinformasjon ombord samt å forbedre fremdrifts-status på turer og vognløp. |
| Kravet inngår ikke i ytelseskrav for incentiv ordninger men er omfattet av generelt krav til bruk av API. |
Sensors | - | Vindusviskerstatus Vindusviskerstatus brukes for å forbedre prognose på avgangstider og kalibrering/analyse av passasjertellinger. |
| Kravet inngår ikke i ytelseskrav for incentiv ordninger men er omfattet av generelt krav til bruk av API. |
Sensors | - | Akselerometer Akselerometer brukes for å skape ny innsikt om generell kundekomfort, sikkerhet og veikvalitet. Intensjon |
| Kravet inngår ikke i ytelseskrav for incentiv ordninger men er omfattet av generelt krav til bruk av API. Intensjonen er å innføre krav til ytelse i neste major release. |
Sensors | - | Energiforbruk (kWh) Energiforbruk brukes til å samle miljø-innsikt om leveranse av rutetilbudet. Intensjon Intensjonen er at energiforbruksmeldinger skal sendes 1 gang i minuttet med beste kvalitet under rådende forhold. For å ta høyde for dårlig mobildekning tillater vi enkelte brudd i datastrømmen. For å ta høyde for QoS 0 tillater vi at frekvensen på meldinger kan være noe lavere enn ønsket innstilling. |
| Kravet inngår ikke i ytelseskrav for incentiv ordninger men er omfattet av generelt krav til bruk av API. Intensjonen er å innføre krav til ytelse i neste major release. |
Sensors | - | Batterinivå (SOC, kun elbuss) Batterinivå brukes for å samle operativ innsikt om bruk av el-busser i rutetilbudet. Intensjon Intensjonen er at SOC skal sendes 1 gang i minuttet med beste kvalitet under rådende forhold. For å ta høyde for dårlig mobildekning tillater vi enkelte brudd i datastrømmen. For å ta høyde for QoS 0 tillater vi at frekvensen på meldinger kan være noe lavere enn ønsket innstilling. |
| Kravet inngår ikke i ytelseskrav for incentiv ordninger men er omfattet av generelt krav til bruk av API. Intensjonen er å innføre krav til ytelse i neste major release. |
Sensors | - | Ladestatus (kun elbuss) Ladestatus brukes for å gi bedre sanntidsinformasjon samt å samle operativ innsikt om bruk av el-busser i rutetilbudet. |
| Kravet inngår ikke i ytelseskrav for incentiv ordninger men er omfattet av generelt krav til bruk av API. |
PE | Kritisk | Dynamisk passasjerinformasjon (DPI) Fremvisning av korrekt informasjon til passasjerene om bord er viktig for Tjenestemottaker | DPI-diagnosemodulen om bord i kjøretøy/fartøy måler hvert minutt under en avgang at følgende krav er oppfylt:
| Når et av kravene ikke oppfylles på mer enn 2 minutter i løpet av en avgang regnes dette som et brudd. Det tillates inntil 2 brudd på kriteriene pr. avgang. |
PE | Absolutt | Salg av billetter Salg av billetter er viktig for å gi inntektssikring for Tjenestemottaker | RuterSalg-diagnosemodulen om bord i kjøretøy/fartøy måler hvert minutt under en avgang at følgende krav er oppfylt:
| Hvis det er registrert feil på et av kravene, eller det ikke er publisert melding det minuttet, regnes det som et avvik. 3 avvik på rad regnes som utilgjengelig tjeneste 3 tilfeller av utilgjengelig tjeneste i løpet av en avgang regnes som SLA-brudd |
PE | - | Validering/aktivering av reiserett * Validering av reisrett bidrar til Tjenestemottakers inntektssikring *: Dette dataemnet vil få ytelsesnivåkrav lik “Normal” fra neste hovedversjon av Avtale om Digitale Tjenester | Kortleser rapporterer hvert minutt diagnostikkdata gjennom MQTT | Når en eller flere kortlesere ikke rapporterer tilgjengelighet gjennom en hel avgang.
|
- | Eksternt skilt Fremvisning av korrekt informasjon til passasjerene om bord er viktig for Tjenestemottaker | Ekstern skilt-melding sendes umiddelbart når eksterne skilt endres uavhengig om det er grunnet fjernstyring eller manuell overstyring. | Kravet inngår ikke i ytelseskrav for incentiv ordninger men er omfattet av generelt krav til bruk av API. | |
PE | Absolutt | Oppdragsutveksling Konsentra Førerapp | Fører benytter førerapplikasjon i henhold til avtalt prosedyre. | Hvis et eller flere kriterier ikke er oppfylt. |
PE | Absolutt | Oppdragsutveksling SUTI Oppdragsbekreftelse gjelder overføring, oppdatering og avslutning av aktuelle oppdrag. | Tjenesteyter må bekrefte mottatt oppdrag gjennom SUTI-Grensesnittet Tjenesteyter melder tilbake tildelt bil (løyve) Kjøretøyet registrerer faktiske hente- og leveringstider, inkludert GPS posisjon. | Hvis et eller flere kriterier ikke er oppfylt. |
PE | Absolutt | Oppdragsrapportering Y2M | Tjenesteyter utveksler data i henhold til grensesnitt beskrevet for funksjonsnivå Y2M | Hvis et eller flere kriterier ikke er oppfylt. |
...