1.1 Formål og dokumenthistorikk

Formål

Eksportere turer med tilleggsinformasjon til operatører
Formåls omfang
Anbudsgrunnlag og drift av anbudskontrakter
Interessenter
Oppdragsgivere (som Ruter og Skyss)
Ruteplansystemer (f.eks. Trapeze, DG Buss, Microbus og HASTUS)

1.2 Format og filnavn

1.2.1 Format

Tidtabellinformasjon er vedlagt i semikolonseparert format. Dette formatet inneholder informasjon om holdeplasser og turer med passeringstider per holdeplass, samt øvrig grunninformasjon.
Det er en fil for hver samletidtabell og filene er inndelt med ”tags” som identifiserer hva slags
informasjon som følger linjen.

1.2.2 Filnavn

Filnavnet er sammensatt av følgende elementer:

• Tilbyder (Selskapsnavn)

• Dagtype

• Scenarionummer

• Beskrivelse av tidtabellen

• Filtype (txt som angir at det er en tekstfil)

1.3 Formatbeskrivelse

Beskrivelsen av formatet og taggene er som følger:

1.3.1 Holdeplass

Holdeplass – tag hpl:

• Holdeplasskode

• Holdeplassbeskrivelse

1.3.2 Tur

Tur – tag tur:

• Turnummer

• Tur linjenummer

• Tur variant

• Tur retning (10 = retning 1, 11 = retning 2)

• Turmønsternummer

• Tur skiltkode

• Tur minimum reguleringstid start

• Tur minimum reguleringstid slutt

• Turnote id

• Turnote id 2

• Tur kjøres mandag (1 = kjøres, 0 = kjøres ikke)

• Tur kjøret tirsdag (1 = kjøres, 0 = kjøres ikke)

• Tur kjøres onsdag (1 = kjøres, 0 = kjøres ikke)

• Tur kjøres torsdag (1 = kjøres, 0 = kjøres ikke)

• Tur kjøres fredag (1 = kjøres, 0 = kjøres ikke)

• Tur kjørs lørdag (1 = kjøres, 0 = kjøres ikke)

• Tur kjøres søndag (1 = kjøres, 0 = kjøres ikke)

• Tur mulig vogngruppe 1

• Tur mulig vogngruppe 2

• Tur mulig vogngruppe 3

1.3.3 Passeringstider

Tur passeringstider – tag hpl_tid:

• Passering tidspunkt (TT:MM)

• Passering holdeplass (holdeplasskode som korresponderer med informasjonen ovenfor)

• Distanse fra foregående holdeplass (distanse i meter med punktum som tusenskilletegn)

• Passeringsnote holdeplass (Note id for holdeplassnote)

Filen organiseres med holdeplassinformasjonen først. Deretter følgjer de respektive turene med respektive passeringstider. Strukturen på filen ser dermed slik ut:

Dette er holdeplass 123456 med beskriving ”Holdeplass 123456”.

Dette er tur 432 på linje 21, retning 1 (skrives som 10 i filen). Turen er tildelt turmønster 28, notekode er "BEST" og notekode 2 er "SKOLE" (notekode er alfanumerisk). Turene kjøres mandag- fredag, ikke lørdag eller søndag. Turene har mulige vogngrupper lb, sb og mb. Tur har minimum reguleringstid start 1 minutt(skrives som 0h01) og minimum reguleringstid slutt 5 minutt(skrives som 0h05)

Turen har avgang fra holdeplass GIV klokken 14:30. Den passerer SDR klokken 14:55 og distansen fra GIV er 19.694, SKE klokken 15:00 og distansen fra SDR er 5.055, HYB klokken 15:20 og distansen fra SKE er 18.124 samt holdeplassnoten er "BEST", og ankommer til slutt STAF klokken 15:22 og distansen fra HYB er 2.366.

2. EKSPORT AV TURMØNSTERINFORMASJON

2.1 Formål og dokumenthistorikk

Formål
Eksportere turmønster med tilleggsinformasjon til operatører
Formåls omfang
Anbudsgrunnlag og drift av anbudskontrakter
Interessenter
Oppdragsgivere (som Ruter og Skyss)
Ruteplansystemer (f.eks. Trapeze, DG Buss, Microbus og HASTUS)

