LIITE 2.7. Integraatio-ohje. TVV LMJ Liikennöintitietojen Hallinta

LIITE 2.7 Integraatio-ohje TVV LMJ Liikennöintitietojen Hallinta Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 1(37)

MUUTOSHISTORIA Versio Päivämäärä Tekijä Muutokset 0.1 24.10.2013 Pekka Kaarela/MTS Ensimmäinen versio 0.2 30.10.2013 Pekka Kaarela/MTS Täsmennetty palaverin 29.10.2013 perusteella käyttöoikeuksien kannalta sekä pysäkkitietojen siirron kannalta. 0.3 05.11.2013 Pekka Kaarela/MTS calendar_dates.txt täsmennetty 0.4 06.11.2013 Pekka Kaarela/MTS Täsmennyksiä integraatioiden yleiseen toimintatapaan. Täsmennetty ylikirjoitussääntöjä. Pysäkille lisätty URL-tieto. 0.5 12.11.2013 Pekka Kaarela/MTS Lisätty käyttöoikeusmatriisi lukuun 2.2. Täsmennetty validointivaatimusta lukuun 2.4. Lisätty lukuun 5.1 tietoa voimaanastumisesta ja nostettu aikataulukausien määrä viiteen. Lisätty lukuun 5.3 ajastustarve. Täsmennetty eri rajapintojen käyttötarkoitusta. URL:eihin päivietty integraation osoituksia. 0.6 26.11.2013 Pekka Kaarela Täsmennyksiä. Lisätty sääntö, että aineiston haku on mahdollinen vain, jos vyöhyketieto on olemassa kaikilla pysäkeillä. 1.0 24.01.2014 Pekka Kaarela Asiakkaan hyväksyntä 1.1 25.01.2014 Pekka Kaarela Täsmennyksiä luvun 3 alkuun: esimerkiksi tietojen säilyttämiseen liittyen. Poistettu rajoite voimassaololtaan päällekkäisistä kalentereista. Block_id lisätty järjestelmään. 1.2 25.02.2014 Pekka Kaarela agency_id lisätty järjestelmään routes.txt tiedostoon. 1.3 05.03.2014 Pekka Kaarela Täsmennys agency.txt:n käsittelyyn lukuun 5.1 1.4 30.03.2014 Pekka Kaarela Luvussa 3.2.2 mainittu automaattinen vyöhykkeen asettaminen vyöhykkeeksi 1 tilanteessa, jossa vyöhykettä ei anneta, on poistettu. Poistettu luvusta 5.3 rajoite, jonka mukaan liikennöintitietoja ei voi hakea, jos jollain pysäkillä ei ole vyöhykettä. Lukuun 5.1.1 täsmennetty vyöhyketiedon siirtoa. Täsmennetty virheenhallintaa ja poistamisasiaa luvun 5 alkuun sekä lukuun 5.1.1. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 2(37)

Täsmennetty tietojen säilyttämistä lukuun 5.1.3 Täsmennetty lukua 5.1.4 1.5 10.04.2014 Pekka Kaarela Kuva 1 päivitetty. lines.txt muutettu routes.txt 1.6 21.05.2014 Pekka Kaarela Rajapintojen URL:ja täsmennetty. Lukuun 2.4 lisätty täsmennys tunnisteisiin. Luku 4 täydennetty. Tarkennettu, että tunnisteet ovat palveluntuottajarekisterissä. 1.7 23.05.2014 Pekka Kaarela Lyhytnimitunnisteiden sijasta käytetään numeromuotoisia tunnisteita. Luku Varikkojärjestelmärajapinta poistettu. 1.8 26.06.2014 Pekka Kaarela Sopimustyyppien numeroarvot muutettu. 1.9 18.08.2014 Pekka Kaarela Sopimustyyppi lisätty. 1.10 06.11.2014 Pekka Kaarela Muunnettu.doc muotoon 1.11 07.11.2014 Anne Seppälä Siirretty LMJ-pohjalle 1.12 18.03.2015 Pekka Kaarela Siirtotiedostojen kenttien tietoja täsmennetty muutospyynnön Liikenteenhallintaohjeiden päivittäminen 17.03.2015 mukaisesti. 1.13 23.03.2015 Pekka Kaarela Kenttien tietoja päivitetty numeerisiksi muutospyynnön 23.03.2015 päivityksen mukaisesti. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 3(37)

SISÄLLYSLUETTELO Muutoshistoria... 2 1 Johdanto... 7 1.1 Asiakirjan tarkoitus... 7 1.2 Termit ja lyhenteet... 7 1.3 Viitteet... 7 2 Järjestelmän yleiskuvaus... 8 2.1 Tarkoitus ja toiminta... 8 2.2 Käyttäjäryhmät ja käyttöoikeudet... 8 2.3 Käyttöoikeuksien hallinta... 8 2.4 Käyttöympäristövaatimukset... 9 3 Integraatioiden yleiset toimintaperiaatteet... 10 3.1 Poikkeamat GTFS-standardista... 10 3.1.1 Pysäkkien ja linjojen nimien lokalisointi... 10 3.1.2 TVV:n ja liikennöitsijän sopimustieto... 10 3.2 Täsmennykset GTFS-formaattiin... 11 3.2.1 Tiedoston nimeäminen... 11 3.2.2 Tiedostojen ja kenttien täsmennykset... 11 4 Tunnistautuminen... 14 5 Suunnittelujärjestelmärajapinta... 15 5.1 Liikennöintitietojen tuonti... 15 5.1.1 Pysäkkitietojen siirto... 16 5.1.2 Perustietojen siirto... 17 5.1.3 Koko aikatauluaineiston siirto... 17 5.1.4 Linjakohtainen lähtöjen siirto... 18 5.2 Liikennöintitietojen poistaminen... 19 5.3 Liikennöintitietojen haku... 19 6 Feed-julkaisurajapinta... 20 Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 4(37)

Muutoshistoria... 2 1 Johdanto... 7 1.1 Asiakirjan tarkoitus... 7 1.2 Termit ja lyhenteet... 7 1.3 Viitteet... 7 2 Järjestelmän yleiskuvaus... 8 2.1 Tarkoitus ja toiminta... 8 2.2 Käyttäjäryhmät ja käyttöoikeudet... 8 2.3 Käyttöoikeuksien hallinta... 8 2.4 Käyttöympäristövaatimukset... 9 3 Integraatioiden yleiset toimintaperiaatteet... 10 3.1 Poikkeamat GTFS-standardista... 10 3.1.1 Pysäkkien ja linjojen nimien lokalisointi... 10 3.1.2 TVV:n ja liikennöitsijän sopimustieto... 10 3.2 Täsmennykset GTFS-formaattiin... 11 3.2.1 Tiedoston nimeäminen... 11 3.2.2 Tiedostojen ja kenttien täsmennykset... 11 4 Tunnistautuminen... 14 5 Suunnittelujärjestelmärajapinta... 15 5.1 Liikennöintitietojen tuonti... 15 5.1.1 Pysäkkitietojen siirto... 16 5.1.2 Perustietojen siirto... 17 5.1.3 Koko aikatauluaineiston siirto... 17 5.1.4 Linjakohtainen lähtöjen siirto... 18 5.2 Liikennöintitietojen poistaminen... 19 5.3 Liikennöintitietojen haku... 19 6 Feed-julkaisurajapinta... 20 1 Järjestelmän yleiskuvaus... 23 1 Järjestelmän tarkoitus... 23 2 Järjestelmän käyttäjäroolit... 23 2 Järjestelmän toiminnallisuus... 23 1 Käyttäjäroolien yhteinen toiminnallisuus... 23 Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 5(37)

