Ohje Reitti- ja aikataulueditori RAE 1 (14) 18.08.2016 Luonnos Liikenteen palvelut / Liikenne ja tieto Linja-autoreittien ja aikataulujen tallentaminen RAE-työkalulla 1 RAE-työkalu, yleistä... 2 2 Reittien, pysäkkien, pysäkkiaikataulujen ja ajopäiväkalenterin tallentaminen... 2 2.1 Reitin perustiedot... 2 2.2 Reitin pysäkkiketju... 4 2.3 Reitin vuorot, aikataulu ja ajopäiväkalenteri... 9 2.3.1 Vuoron lisääminen reitille... 9 2.3.2 Ajopäiväkalenterin kohdistaminen vuorolle... 9 2.3.3 Vuorokohtaiset pysäkkiajat... 12 2.3.4 Reitin muutoshistoria... 12 2.3.5 Reitin tallentaminen... 12 2.3.6 Olemassa olevan reitin hyödyntäminen uuden reitin luomisessa... 12 3 Reitin hyväksyttäminen ja siirtäminen koontitietokantaan... 13 4 Olemassa olevien reittien muokkaaminen... 13 5 Reitin tallentaminen gtfs-muodossa... 13 6 Kysymyksiä ja vastauksia... 14
Ohje 2 (14) 1 RAE-työkalu, yleistä Liikenneviraston Reitti- ja aikataulutyökalulla (RAE) voidaan tallentaa joukkoliikennereittejä pysäkkiketjuineen ja pysäkkikohtaisine aikatauluineen. RAE-työkalun käytössä on kaksi roolia: - tietojen tallentaja (=editor, esim. liikenteenharjoittaja) - viranomainen (=admin, esim. Ely-keskus) Viranomaisen RAE-työkalussa hyväksymät reitit siirtyvät viikonloppuisin automaattisesti Liikenneviraston joukkoliikenteen koontitietokantaan ja esimerkiksi matka.fi-palveluun. RAE-työkalussa reittejä voi tallentaa gtfs-formaatin mukaisina tiedostoina. Liikenteenharjoittaja voi näin toimittaa esim. reittiliikennelupahakemuksensa reitti- ja aikataulutiedot sähköisessä muodossa (=gtfs-pakettina) viranomaiselle. (kts erillinen ohje) Rae-työkalussa on käytössä Digiroadin pysäkit. Pysäkkiaineiston puutteista tulee ilmoittaa viranomaiselle tai osoitteeseen pysakit@digiroad.fi. 2 Reittien, pysäkkien, pysäkkiaikataulujen ja ajopäiväkalenterin tallentaminen 2.1 Reitin perustiedot Reitin perustietojen lisääminen aloitetaan painamalla aloitussivulla Lisää uusi reittipainiketta. Luonnoksena tallennetut reitit ilmestyvät etusivun Luonnokset-listaukseen, josta reittiä pääsee muokkaamaan klikkaamalla reitin kohdalla hiirellä. Reitin perustiedot lisätään alla olevan näkymän mukaisesti: Kentät ovat lähtökohtaisesti pakollisia. Poikkeuksina Reitin otsatunnus ja internetosoitteet (liikennettä ja lipunmyyntiä kuvaavat infosivut, tulossa)
Ohje 3 (14) Liikennöintimuoto valitaan alasvetovalikon vaihtoehdoista: - linja-auto - metro - raitiovaunu - lautta - juna Liikennöintityyppi valitaan myös alasvetovalikosta, jonka sisältö riippuu liikennöintimuodosta. Linja-auto vaihtoehdolla liikennöintityyppi vaihtoehdot ovat seuraavat: - paikallisliikenne - kaukoliikenne - pikavuoro Reitin otsatunnus-kenttään kirjataan reitin matkustajalle tarkoitettu tunnus, esimerkiksi 4B. (ei pakollinen kenttä) Nimi-kenttään annetaan linjan nimi, esimerkiksi Matkakeskus-Kärki. Suunta-kentällä tarkoitetaan linjan suuntaa, esimerkiksi keskustaan tai Kärki. Lähtöpaikka-kenttään kirjataan linjan lähtöpaikka, esimerkiksi Matkakeskus. Määränpää-kenttään ilmoitetaan linjan päätepiste tai kääntöpiste, jos linja on rengaslinja, esimerkiksi Kärki. Määränpää näytetään mm. reittioppaassa reitin määränpäänä, eli nimen pitää olla hyvin kuvaava esim. kaukoliikenteessä Jyväskylä, paikallisliikenteessä Matkakeskus. Määränpää on se teksti joka näytetään bussin otsatekstinä.
Ohje 4 (14) Lupatunnus-kenttään tallennetaan sellainen lupatunnus, joka mahdollistaa liikenteen tunnistamisen esim. Seinäjoella käytetty paikallisliikenteen tallentamisessa lupatunnuksena SEI. Tunnuksen pitää olla sama kuin Vallu ja Waltti-järjestelmissä. Pyri käyttämään luonnosvaiheessakin mahdollisimman hyvin kuvaavaa ja yksilöivää tunnistetta. Taho-kenttään tallennetaan se taho, joka myy reitille matkaliput. Taho-kenttään tallennetaan markkinaehtoisessa liikenteessä liikenteenharjoittajan nimi tai mahdollisesti lippuja myyvä muu taho. Viranomaisen järjestämässä liikenteessä kenttään tallennetaan viranomaisen nimi, esim. Jyväskylä. Lipunmyyntiurl-kenttään tallennetaan tieto url-osoitteesta, johon matkustaja voidaan ohjata lipun ostamista tai lipun ostamisesta informoimista varten. Alkaa-kenttään täytetään linjan liikennöinnin alkamispäivämäärä painamalla kentän päässä olevaa kalenteri-painiketta. Päättyy-kenttään täytetään vastaavasti linjan liikennöinnin päättymispäivämäärä. Kaikkien kenttien täyttämisen jälkeen painetaan kenttien alta Tallenna luonnoksenapainiketta. 2.2 Reitin pysäkkiketju Reitin perustietojen tallentamisen jälkeen aktivoituu perustietojen alle Reitin pysäkkiketju-osio, jossa pysäkkiketjut editoidaan karttapohjalle. Osio avautuu tekstiä klikkaamalla. Avautuvassa karttaikkunan oikeassa yläkulmassa ovat ikkunat: - Näytä pysäkit kartalla - Haku - Pysäkkiketjut - Reititys - Toiminnot
Ohje 5 (14) Näytä pysäkit kartalla-ikkuna aktivoituu, kun kartalla zoomataan tarpeeksi lähelle. Reitin tekeminen aloitetaan navigoimalla haluttuun paikkaan kartalla, ja valitsemalla näytettävät pysäkit. Pysäkkiä tai paikkaa voi etsiä myös Haku-toiminnolla. Pysäkit ilmestyvät punaisina ympyröinä kartalle. Pysäkkiä klikkaamalla avautuu Uusi kohde pysäkkiketjuun-ikkuna. Ikkunassa on kerrottu pysäkin tiedot ja painamalla ikkunan alareunassa olevaa Lisääpainiketta, pysäkki lisätään pysäkkiketjuun. Suuntima osoittaa suunnan, johon pysäkkiä käyttävä linja jatkaa pysäkiltä. Suuntiman avulla voi päätellä oikean pysäkin, mikäli vaihtoehtoja on useita. Jos lisättävä pysäkki on muu kuin ketjun ensimmäinen pysäkki, sen paikan ketjussa voi valita alavetovalikosta, johon on listattu ketjussa olevat pysäkit. Alasvetovalikossa oletuksena oleva paikka ei välttämättä ole oikea, joten se on syytä tarkistaa lisätessä. Pysäkin paikkaa pysäkkiketjussa on myös mahdollista muuttaa raahaamalla Pysäkkiketjuikkunassa.
Ohje 6 (14) Pysäkit listataan karttanäkymän oikean yläkulman Pysäkkiketju-ikkunaan Kun on määritelty reitin alku- ja määränpääpysäkki, kannattaa piirtää reitti tie/katuverkko pitkin Reititä-valinnalla ja sitten vielä tarvittaessa säätää reittiviiva kulkemaan oikein - lisäämällä muotopisteitä - mikäli mahdollista, käytä reitin linjaukseen välipysäkkejä - zoomaa muotopistettä lisätessä tarpeeksi lähelle karttaa, jotta muotopiste osuu mahdollisimman hyvin tieverkolle haluttuun kohtaan eikä ylimääräisiä pistoja muodostu - raahaamalla reittiviivaa Reitin muotopiste lisätään raahaamalla reittiä halutusta kohdasta tarttumalla reitistä "kiinni" hiirellä klikkaamalla ja viemällä reitti haluttuun paikkaan hiiren painike painettuna. Muotopiste voidaan lisätä myös klikkaamalla hiiren oikealla näppäimellä kohtaa, josta halutaan reitin kulkevan, jolloin aukeaa Lisää muotopiste-ikkuna: Ikkunassa valitaan, mihin kohtaan pysäkkiketjua muotopiste lisätään, ja tämän jälkeen painetaan Lisää-painiketta. Reititys-ikkunan Reititä-painiketta painamalla työkalu piirtää reitin pysäkkiketjuun lisättyjen pysäkkien ja muotopisteiden kautta.
Ohje 7 (14) Reitin pysäkkiketjun täydentäminen on mahdollista lisäämällä kaikki pysäkit käsin klikkaamalla listaan tai haavittamalla reitin välipysäkkejä. Valitse haavitettavat pysäkkityypit ja paina Reititä-nappulaa: Haavittaessa pysäkeille arvioidaan ohitusajat yksinkertaisella lineaarisella interpolointimenetelmällä. Välipysäkkien haavituksen jälkeen on tarpeen painaa uudestaan Reititä-painiketta ilman haavitusta tarkempien ajoaikojen laskemiseksi. Tämä tarkempi laskenta huomioi tie-/katuverkon nopeustasot. Reittiä kannattaa vielä katsoa huolellisesti läpi kartalla ja pitää kaikki pysäkit näkyvillä kartalla. Näin voidaan varmistaa, että kaikki pysäkit esim. rampeilla ovat mukana reitillä.
Ohje 8 (14) Tässä esimerkissä rampilla oleva pysäkkiä ei ole automaattisesti tullut mukaan reitille, vaan se pitää lisätä käsin: Reitittämisen jälkeen Pysäkkiketju-ikkunassa on mahdollista muokata ajo- ja odotusaikoja pysäkeillä klikkaamalla ko. sarakkeessa olevaa arvoa, ja kirjoittamalla uusi aika kenttään, ja enter. Käsin lisätty pysäkkiaika saa tähti-merkinnän pysäkkiketjussa. Käsin asetettu poistetaan klikkaamalla kelloaikaa ja tyhjentämällä kenttä, ja enter. Tähtimerkintäkin häviää. Reitin ja pysäkkiketjun tiedot tallennetaan painamalla Toiminnot-ikkunan Tallennapainiketta. Paina ennen muutosten tallentamista vielä kerran Reititä-painiketta, jotta pysäkkiketjuun ja ajoaikoihin tehdyt muutokset varmasti muodostuvat oikein. Järjestelmä huomauttaa mahdollisista virheistä. Reititys eli pysäkkikohtaisten aikojen uudelleenlaskenta saattaa kestää kauankin, jos pysäkkiketjussa on paljon pysäkkejä. Muista aina odottaa, että reitti on varmasti tallennettu
Ohje 9 (14) 2.3 Reitin vuorot, aikataulu ja ajopäiväkalenteri 2.3.1 Vuoron lisääminen reitille Reitille on mahdollista lisätä vuoroja joko lisäämällä yksi vuoro kerrallaan, tai generoimalla automaattisesti useampia tasavälein lähteviä vuoroja. Jokaiselle vuorolle pitää määritellä ajopäiväkalenteri: Mikäli haluaa luoda useita vuoroja kerrallaan, se onnistuu kätevästi Lisää vuoroja toiminnolla Tämä toiminto lisää vuoroja tasaisin aikavälein, mutta jälkikäteen on helppo muuttaa lähtöaikoja. 2.3.2 Ajopäiväkalenterin kohdistaminen vuorolle Käytä käyttöösi sopivaa valmista olemassa olevaa kalenteria, esim. Livi, Ma-Pe, aina, ei pyhät hyödyt: tulevien vuosien arkipyhät päivittyvät kalenteriin automaattisesti Livi, arkipyhät -tason avulla jos teet omia täydennyksiä esim. lisäät koululauantai-päiviä niin tallenna kalenteri uudella nimellä esim Seinäjoki, koulup HUOM: jos käytät muiden tekemiä kalentereita tai tasoja niin varaudu siihen, että kalenteri saattaa muuttua. Eli varminta on hyödyntää Livi, alkuisia kalentereita tai tasoja. Liikennevirastoa voi myös pyytää lisäämään yleiskäyttöisiä kalentereita/tasoja.
Ohje 10 (14) RAE-työkaluun on luotu automaattisesti Vallu-liikenteen tarvitsemat kalenterit käyttäen kuntien todellisia koulujen lomatietoja. Kyseisiä kalentereita ei voi muokata Rakeen kautta ja niitä käytetään ensisijaisesti parantamaan Vallun tuottaman tiedon laatua Koontitietokannassa. Kyseisiä kalentereita voi hyvin käyttää soveltuvassa RAE-liikenteessä ja ne tarjoavat ylläpidetyn ja automaattisesti päivittyvän ajopäiväkalenterin. Listalle on myös lisätty automaattisesti luodut kuntakohtaiset koulujen lomapäiviä kuvaavat tasot, jotka perustuvat kuntien todellisiin lomatietoihin. Nämä tasot päivittyvät automaattisesti ja niitä suositellaan käytettävän myös RAE-työkalulla luotavassa liikenteessä. Mikäli on tarve tehdä uusi kalenteri aloita nimeämällä kalenteri Lähtökohtana kalenterin luomisessa on ajettavat viikonpäivät: eli ruksaa sopivat ma, ti, ke, to, pe, la, su Mikäli vuoroa ei ajeta aina niin aloita ajopäivien karsinta tasojen avulla kokoa siis uusi kalenteri tasojen avulla, joko olemassa olevien yhteiskäyttöisten tasojen avulla tai luomalla uusia esim. Seinäjoki, koululomat (esim. hiihtoloma viikko9, kesäloma, syysloma, joululoma) Livi, arkipyhät
Ohje 11 (14) Tasoille on kaksi ajetaan valintaa: o Kyllä-valinnalla ajopäiviksi valitaan kaikki päivät, jotka on valittuna sekä viikopäivät-valinnoilla että merkitty ajettaviksi kyseisessä kalenterissa. Kyllä-valinnassa valitaan siis viikonpäivät-valinnan ja kalenterin ajopäivistä leikkaus. o Ei-valinnalla poistetaan tasoon merkityt päivät ajopäiväkalenterin ajopäivistä. Esimerkki ajetaan-valinnan käytöstä: Seuraavanlaisilla viikonpäivä- ja tasovalinnoilla saadaan muodostettua ajopäiväkalenteri, jossa ajetaan Maanantaisin sekä To-Pe koulujen loma-aikoina: Tee tarvittaessa vielä päiväkohtaisia säätöjä kalenteriin (esim. tietyn koulun koululauantait ja vastaavasti arkivapaat) Tallenna kalenteri ja kiinnitä se reitin vuoroihin. Kalenteri voidaan poistaa Poista-painikkeella.
Ohje 12 (14) Jos kalenteri on käytössä, sitä ei voi poistaa ennen kuin reitit/vuorot, jotka käyttävät kyseistä kalenteria on poistettu tai niille on tehty/kiinnitetty toinen kalenteri. 2.3.3 Vuorokohtaiset pysäkkiajat Kun vuoron kaikki vuorot on muodostettu ja varustettu ajopäiväkalenterilla niin paina vuorolistan alla olevaa Tallenna-painiketta, Aikataulu-sarakkeen Näytä-teksti aktivoituu ja tekstiä klikkaamalla pääsee tarkastelemaan vuoron pysäkkikohtaista aikataulua. Poista valitut-painikkeella voidaan poistaa vuoroja listauksesta. 2.3.4 Reitin muutoshistoria Reitin muutoshistoria on näkyvillä Vuorot-osion alla, ja reitille voidaan lisätä haluttaessa kommentti. 2.3.5 Reitin tallentaminen Reitti on tallennettu, kun se on tallennettu sekä Reitin pysäkkiketju osiossa (=kartalla) että Vuorot-osiossa. Reitin perustietoja voidaan myös muuttaa ja tallentaa Reitin perustiedot-osion Tallenna luonnoksena-painikeella. Poista-painikkeella voidaan poistaa reitti. 2.3.6 Olemassa olevan reitin hyödyntäminen uuden reitin luomisessa Uuden reitin voi luoda myös olemassa olevan reitin pohjalta. Valitse reitti voimassa olevien tai reittiluonnosten listalta. Nimeä uusi reitti ja tallenna uutena:
Ohje 13 (14) 3 Reitin hyväksyttäminen ja siirtäminen koontitietokantaan Reitit lähetetään viranomaiselle hyväksyttäväksi Lähetä-painikkeella. Viranomainen voi hylätä reitin, minkä jälkeen reitti palautuu liikenteenharjoittajalle luonnokset-listalle. Viranomainen voi lähettää hylkäämiseen liittyvän kommentin sähköpostilla. Sähköposti lähetetään sille henkilölle, joka on lähettänyt luonnoksen viranomaiselle. Viranomaisen hyväksymät reitit ovat nähtävissä Voimassaolevat reitit-listauksessa. Viranomaisen hyväksynnän jälkeen reitin tiedot siirtyvät automaattisesti Liikenneviraston koontitietokantaan (vrt. Joukkoliikennelaki 57 ) 4 Olemassa olevien reittien muokkaaminen Olemassa olevaa reittiä (voimassa oleva tai luonnos) voi muokata ja tallentaa samana tai uutena Jos muokkaa ja tallentaa voimassa olevaa reittiä niin se poistuu voimassaolevien reittien listalta. Eli on tärkeää lähettää reitti mahdollisimman pian viranomaiselle hyväksyttäväksi, jotta se saadaan taas pian voimaan. 5 Reitin tallentaminen gtfs-muodossa Reitit ja aikataulut voidaan tallentaa GTFS-muodossa ruksittamalla Vie -sarakkeesta halutut reitit ja painamalla Lataa valitut reitit. Reitti tai reitit tallentuvat gtfs-muotoisena zip-pakettina. kts: https://developers.google.com/transit/gtfs/
Ohje 14 (14) 6 Kysymyksiä ja vastauksia Q: Näen listan reiteistä luonnoksissa/voimassaolevissa, mutta miten pääsen yksittäisen reitin tarkempiin tietoihin? A: Klikkaa reittiä taulukossa. Q: Miten pääsen näppärimmin takaisin vuoron tietoihin, jos välillä olen käynyt katsomassa vuoron ajopäiväkalenteria? A: Klikkaa Reitit-välilehteä, niin pääset takaisin ko reitin näkymään Q: Milloin RAE-käyttäjän kannattaa tallentaa ajopäivät tai ei-ajettavat päivät omaan kalenteriin suoraan ja milloin hyödyntää tasoja? A: Tasojen hyödyntämisessä on se etu, että kun esim. Liikennevirasto ylläpitää tai kerää keskitetysti tietoa myös tulevien vuosien kuntien koulujen lomapäivistä tai arkipyhistä niin nämä muutokset tai täydennykset tulevat käyttöön automaattisesti kaikissa ko tasoa käyttävissä kalentereissa, eikä näitä tietoja siis ole tarvetta erikseen ylläpitää. Huom: Jos käytät yhteiskäyttöistä (=jonkun toisen organisaation tallentamaa) kalenteria tai tasoa niin varaudu siihen, että kalenteri voi muuttua huomaamatta.