2.2 Format og filnavn

2.2.1 Format

Turmønsterinformasjon er vedlagt i semikolonseparert format. Dette formatet inneholder informasjon om turmønster og de holdeplasser (stoppunkt i sekvensert rekkefølge) som er brukt i turmønsteret, samt øvrig grunninformasjon.

2.2.2 Filnavn

Det er en fil for hvert turmønster.
Filnavnet er sammensatt av følgende elementer:

• Turmønster linje

• Skilletegn "-"

• Turmønster id

• Filtype (txt / xml)

Eksempel på navn er 37-18.txt. Dette er turmønster nummer 18, brukt på linje 37. Filen er txt-fil.

2.3 Formatbeskrivelse

Hver av turmønstrene inneholder følgende informasjon:

• Turmønsternummer

• Turmønsteret sin linje

• Turmønsteret sin retning

• Turmønsterinformasjon om hver holdeplass (stoppunkt)

2.3.1 Eksempel

Dette er turmønster nummer 32, for linje 2 og i retning 1. Turmønster starter med sekvens 1, på stoppnummer 12011466, med stoppnavn Birkelundstoppen snuplass, UTM 32 X-koordinat er 29937.3, UTM 32 Y-koordinat er 669540.0 og distansen fra forrige

3 EKSPORT AV VOGNLØP

3.1 Formål og dokumenthistorikk

Formål
Importere vognløp med tur- og tilleggsinformasjon fra operatører
Formåls omfang
Anbudsgrunnlag og drift av transport tjenester.
Interessenter
Oppdragsgivere (som Ruter og Skyss)
Ruteplansystemer (f.eks. Trapeze, DG Buss, Microbus og HASTUS)

3.2 Format og filnavn

For at oppdragsgivere skal kunne importere vognløp sendt fra operatør, er her beskrevet krav til hvordan operatør skal eksportere vognløp.

3.2.1 Format

Eksport skal være i semikolonseparert format.

3.2.2 Filnavn

Filnavnet skal inneholde informasjon som gir relevante opplysninger om linje- / områdenavn og vognløpstype (hverdag, lørdag, søndag eller andre dagtyper).

3.3 Dataelementer og eksempler

Filen skal inneholde dataelementer for holdeplasser i bruk, blokknummer med detaljinfo samt detaljinformasjon for hver av turene i blokk. Denne informasjon, med id og navn, er den samme som den som importeres fra oppdragsgivers eksport av turer, og skal ikke endres.

3.3.1 Eksempel

Eksempel på data er gjengitt under her, med forklaringer. (Holdeplassnummer, -navn og andre opplysninger er fiktive) Til slutt finnes komplett eksempel på eksport av et vognløp for en søndag (blokk nummer 5050).

3.3.2 Holdeplass

Eksempel med forklaring:

Øverst i fil eksporteres alle holdeplasser som er i bruk i aktuell tabell det eksporteres fra. Hver holdeplass eksporteres til en linje og skal inneholde opplysninger om:
[tag];[holdeplassId];[holdeplassNavn] Tag er fast definert til place

3.3.3 Blokk

block; 5050;LGLE; 998150
Etter holdeplasser eksporteres informasjon om blokk:

[tag];[blokkNummer];[blokkVogngruppe];[blokkInternNummer] Tag er fast definert til block

3.3.4 Tur

trip;100;2356485;0;697;12;11;1;1;1;1;1;0;0;2D2E;;
For hver tur i blokk eksporteres detaljinformasjon om tur:
[tag];[turNummer];[blokkInternNummer];[turType];[turLinje];[turVariant];[turRetning];[turKjøresMa ndag];[turKjøresTirsdag];[turKjøresOnsdag];[turKjøresTorsdag];[turKjøresFredag];[turKjøresLørdag]; [turKjøresSøndag];[turVogngruppe1];[ turVogngruppe2];[ turVogngruppe3]
Tag er fast definert til trip

3.3.5 Holdeplasspassering

For hver holdeplass i tur eksporteres detaljinformasjon om holdeplasspassering:

[tag];[holdeplassPasseringstid];[ holdeplassId];[distanseFraForrigeHoldeplass]

3.3.6 Eksempel på eksport