2 TVV:n joukkoliikenteen suunnittelijan toiminnallisuus... 24 1 Asetusten hallinta... 24 2 Pysäkkien hallinta... 25 3 Linjojen hallinta... 27 4 Reittien hallinta... 29 5 Lähtöjen hallinta... 31 6 Kalenterien hallinta... 33 3 Liikennöitsijän omien linjojen suunnittelijan toiminnallisuus... 36 1 Tietojen katselu... 36 2 Tietojen muokkaus... 36 3 Reittien hallinta... 36 4 Lähtöjen hallinta... 36 3 Järjestelmän virheilmoitukset... 36 4 Muutoshistoria... 37 Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 6(37)

1 JOHDANTO 1.1 Asiakirjan tarkoitus Tämä dokumentti on integroitumisohje järjestelmälle, jossa hallinnoidaan toimivaltaisten viranomaisten joukkoliikenteen aikatauluaineistoja. 1.2 Termit ja lyhenteet Tässä dokumentissa käytetään seuraavia erikoiskäsitteitä, termejä ja lyhenteitä: Termi Selitys GTFS General Transit Feed Specification. Tietomalli ja formaatti aikatauluaineiston siirtämiseksi järjestelmien välillä. [GTFS] Liikennöitsijä Syöte TVV Agency. Yhtä tai usempaa linjaa operoiva organisaatio. Feed. GTFS-tiedot sisältävä zip-paketti. Toimivaltainen viranomainen. TVV päättää omalla viranomaisalueellaan mm. joukkoliikenteen palvelutasosta, järjestämistavasta sekä lippu- ja tariffijärjestelmästä. 1.3 Viitteet Viite GTFS GTFS_REFERENCE Dokumentti https://developers.google.com/transit/overview https://developers.google.com/transit/gtfs/reference Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 7(37)

2 JÄRJESTELMÄN YLEISKUVAUS 2.1 Tarkoitus ja toiminta Liikennöintitietojen hallintajärjestelmä hallitsee usean TVV:n joukkoliikenteen liikennöintitietoja ja välittää näitä tietoja eri järjestelmien välillä. Järjestelmiä voivat olla esimerkiksi TVV:n tai liikennöitsijän liikenteen suunnittelujärjestelmä, liikennöitsijän varikkojärjestelmä tai kolmannen osapuolen matkustajainformaatiojärjestelmä. Järjestelmä mahdollistaa aikataulun suunnittelun järjestelmän käyttöliittymässä ja tietojen tuomisen järjestelmään integraation kautta. Integraatioiden kautta tuodaan tiedot järjestelmään GTFS-formaatissa. Järjestelmän palvelimet ovat osa TVV LMJ-palvelinarkkitehtuuria. 2.2 Käyttäjäryhmät ja käyttöoikeudet Taulukossa on esitelty ne käyttäjäryhmät, joilla on oikeus integroitua järjestelmään. Järjestelmää käytetään myös käyttöliittymän kautta ja nämä oikeudet on esitelty erillisessä käyttöohjeessa. Käyttäjäry hmä Oikeudet / Rajapinta Pysäkkitietojen siirto Perustietojen siirto Koko aikatauluai neiston siirto Linjakohtai nen lähtöjen siirto Liikennöintitietojen poistaminen Liikennöintitietojen haku Feed-julkaisurajapinta TVV:n joukkoliike nteen suunnittelij a Oikeus (oma alue) Oikeus (oma alue) Oikeus (oma alue) Oikeus omien linjojen osalta Oikeus (oma alue) Oikeus (oma alue) Oikeus Liikennöits ijän omien linjojen suunnittelij a Ei oikeutta Ei oikeutta Ei oikeutta Oikeus omien linjojen osalta Ei oikeutta Oikeus Oikeus Kolmas osapuoli Ei oikeutta Ei oikeutta Ei oikeutta Ei oikeutta Ei oikeutta Ei oikeutta Oikeus 2.3 Käyttöoikeuksien hallinta Käyttöoikeuksia hallitaan TVV LMJ -järjestelmän yhteisessä käyttöoikeuksien hallintajärjestelmässä. Käyttäjälle asetetaan organisaatio, organisaation tyyppi ja rooli. Näiden sekä liikennöintitietojen hallintajärjestelmässä erikseen annettujen lisäoikeuksien perusteella järjestelmän käyttöoikeuden omaavat käyttäjät tai järjestelmät voivat katsella ja muokata järjestelmän tietoja. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 8(37)

TVV voi merkitä integraatiossa tai järjestelmän käyttöliittymässä haluamiensa linjojen osalta liikennöitsijälle oikeuden muokata linjojen reittejä ja lähtöjä. Tällöin liikennöitsijälle mahdollistuu linjakohtainen lähtöjen siirto. 2.4 Käyttöympäristövaatimukset Järjestelmän rajapinnat on toteutettu RESTful-periaatteiden mukaisesti. Rajapinnan käyttö tulee toteuttaa palvelinten välisellä integraatiolla. Järjestelmään lähetettävä GTFS feed on validoitava ennen käyttöä Googlen validointityökaluin (https://developers.google.com/transit/tools#gtfsvalidation). On huomattavaa, että järjestelmä hyväksyy myös zip-tiedostoja, joista puuttuu GTFS:n pakollisia tiedostoja. Integroijan on tunnistettava nämä virheet sellaisiksi, että ne eivät ole este integraatiolle tietyissä tapauksissa, esimerkiksi pysäkkitietojen siirrossa. Rajapinnoissa käytetyt TVV- ja liikennöitsijätunnisteet ovat tunnisteita palveluntuottajarekisterissä. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 9(37)

3 INTEGRAATIOIDEN YLEISET TOIMINTAPERIAATTEET Järjestelmä hallitsee tietoja GTFS-tietomallin puitteissa. Tiettyjen tietojen osalta GTFS-määritystä on jouduttu laajentamaan, jotta tieto voidaan välittää sekä järjestelmään että järjestelmästä pois päin. Järjestelmässä hallitaan liikennöintitietoja TVV-kohtaisesti. Esimerkiksi järjestelmästä voi hakea tietoja vain yhden TVV:n tiedot kerralla. Järjestelmä tukee tietojen syöttämistä sekä manuaalisesti käyttöliittymästä että integraation avulla järjestelmien välisen liittymän kautta. o Integraatiolla järjestelmään tuodut tiedot ylikirjoittavat järjestelmässä kaiken jo mahdollisesti olevan tiedon käyttöoikeuksien rajoissa säästäen tietyt GTFS:n valinnaiset tiedot. Myös sellaiset tiedot, joita integraatiossa ei tule, poistetaan järjestelmästä. Näin ollen järjestelmään ei ole suotavaa tuoda pelkästään esimerkiksi tulevaisuuden aikataulukautta, mikäli nykyisen aikataulukauden tulee säilyä järjestelmässä. o Tiettyjen GTFS:ssä olevien valinnaisten tietojen osalta integraatio ei ylikirjoita käyttöliittymästä annettua tietoa, mikäli integraatiossa ei kyseistä täydentävää tietoa tule järjestelmässä olemassa olevalle elementille. Näitä ovat pysäkin matkustajatunniste, pysäkin vyöhykkeen tunniste, pysäkin URL ja sopimustieto. Edellytyksenä tälle on se, että tunnisteet pysyvät integraatiosta toiseen samana. Jos valinnaisen tiedon tunniste ei esiinny tiedoston otsikkorivillä, kyseinen tieto säilytetään järjestelmässä. 3.1 Poikkeamat GTFS-standardista 3.1.1 Pysäkkien ja linjojen nimien lokalisointi Syötteen kieli on suomi fi ja järjestelmä vaatii jokaiselle tiedolle vähintään suomen kielisen tekstin. Käyttäjä voi määritellä ruotsinkielisen kieliversion pysäkin ja linjan nimelle. Nämä tiedot välitetään GTFS:n translations.txt-tiedostossa kielikoodilla sv. translations.txt-tiedoston käyttö on epävirallinen laajennus GTFS-standardiin ja se on kuvattu dokumentissa https://support.google.com/transitpartners/answer/2450962 3.1.2 TVV:n ja liikennöitsijän sopimustieto Rajapinnassa välitetään sopimustieto erillisessä tiedostossa contracts.txt. Tiedostoformaatti on vastaava kuin GTFS:n muissa txt-tiedostoissa. Yksi rivi on yksi contract, ja rivin sisällä kentät on pilkulla erotettu. Ensimmäisen rivin pitää sisältää sarakkeiden otsikot pilkuilla erotettuna. Jokaista linjaa (GTFS:n route) kohden täytyy olla yksi sopimusrivi. Tiedoston pakollisuus: Valinnainen Kentän nimi Pakollisuus Yksityiskohdat Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 10(37)

Kentän nimi Pakollisuus Yksityiskohdat contract_id Pakollinen Sopimukseen liittyvä numeerinen tunnistetieto, jolla voidaan esimerkiksi viitata johonkin toisessa järjestelmässä olevaan sopimukseen. (Tapahtumankäsittelyn ContractID) contract_type Pakollinen contract_type kuvaa TVV:n ja liikennöitsijän sopiman liikenteen järjestämistavan tietyn linjan osalta. Käytettävät arvot ovat: 1 Käyttöoikeussopimusmalli 4 Siirtymäajan liikenne 6 Bruttomalli 10 Markkinaehtoinen liikenne Arvoja voi tulla jatkossa lisää. update_permission Pakollinen update_permission-kentällä annetaan oikeus liikennöitsijälle päivittää tähän sopimukseen liittyvän linjan aikataulutietoja Käytettävät arvot ovat: 0 Ei-oikeutta 1 Päivitysoikeus route_id Pakollinen Linjan id, johon tämä sopimus liittyy. Yhteen linja_id:hen voi liittyä vain yksi sopimus. 3.2 Täsmennykset GTFS-formaattiin 3.2.1 Tiedoston nimeäminen Tiedosto on nimettävä muodossa <TVV:n organisaatiotunniste>.zip esimerkiksi 245.zip. Numero 245 on Tampereen tunniste palveluntuottajarekisterissä. TVV:n organisaatiotunniste on siis se organisaatiotunniste, joka TVV:lle on annettu palveluntuottajarekisteriin. 3.2.2 Tiedostojen ja kenttien täsmennykset Järjestelmä hyödyntää GTFS-formaatista vain pakollisia tiedostoja ja kenttiä taulukossa (Taulukko 1) mainituin täsmennyksin. Taulukko 1. Kenttien täsmennykset Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 11(37)

Tiedosto Kenttä Selite agency.txt agency_id Kenttään tulee laittaa liikennöitsijän se yksilöllinen organisaatiotunniste, joka liikennöitsijälle on annettu palveluntuottajarekisteriin. stops.txt stop_id Kenttään tulee laittaa pysäkin selväkielinen yksilöllinen tunniste esimerkiksi 504. Samalla pysäkillä tulee olla sama tunniste jokaisessa uudessa datan latauksessa. Kentän arvon tulee olla numero. (Tapahtumankäsittelyn StopID) stop_code Valinnainen kenttä, joka luetaan järjestelmään. zone_id stop_url Kentän käyttö on suositeltavaa, jotta matkustajille voidaan näyttää järkevä pysäkin koodi, mikäli stop_id:ssä käytetään lisätunnistetta esimerkiksi tampere_0502. Valinnainen kenttä, joka luetaan järjestelmään. Mikäli kenttä on annettu, tulee kenttään laittaa numero arvoalueella 1-10. Valinnainen kenttä, joka luetaan järjestelmään. Tähän kenttään voi laittaa esimerkiksi Digiroad-järjestelmässä olevan pysäkin valtakunnallisen tunnisteen. URL:n tulee alkaa http:// tai https:// ja mahdolliset erikoismerkit tulee olla oikein käsitelty (ks: http://www.w3.org/addressing/url/4_uri_recommentations.html). routes.txt agency_id Pakollinen tieto. Kentän perusteella voidaan määritellä, mikä liikennöitsijä linjaa ajaa. route_short_name GTFS:n mukaan valinnainen kenttä, joka luetaan järjestelmään. Pakollinen tieto. Kentässä tulee olla linja ja mahdollinen tarkenne muodossa 101_A (erotinmerkkinä alaviiva). Ajoneuvolaitteiden toimittaja purkaa ko. kentän tiedon tapahtumankäsittelyyn linjaan (lineid) 101 ja tarkenteeseen (route) A. Alkuosan arvon eli linjan tulee olla numero. (Tapahtumankäsittelyn LineID) trips.txt direction_id Pakollinen tieto. Kentän käyttö on erittäin suositeltavaa, jotta lähdöt voidaan erotella järjestelmässä suunnittain. Kentässä tulee olla numero 0 tai 1. Mikäli kenttää ei ole annettu, järjestelmä asettaa kaikkien lähtöjen suunnaksi 1. block_id GTFS:n mukaan valinnainen kenttä, joka luetaan järjestelmään. Waltti-järjestelmän näkökulmasta tämä tieto on kuitenkin pakollinen. Valinnainen kenttä, joka luetaan järjestelmään. Kentän arvon tulee olla numero. (Tapahtumankäsittelyn BusrouteID) Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 12(37)

calendar_dates.txt Kenttää käytetään autokierron tunnisteena. Mikäli aikataulusuunnitelma sisältää erikoispäiviä, tulee käyttää GTFS:n calendar_dates.txttiedostoa GTFS-dokumentaatiossa [GTFS_REFERENCE] määritellyn recommended -mallin mukaisesti. Tiedosto voi sisältää palveluaikoja, joita ei ajeta yhtenäkään viikonpäivänä (päivätyyppinä), mutta joille on tehty päivävaihtoja. Tällaisella järjestelyllä on luotu erikoispäivä, joka ajetaan vain tiettyinä kalenteripäivinä. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 13(37)

4 TUNNISTAUTUMINEN Rajapintojen käyttöön tarvittavat tunnukset ja IP-osoitteet ovat pyydettävissä TVV LMJ -organisaatiolta. Järjestelmän pääkäyttäjä luo rajapintaa käyttävälle järjestelmälle oman teknisen tunnuksen, jonka tiedot toimitetaan tekniselle yhteyshenkilölle sähköpostilla. Tietoturvasyistä tunnus ja salasana toimitetaan erillisissä sähköposteissa. Mikäli tunnukseen liittyen on ongelmia tai salasanaa on tarve vaihtaa, tekee järjestelmän pääkäyttäjä tarvittavat toimenpiteet. Teknistä tunnusta ei saa käyttää mihinkään muuhun tarkoitukseen kuin rajapinnan autentikointiin. Yhteyden autentikointi tapahtuu SAML ECP-profiililla. Katso tarkemmat ohjeet mekanismin toteuttamisesta dokumentista Piletti Web Services Authentication For Third Parties.docx Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 14(37)

5 SUUNNITTELUJÄRJESTELMÄRAJAPINTA Suunnittelujärjestelmärajapinnan kautta järjestelmässä voi hallita kaikkia liikennöintiin liittyviä tietoja käyttöoikeuksien puitteissa. Järjestelmään voi tuoda tietoja seuraavilla tavoilla: Täydellisiä aikatauluaineistoja tässä dokumentissa määritellyin laajennuksin Perustiedot, sisältäen liikennöitsijätiedot, sopimukset, pysäkit, linjat ja kalenterin Yksittäisten linjojen aikatauluja Pysäkkien tietoja Mikäli integraation yhteydessä tapahtuu virhe, järjestelmä palauttaa tiedot integraatiota edeltäneeseen tilanteeseen. Järjestelmästä voi poistaa yksittäisiä aikataulukausia. Järjestelmästä voi hakea aikatauluaineistoja sisältäen dokumentissa määritellyt laajennukset. Esitellyissä osoitteissa kohtaan {authority} laitetaan palveluntuottajarekisterissä oleva TVV:n tunniste. Esimerkiksi Tampereen tunniste on 245. 5.1 Liikennöintitietojen tuonti Huomioitavia seikkoja Tiedostojen tulee täyttää vaatimukset, jotka on listattu GTFS-määrittelyn [GTFS_REFERENCE] kohdassa File Requirements Järjestelmään voi tuoda vain täydellisiä aineistoja sisältäen perustiedot. Näin viite-eheydet ovat oikein tietoja siirrettäessä. Järjestelmä siirtää datasta järjestelmään vain ne osat, joihin käyttäjällä on oikeus. Jotta linjakohtainen siirto on mahdollista, pitää perustietojen id:t (agency_id, stop_id, route_id, service_id) pitää samoina aikatauluaineiston siirrosta toiseen. Vain näin voi toinen osapuoli hakea perustiedot ja rikastaa ne aikataulutiedolla omassa järjestelmässään Järjestelmä käyttää agency.txt-tiedostosta vain id-tietoa. Järjestelmään ei siis siirretä agency.txttiedoston sisältämiä tietoja, vaan järjestelmä ylläpitää liikennöitsijöiden tietoja erillisellä integraatiolla palveluntuottajien hallintajärjestelmästä. Järjestelmään tulee siirtää aina kaikki tiedot, joihin käyttäjällä on oikeus, sillä järjestelmässä olevat tiedot korvataan uudella aineistolla. Esimerkiksi jos käyttäjällä on oikeus tuoda järjestelmään linjojen A ja B aikatauluaineisto, täytyy molemmat aikatauluaineistot tuoda kerralla järjestelmään. o Perustietoja voi täydentää siirtämällä vain ne järjestelmään. Tällöinkin korvataan järjestelmässä jo olevat perustiedot huomioiden kohdassa 3 Integraatioiden yleiset toimintaperiaatteet mainitut seikat. Kun järjestelmään siirretään perustietoja tai lähtöjä, jotka ovat voimassa, nämä ovat välittömästi integraation päättymisen jälkeen muiden järjestelmien hyödynnettävissä. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 15(37)

Aineisto lähetetään POST-metodilla content-typen ollessa multipart/form-data Järjestelmässä voi säilyttää vain viiden aikataulukauden aineistoa, esimerkiksi o kaksi aikatauluaineistoa, joiden voimassaoloaika on päättynyt o nykyinen aikataulukausi o kaksi seuraavaa aikataulukautta TVV:n Liikennöintitiedot Lähdöt Koko aikatauluaineiston siirto stops.txt routes.txt contracts.txt agency.txt calendar.txt calendar_dates.txt trips.txt stop_times.txt translations.txt Perustietojen siirto stops.txt routes.txt contracts.txt agency.txt calendar.txt calendar_dates.txt translations.txt Kalenteri Linjat - sopimukset Liikennöitsijät Pysäkit Pysäkkitietojen siirto stops.txt translations.txt Linjakohtainen lähtöjen siirto stops.txt routes.txt contracts.txt agency.txt calendar.txt calendar_dates.txt trips.txt stop_times.txt Kuva 1 Erilaiset tavat tuoda järjestelmään tietoja. Kuvassa Kuva 1 esitellään erilaiset tavat tuoda järjestelmään tietoja. Vahvennetulla tekstillä merkityt tiedostot siirretään järjestelmään. 5.1.1 Pysäkkitietojen siirto Mikäli käyttäjällä on oikeus pysäkkien muokkauksessa järjestelmään, järjestelmä toimii seuraavasti: Rajapinta on tarkoitettu toimivaltaisen viranomaisen käyttöön pysäkkitietojen siirtoa varten, jotta tämän jälkeen liikenne voidaan suunnitella tuotujen pysäkkitietojen pohjalta järjestelmän käyttöliittymässä. Rajapinnalla voidaan myös ylläpitää pysäkkitietoja, mikäli esimerkiksi pysäkkien koordinaatteja ylläpidetään pääasiallisesti toisessa järjestelmässä. Ensimmäistä kertaa tietoja siirrettäessä järjestelmä siirtää kaikki pysäkkien tiedot järjestelmään. Mikäli seuraavissa integraatioissa vyöhyketieto ei ole integraatiossa mukana, järjestelmässä olevien pysäkkien tiedot päivitetään muilta kuin vyöhyketiedon osalta. Näin käyttäjä voi ylläpitää vyöhyketietoa järjestelmän käyttöliittymässä edellyttäen, että käyttäjä ei muuta pysäkin tunnistetta integraatioiden välillä. Vyöhyketiedon poisjättäminen tarkoittaa sitä, että tiedostosta tulee jättää kokonaan zone_id-otsikko pois tiedoston otsikkoriviltä. Ne pysäkit, joita integraatiossa ei ole mukana, poistetaan järjestelmästä tai annetaan virheilmoitus, jos poistaminen ei ole mahdollista. Poistaminen ei ole esimerkiksi mahdollista, jos jokin reitti käyttää puuttuvaa pysäkkiä. Pysäkkitietojen siirrossa muut perustiedot ja aikatauluaineistotiedot pysyvät ennallaan. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 16(37)

URL: POST http(s)://{ip-address}:{port}/tdm-service/rest/data/authorities/{authority}/stops Huomioitavia seikkoja järjestelmä hyväksyy pelkän pysäkkitietojen päivityksen Siirrossa siirretään järjestelmään seuraavat tiedostot: stops.txt translations.txt valinnainen 5.1.2 Perustietojen siirto URL: POST http(s)://{ip-address}:{port}/tdm-service/rest/data/authorities/{authority}/basedata Huomioitavia seikkoja Rajapinta on tarkoitettu toimivaltaisen viranomaisen käyttöön liikennöinnin perustietojen siirtoa varten, jotta liikennöitsijät voivat tämän jälkeen tuoda oman liikenteen suunnitelman järjestelmään. Integraatio säilyttää järjestelmässä mahdollisesti jo olevat lähdöt. Mikäli kannassa on jo olemassa aikatauluaineistoa, tulee siirrettävien tiedostojen viite-eheys olla voimassa kannassa olevien tietojen kanssa. Toisin sanoen samoille pysäkeille, linjoille ja kalentereille tulee ylläpitää samoja id-tietoja (stop_id, route_id, agency_id ja service_id). Järjestelmässä jo olevat perustiedot korvataan huomioiden kohdassa 3 Integraatioiden yleiset toimintaperiaatteet mainitut seikat. Järjestelmästä poistetaan ne tiedot, joihin ei ole viittauksia integraatiossa olevissa tiedoissa tai annetaan virheilmoitus, jos poistaminen ei ole mahdollista. Perustietojen siirrossa siirretään järjestelmään vain seuraavat tiedostot: agency.txt stops.txt routes.txt calendar.txt calendar_dates.txt valinnainen, mikäli ei ole määritelty poikkeuksia kalenteriin translations.txt valinnainen contracts.txt valinnainen Järjestelmä hyväksyy siis zip:n, josta puuttuvat trips.txt ja stop_times.txt -tiedostot. 5.1.3 Koko aikatauluaineiston siirto URL: POST http(s)://{ip-address}:{port}/tdm-service/rest/data/authorities/{authority} Huomioitavia seikkoja Rajapinta on tarkoitettu toimivaltaisen viranomaisen käyttöön koko aikatauluaineiston siirtoa varten järjestelmään. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 17(37)

Järjestelmästä poistetaan ne TVV:n hallinnoimat olemassa olevat tiedot, joihin ei ole viittauksia integraatiossa olevissa tiedoissa. Kaikkien tarvittavien aikataulukausien tulee siis olla siirrossa mukana. Rajapinta säilyttää liikennöitsijän syöttämät reitit ja lähdöt. Toisaalta rajapinta palauttaa virheilmoituksen, mikäli syötteestä puuttuu tietoja, joihin liikennöitsijöiden määrittelemät reitit ja lähdöt viittaavat. Järjestelmässä jo olevat perustiedot korvataan huomioiden kohdassa 3 Integraatioiden yleiset toimintaperiaatteet mainitut seikat. Siirrossa siirretään järjestelmään seuraavat tiedostot: agency.txt stops.txt routes.txt trips.txt stop_times.txt calendar.txt calendar_dates.txt valinnainen, mikäli ei ole määritelty poikkeuksia kalenteriin translations.txt valinnainen contracts.txt valinnainen 5.1.4 Linjakohtainen lähtöjen siirto URL: POST http(s)://{ip-address}:{port}/tdm-service/rest/data/authorities/{authority}/trips Huomioitavia seikkoja Rajapinta on suunniteltu liikennöitsijän käyttöön, jotta liikennöitsijä voi tuoda järjestelmään vain oman liikenteensä. Jotta rajapinnan kautta voi välittää tietoja, on toimivaltaisen viranomaisen täytynyt tähän erikseen antaa järjestelmässä oikeus. Rajapinnan avulla myös toimivaltainen viranomainen voi päivittää pelkästään omat lähdöt. Rajapintaa käyttävän järjestelmän on ensin haettava järjestelmästä pysäkit, liikennöitsijät, linjat ja kalenterit (5.3 Liikennöintitietojen haku), joihin lähdöt liitetään. Lähdöt liitetään niihin tunnisteisiin, jotka perustiedoissa tulevat. Järjestelmään tulee siirtää aina kaikki tiedot, joihin käyttäjällä on oikeus, sillä järjestelmässä olevat tiedot korvataan uudella aineistolla. Esimerkiksi jos käyttäjällä on oikeus tuoda järjestelmään linjojen A ja B aikatauluaineisto, täytyy molemmat aikatauluaineistot tuoda kerralla järjestelmään. Mikäli integraatiossa tulee mukana aineistoa, johon käyttäjällä ei ole muokkausoikeutta. Näitä tietoja ei päivitetä järjestelmään. Siirrossa tulee olla mukana seuraavat tiedostot: agency.txt stops.txt Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 18(37)

routes.txt calendar.txt trips.txt (vain tämän tiedoston sisältö integroidaan järjestelmään) stop_times.txt (vain tämän tiedoston sisältö integroidaan järjestelmään) 5.2 Liikennöintitietojen poistaminen Liikennöintitietoja voi poistaa metodilla DELETE: URL: DELETE http(s)://{ip-address}:{port}/tdmservice/rest/data/authorities/{authority}/calendars/{service_id} Komennolla poistetaan kaikki ne lähdöt ja kyseinen kalenteri, jotka viittaavat mainittuun service-id:hen. Tietokannasta ei poisteta liikennöitsijöitä, sopimuksia, pysäkkejä ja linjojen perustietoja. Rajapinta on tarkoitettu toimivaltaisen viranomaisen käyttöön. 5.3 Liikennöintitietojen haku URL: GET http(s)://{ip-address}:{port}/tdm-service/rest/data/authorities/{authority} Komennolla haetaan koko TVV:n aikatauluaineisto sisältäen sopimustiedot. Rajapinta on tarkoitettu toimivaltaisen viranomaisen ja liikennöitsijän käyttöön koko aikatauluaineiston hakua varten. Esimerkiksi varikkojärjestelmät käyttävät tätä rajapintaa. Rajapinnasta tulee pääsääntöisesti hakea tiedot tiettynä kellonaikana yöaikaan. Jokaiselle toimivaltaiselle viranomaiselle ja liikennöitsijälle annetaan ylläpidon toimesta kellonaika, jolloin haku tulee tehdä. Satunnaisesti rajapintaa voi kutsua myös mihin tahansa muuhun aikaan esimerkiksi pikapäivityksen tuotantoon ottoa varten. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 19(37)

6 FEED-JULKAISURAJAPINTA Rajapinta on tarkoitettu sellaisia kolmansien osapuolten järjestelmiä varten, jotka tarvitsevat joukkoliikenteen suunnittelutietoja. FEED-julkaisurajapinta eroaa seuraavasti suunnittelujärjestelmärajapinnasta - rajapinnan kautta on saatavilla järjestelmässä aamuyön eräajossa ennalta muodostettua aineistoa - rajapintaa tulee kolmannen osapuolen kutsua korkeintaan kerran päivässä jokaista TVV-aluetta kohden - rajapinnan kautta on saatavilla koko järjestelmässä oleva suunnitteluaineisto ja sopimustiedot - rajapinta palauttaa vain voimassaolevat ja tulevat aikataulukaudet - rajapinta palauttaa vain niitä aikataulukausia, joille on suunnitteluaineistoa olemassa URL: GET http(s)://{ip-address}:{port}/tdm-service/rest/public/feeds Palauttaa listan järjestelmässä olevista feedeistä. Esimerkiksi: { } "feed":[ {"authority":"245"}, {"authority":"229"} ] URL: GET http(s)://{ip-address}:{port}/tdm-service/rest/public/feeds/{authority} Palauttaa organisaation feedin zipattuna. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 20(37)

Lippu- ja maksujärjestelmä Liikennöintitietojen hallinta Käyttäjän ohje Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 21(37)

Liikennöintitietojen hallinta Sisällysluettelo 1 Järjestelmän yleiskuvaus... 23 1.1 Järjestelmän tarkoitus... 23 1.2 Järjestelmän käyttäjäroolit... 23 2 Järjestelmän toiminnallisuus... 23 2.1 Käyttäjäroolien yhteinen toiminnallisuus... 23 2.2 TVV:n joukkoliikenteen suunnittelijan toiminnallisuus... 24 2.2.1 Asetusten hallinta... 24 2.2.2 Pysäkkien hallinta... 25 2.2.3 Linjojen hallinta... 27 2.2.4 Reittien hallinta... 29 2.2.5 Lähtöjen hallinta... 31 2.2.6 Kalenterien hallinta... 33 2.3 Liikennöitsijän omien linjojen suunnittelijan toiminnallisuus... 36 2.3.1 Tietojen katselu... 36 2.3.2 Tietojen muokkaus... 36 2.3.3 Reittien hallinta... 36 2.3.4 Lähtöjen hallinta... 36 3 Järjestelmän virheilmoitukset... 36 4 Muutoshistoria... 37 Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 22(37)

Liikennöintitietojen hallinta - Käyttäjän ohje 1 Järjestelmän yleiskuvaus 1 Järjestelmän tarkoitus Tämä järjestelmä on liikennöintitietojen hallintajärjestelmä. Järjestelmä hallitsee usean TVV:n joukkoliikenteen liikennöintitietoja ja välittää näitä tietoja eri järjestelmien välillä, joita voivat olla esimerkiksi TVV:n tai liikennöitsijän liikenteen suunnittelujärjestelmä, liikennöitsijän varikkojärjestelmä tai kolmannen osapuolen matkustajainformaatiojärjestelmä. Järjestelmä mahdollistaa aikataulun suunnittelun järjestelmässä ja tietojen tuomisen järjestelmään integraation kautta. Integraatioiden kautta järjestelmään tuodaan tiedot GTFSformaatissa. 2 Järjestelmän käyttäjäroolit Järjestelmää käytetään kahdessa roolissa: 1. TVV:n joukkoliikenteen suunnittelijana, jollaisessa roolissa käyttäjä hallitsee oman alueensa linjojen reitti- ja lähtötietojen osalta niiltä osin kuin ei oikeutta ole siirtänyt liikennöitsijälle. 2. Liikennöitsijän omien linjojen suunnittelijana, jollaisessa roolissa käyttäjä voi katsella kaikkien niiden TVV-alueiden tietoja, joissa liikennöitsijä liikennöi ja muokata tietoja niiden linjojen osalta, joihin TVV on oikeuden erikseen myöntänyt. 2 Järjestelmän toiminnallisuus 1 Käyttäjäroolien yhteinen toiminnallisuus Järjestelmän päänäkymä on karttapohja ja toimintovalinnat, joista pääsee avaamaan järjestelmään liittyvät toiminnot. Myös kartan zoomaukseen liittyvät perustoiminnallisuudet ovat käytettävissä. Järjestelmä näyttää kartalla pysäkit siihen soveltuvalla zoom-tasolla. Pysäkit on värikoodattu pysäkin vyöhykkeen mukaisesti. Perusnäkymän toiminnat ovat: TVV-alueen valinta (käytettävissä vain, mikäli käyttäjällä on oikeuksia usean TVV:n liikennöintitietoihin) Asetukset, josta hallitaan TVV-kohtaisia asetuksia. Liikennöinti, josta hallitaan TVV-kohtaisia liikennöintitietoja. Pysäkkien näyttäminen kartalla Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 23(37)

Kuva 2 Perusnäkymä 2 TVV:n joukkoliikenteen suunnittelijan toiminnallisuus 1 Asetusten hallinta Asetukset-näkymässä hallitaan TVV-kohtaisia järjestelmäparametreja. Huomaa, että kun tariffivyöhykkeiden lukumäärää muutetaan tässä järjestelmässä, tulee muutos tehdä myös tuote- ja tariffijärjestelmään. Järjestelmä varoittaa tästä vyöhyketiedon muutoksen tallennuksen yhteydessä. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 24(37)

Kuva 3 Asetukset-näkymä Kenttä Selite Pakollisuus Tariffivyöhykkeiden lukumäärä TVV:n alueen tariffivyöhykkeiden maksimilukumäärä. Syötteellä rajataan arvoväliä, jota voi käyttää pysäkin vyöhyketietona. Kyllä 2 Pysäkkien hallinta Pysäkit-näkymässä hallitaan järjestelmässä olevia pysäkkejä. Kuva 4 Pysäkit-näkymä Avaa-toiminto osoittaa pysäkin kartalla ja näyttää pysäkin tiedot. Lisää-toiminto avaa näkymän, jossa pysäkin tiedot voidaan antaa. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 25(37)

Poista-toiminto poistaa pysäkin. Käyttöliittymästä ei voi poistaa pysäkkiä, jos kyseisen pysäkin kautta kulkee jokin reitti. Pysäkin sijaintia voi muuttaa tarttumalla pysäkkiin hiiren vasemmalla napilla ja siirtämällä pysäkkiä kartalla. Pysäkin uusi sijainti tallentuu järjestelmään vasta valittaessa Tallenna. Pysäkkikuvake on asetettu kartalle kuvakkeen keskeltä. Kuva 5 Pysäkki-näkymä Kenttä Selite Pakollisuus Vyöhyke Tunniste Matkustajatunniste Pysäkille voi syöttää arvoja yhden ja asetuksissa määritellyn vyöhykkeiden maksimääräksi määritellyn arvoalueen välillä. Vapaamuotoinen pysäkin yksilöllinen tunniste. Kun pysäkki on luotu, tunnistetta ei voi enää muuttaa. Matkustajille osoitettu tunniste, jonka tulisi vastata esimerkiksi kadun varressa olevilla pysäkeillä olevia pysäkkien tunnisteita. Kyllä Kyllä Ei Nimi fi Suomenkielinen pysäkin nimi Kyllä Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 26(37)

Kenttä Selite Pakollisuus Nimi sv Ruotsinkielinen pysäkin nimi Ei Latitude Longitude URL Desimaalimuotoinen koordinaatti. (Desimaalierotin on piste.) Desimaalimuotoinen koordinaatti. (Desimaalierotin on piste.) Pysäkin URL-tieto. URL-tietoa voidaan käyttää esimerkiksi identifioimaan pysäkki valtakunnallisesti. URL:n tulee alkaa http:// tai https:// ja mahdolliset erikoismerkit tulee olla oikein käsitelty (katso http://www.w3.org/addressing/url/4_uri_recommentations. html). Kyllä Kyllä Ei 3 Linjojen hallinta Linjat-näkymässä hallitaan järjestelmässä olevia linjoja. Linja-tieto käsittää linjan tunnistamiseen liittyvien tietojen lisäksi tiedon siitä, kuka liikennöitsijä linjaa ajaa. Kuva 6 Linjat-näkymä Avaa-toiminto avaa näkymän, jossa linjan tietoja voidaan hallita. Riittävät käyttöoikeudet omaava käyttäjä voi avautuvassa käyttöliittymässä muokata tietoja. Hallintanäkymässä voi antaa liikennöitsijälle oikeuden muokata omia reittejään ja lähtöjään (roolille liikennöitsijän omien linjojen suunnittelija). Mikäli muutosoikeus annetaan, kyseisen linjan lähtöjä ei voi enää itse muuttaa. Lisää-toiminto avaa näkymän, jossa linjan tiedot voi antaa. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 27(37)

Poista-toiminto poistaa linjan perustiedot sekä kaikki järjestelmään määritellyt linjan lähdöt. Reittitietoja ei poisteta järjestelmästä linjan poistamisen yhteydessä. Kuva 7 Linja-näkymä Kenttä Selite Pakollisuus Tunniste Liikennöitsijä Liikennöitsijä suunnittelee aikataulun Vapaamuotoinen linjan yksilöllinen tunniste. Kun linja on luotu, tunnistetta ei voi enää muuttaa. Linjaa ajava liikennöitsijä. Sovellus hakee liikennöitsijät Walttijärjestelmälle yhteisestä palveluntuottajarekisteristä. Mikäli tarvittavaa liikennöitsijää ei ole listalla, ota yhteyttä järjestelmän tukeen. Tällä valinnalla voidaan antaa kyseiseen linjaa suunnitteluoikeus liikennöitsijälle. Liikennöitsijä voi tämän jälkeen luoda järjestelmään reittejä ja tälle linjalle lähtöjä. Liikennöitsijä voi tuoda näitä tietoja myös tällöin integraatioilla. Kyllä Kyllä Kyllä Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 28(37)

Kenttä Selite Pakollisuus Sopimus Sopimustunniste, jonka alla linjaa liikennöidään. Kyllä Järjestämistapa Liikenteen järjestämistapa. Kyllä Linjan lyhenne Lyhyt linjan nimi, jota yleensä käytetään identifioimaan linja matkustajille esimerkiksi 17Y. Kyllä Linjan nimi fi Suomenkielinen linjan nimi Kyllä Linjan nimi sv Ruotsinkielinen linjan nimi Ei Kulkutapa Kulkutapa/liikenneväline, jolla linjaa liikennöidään. Kyllä 4 Reittien hallinta Reitit-näkymä Kuva 8 Reitit-näkymä Reitit-näkymässä hallitaan järjestelmässä olevia reittejä. Reitti on tietty pysäkkiketju ja sen suunniteltu ajoaika. Linjan jokainen lähtö ajaa jonkin reitin. Järjestelmään tulee määritellä suunnittain kaikki toisistaan eroavat reitit. Ennen reittien suunnittelua tulee järjestelmässä olla pysäkit syötettyinä. Mikäli reitin on suunnitellut liikennöitsijä, näytetään näkymässä myös liikennöitsijätieto. Käyttäjä voi muokata vain oman organisaationsa reittejä. Järjestelmä ei rajaa tietyn reitin käyttöä vain tietyille linjoille. Avaa-toiminto näyttää reitin kartalla ja avaa näkymän, jossa reitin tietoja voidaan hallita. Kopioi-toiminnolla voidaan tehdä olemassa olevasta reitistä kopio. Tätä toimintoa voi käyttää tilanteessa, jossa on tarve tehdä olemassa olevasta reitistä toinen versio, jossa on eri määrä pysäkkejä tai eroavaisuus ajoajoissa. Toiminto avaa reitin hallintanäkymään. Lisää-toiminto avaa näkymän, jossa linjan tiedot voi antaa. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 29(37)

Poista-toiminto poistaa reitin järjestelmästä. Poistaminen on mahdollista vain, mikäli yksikään järjestelmään määritelty lähtö ei hyödynnä kyseistä pysäkkiketjua. Reitin hallintanäkymä Kuva 9 Reitin hallintanäkymä Kun valitaan Avaa- tai Kopioi-toiminto, näytetään reitti kartalla. Reittiin voi tällöin lisätä pysäkkejä joko Reitin hallintanäkymästä tai klikkaamalla kartalta pysäkkiä. Reitin ensimmäisen pysäkin lisääminen. Reitin ensimmäinen pysäkki voidaan asettaa joko klikkaamalla kartalta pysäkkiä tai syöttämällä pysäkin tiedot Reitin hallintanäkymään. Reitin seuraavien pysäkkien lisääminen. Reitin seuraavat pysäkit voi klikata kartalta ajojärjestyksessä, jolloin pysäkit listautuvat sitä mukaan Reitin hallintanäkymään. Reitin pysäkin poistaminen. Reitin pysäkki voidaan poistaa Reitin hallintanäkymästä. Mikäli reitin keskeltä poistetaan pysäkki, pysäkkiä edeltävä ja seuraava pysäkki yhdistyvät myös kartalla. Reitin pysäkin lisääminen keskelle reittiä tai reitin alkuun. Reitin pysäkkejä voi reitin keskelle ja alkuun lisätä Reitin hallintanäkymästä. Mikäli reitin keskelle lisätään pysäkki, pysäkkiä edeltävä ja seuraava pysäkki yhdistetään kyseiseen pysäkkiin kartalla automaattisesti. Jokaiselle pysäkille tulee merkitä aika edelliseltä pysäkiltä kyseiselle pysäkille. Tuloaika on ajoaika edelliseltä pysäkiltä kyseiselle pysäkille ja lähtöaika on ajoaika edelliseltä pysäkiltä tältä pysäkiltä poistumiseen (aikaan voi olla lisättynä esimerkiksi ajantasausaikaa). Useimmiten tuloja lähtöajat ovat samat. Kaikki reittiin tehdyt muutokset heijastuvat kaikkiin niihin lähtöihin, joille kyseinen reitti on asetettu. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 30(37)

Reitille voi asettaa seuraavat tiedot: Kenttä Selite Pakollisuus Reitin tunniste Kuvaava, yksilöllinen tunniste reitille. Kyllä Pysäkki Pysäkki, jonka kautta reitti kulkee Kyllä Tulo Lähtö Ajoaika edelliseltä pysäkiltä tälle pysäkille. Muodossa MM:SS esimerkiksi 01:15. Ajoaika edelliseltä pysäkiltä tältä pysäkiltä poistumiseen. Muodossa MM:SS esimerkiksi 01:15. Kyllä Kyllä 5 Lähtöjen hallinta Lähdöt-näkymä Kuva 10 Lähdöt-näkymä Lähdöt-näkymässä hallitaan järjestelmässä olevia lähtöjä. Lähtö on tietyn pysäkkiketjun ja sen ajoaikasuunnitelman toteutus tiettynä päivänä alkaen tiettyyn kellonaikaan. Ennen lähtöjen suunnittelua tulee järjestelmässä olla pysäkit, linjatiedot, reittitiedot ja kalenterit syötettyinä. Lähdöt-näkymässä käytetään vasemmassa reunassa olevia suodattimia rajoittamaan lähtöjen määrää taulukossa. Voimassaoloaika ja linjan valinta ovat pakollisia rajauksia. Etsi-toiminnolla voi tämän jälkeen hakea taulukosta tietoja. Lähtöön voi liittää myös autokiertotiedon, joka yhdistää usean lähdön yhden ajoneuvon näkökulmasta yhdellä ajorupeamalla ajettavaksi kokonaisuudeksi. Järjestelmä ei sisällä ajokiertosuunnitelman loogisuustarkasteluita. Avaa-toiminto avaa näkymän, jossa lähdön tietoja voidaan hallita. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 31(37)

Aseta autokierto -toimintoa käytetään valitsemalla ensin usea rivi taulukosta ja asettamalla kyseisille lähdöille tämän jälkeen autokierto. Asetettu arvo korvaa valitulla lähdöllä jo mahdollisesti olevan autokiertotiedon. Lisää-toiminto avaa näkymän, jossa lähdön tiedot voi antaa. Poista-toiminto poistaa lähdön järjestelmästä. Muita lähtöön liittyviä tietoja (esimerkiksi linja tai reitti) ei poisteta tällöin järjestelmästä. Lähdön hallintanäkymä Kuva 11 Lähdön hallintanäkymä Kun sekä reitti että lähtöaika on syötetty, listautuvat tulo- ja lähtöaikojen kellonajat pysäkeittäin. Mikäli keskiyön jälkeen tapahtuva lähtö kuuluu edelliselle päivälle, merkitään lähtö suuremmalla kellonajalla kuin 23:59. Esimerkiksi 25:15 on käytettävissä oleva kellonaika. Järjestelmä luo lähtöajan jälkeen olevat vuorokauden rajan yli menevät kellonajat aina suurempina kuin 23:59. Mikäli pysäkkilistaan tai tulo- ja lähtöaikoihin on tarve tehdä muutoksia, tehdään se reittien hallinnan kautta. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 32(37)

Kenttä Selite Pakollisuus Linja Linja, johon lähtö liittyy. Kyllä Suunta Lähdön suunta. Kyllä Voimassaolo Lähdölle valitaan kalenteriaika, jolloin lähtö ajetaan. Katso kohdasta Kalenterien hallinta, miten voimassaoloa hallitaan. Lähdöt ovat voimassa aikataulukausittain ja päivätyypeittäin, esimerkiksi talvella 2008 arkisin. Kyllä Autokierto Autokierto, jolla lähtö on suunniteltu ajettavan. Kyllä Reitti Pysäkkiketju ja pysäkkien välinen ajoaikasuunnitelma lähdölle. Kyllä Lähtöaika Muodossa HH:MM:SS esimerkiksi 23:14:00 Kyllä 6 Kalenterien hallinta Kalenterinäkymässä hallitaan lähtöjen voimassaoloaikoja. Terminologisesti voidaan puhua samasta asiasta palveluaikoina, aikataulukausina ja päivätyyppeinä. Liikennöinti mallinnetaan järjestelmään siten, että tiettyinä viikonpäivinä ajetaan tiettyä joukkoa lähtöjä ja tähän tehdään poikkeuksia tietyille kalenteripäiville. Järjestelmään ei siis listata jokaista vuoden kalenteripäivää erikseen. Kuva 12 Kalenterinäkymä Avaa-toiminto avaa näkymän, jossa palveluajan tietoja voidaan hallita. Lisää-toiminto avaa näkymän, jossa palveluajan tiedot voi antaa. Poista-toiminto poistaa voimassaolon perustiedot sekä kaikki voimassaoloaikaan liittyvät lähdöt järjestelmästä. Voimassaoloajan poistaminen on mahdollista vain, jos käyttäjällä on Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 33(37)

muokkausoikeus kaikkiin niihin lähtöihin, jotka käyttävät voimassaoloaikaa (tilanne voi tulla eteen, mikäli suunnitteluoikeuksia on annettu liikennöitsijöille). Kuva 13 Palvelun voimassaolo -näkymä Kenttä Selite Pakollisuus Nimi Kuvaava, yksilöllinen nimi voimassaololle. Kyllä Viikonpäivä Voimassa alkaa Valitaan ne päivät, joina ajetaan samaa lähtöjen joukkoa. Päivämäärä, jolloin voimassaolo alkaa. Annettu päivä on osa päivämääräväliä. Päivämäärä annetaan muodossa DD.MM.YYYY. Ei Kyllä Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 34(37)

Kenttä Selite Pakollisuus Voimassa päättyy Poikkeuspäivät Päivämäärä, jolloin voimassaolo Päättyy. Annettu päivä on osa päivämääräväliä. Päivämäärä annetaan muodossa DD.MM.YYYY Lista kalenteripäivistä, jotka on joko poistettu tai lisätty tähän palvelun voimassaoloaikaan. Kyllä Ei Erikoispäivien ja poikkeuspäivien hallinta Päivätyypin vaihdolla eli poikkeuspäivillä ratkaistaan tilanne, jossa on tarve jonain päivänä ajaa normaalista poikkeavaa liikennettä. Päivätyypin vaihdossa jokin kalenteripäivä otetaan pois siltä voimassaoloajalta, jona liikenne normaalisti ajettaisiin ja sama kalenteripäivä lisätään voimassaoloajalle, jonka liikenne halutaan kyseisenä päivänä ajaa. Lisää poikkeus -toiminto lisää kyseiselle voimassaoloajalle tietyn päivämäärän joko poistona tai lisäyksenä. Päivämäärän tulee olla voimassaoloajan sisällä. Kuva 14 Poikkeus-näkymä Kenttä Selite Pakollisuus Päivämäärä Toiminta Voimassaoloajasta poikkeavan liikenteen kalenteripäivä, joka annetaan muodossa DD.MM.YYYY. Poistolla poistetaan päivämäärä määritellystä voimassaoloaikavälistä. Lisäyksellä lisätään päivämäärä ajettavaksi tälle voimassaoloaikavälille. Kyllä Kyllä Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 35(37)

3 Liikennöitsijän omien linjojen suunnittelijan toiminnallisuus 1 Tietojen katselu Liikennöitsijän omien linjojen suunnittelija voi katsella kaikkia niiden TVV-alueiden tietoja, joissa liikennöitsijä liikennöi. 2 Tietojen muokkaus Roolin omaava käyttäjä voi myös muokata tietoja niiden linjojen osalta, joihin TVV on oikeuden erikseen myöntänyt. Muokkausoikeus kattaa tällöin sekä reittien että lähtöjen hallinnan. 3 Reittien hallinta Reittien hallintaan liittyvät toiminnallisuudet toimivat, kuten on esitelty luvussa 24 Reittien hallinta. 4 Lähtöjen hallinta Lähtöjen hallintaan liittyvät toiminnallisuudet toimivat, kuten on esitelty luvussa 25 Lähtöjen hallinta. Liikennöitsijän omien linjojen suunnittelija voi kuitenkin hallita vain sellaisten linjojen lähtöjä, joihin hänellä on oikeus erikseen annettuna. Käyttäjä voi valita lähdölle vain sellaisen reitin, johon hänellä on myös hallintaoikeus. 3 Järjestelmän virheilmoitukset Järjestelmä näyttää pakollisten tietojen puuttumisen värjäämällä puuttuvan syöttökentän kehyksen punaisella. Niistä virheistä, jotka ovat odotettavia käyttäjän toimintaan liittyviä virheitä, näytetään kuvaava virheilmoitus. Esimerkiksi, mikäli pysäkeille on määritelty tariffivyöhykkeitä 1-3 ja käyttäjä yrittää muuttaa tariffivyöhykkeiden lukumääräksi 1. Annetaan virheilmoitus, jossa tilanne selitetään Vyöhykkeiden lukumäärä 1 on liian pieni. Pysäkeillä on vyöhykkeitä, joiden arvo on suurempi kuin syötetty arvo. Arvon on oltava vähintään 3. Odottamattomista palvelimella tapahtuneista virheilmoituksista annetaan virheilmoitus Palvelimella tapahtui virhe. Tällaisen virheen tapahtuessa on syytä ottaa yhteys palvelun tukeen. Lisäksi järjestelmä ilmoittaa käyttöliittymässä tilanteista, jossa jollekin linjalle ei ole syötetty sopimustietoa tai jollain pysäkillä on puutteellinen vyöhyketieto. Nämä tilanteet voivat esiintyä silloin, kun integraatiosta on tullut puutteellista tietoa. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 36(37)

Kuva 15 Vyöhykkeen puuttuminen 4 Muutoshistoria Kuva 16 Sopimustiedon puuttuminen Versio Päiväys Tekijä Tarkistaja Hyväksyjä Muutoshistoria V0.1 09-05-2014 Lauri Porthan V0.2 19-05-2014 Pekka Kaarela / Mattersoft <nimi> <nimi> Dokumentin pohja Dokumentin ensimmäinen versio. Copyright @ 2014 TVV lippu- ja maksujärjestelmä Oy 37(37)