1 (15) PARAS REAALIAIKARAJAPINTA SISÄLLYSLUETTELO 1 YLEISTÄ... 2 2 PROJEKTIN TAVOITTEET... 3 2.1 Rajapintojen tavoitteet...3 2.1.1 PARAS-järjestelmän sisäisen rajapinnan (1) vaatimukset...3 2.1.2 Reaaliaikarajapinnan (2) vaatimukset...3 2.1.3 Julkisen reaaliaikarajapinnan (3) vaatimukset...4 2.1.4 Rajapinnat (4) Liikennetiedotteen ja (5) MALA-aikataulutiedot...4 2.2 Toiminnalliset vaatimukset...4 2.2.1 Lähdön aloitus...4 2.2.2 Lähdön suoritus...5 2.2.3 Lähdön lopetus...5 2.2.4 Toiminta tietoliikenneyhteys katkoksissa...5 2.3 Vaatimusten täyttyminen...5 3 AVOIMEN REAALIAIKARAJAPINNAN TOTEUTUSRATKAISU... 5 4 PROJEKTIN ONNISTUMINEN JA RISKIT... 6 5 JULKISEN PALVELUN ESITTELY... 7 5.1 Yleistä...7 5.2 Paras ajat - palvelu...7 5.3 Reittiopas ja poikkeustiedotteet...13 5.4 Paras ajat mobiilipalvelu...14
2 (15) PARAS REAALIAIKARAJAPINTA 1 Yleistä Tämä dokumentti on raportti Tampereen kaupungin liikennelaitoksen tilaamasta projektista, jossa kehitettiin reaaliaikaisen matkustajainformaation avoin XMLrajapinta ja toteutettiin rajapinnan pilotointi TKL:n reittioppaassa. Hankkeen konkreettisena tuloksena matkustajat voivat nähdä reittioppaassa bussien reaaliaikainformaatioon perustuvia saapumisaikaennusteita aikataulunmukaisten saapumisaikojen sijaan. Lisäksi matkustajille tehtiin mahdolliseksi nähdä bussien reitit sekä tarkastelun kohteena olevalle pysäkille tulossa olevien bussien reaaliaikainen sijainti kartalla. Kuvassa 1 on toteutettavan järjestelmän periaatekuva. Katkoviivoilla rajatun alueen sisällä on reaaliaikarajapintaa koskeva laajennus. Laajennus edellyttää reaaliaikapalvelimen lisäämistä nykyiseen PARAS järjestelmään, reaaliaikarajapintapalveluiden toteuttamista reaaliaika- ja VM-datan palvelimille sekä reittiopaspalvelun muokkaamista hyödyntämään ko. rajapintaa. PARAS reaaliaikakoneet ja PARAS reaaliaikapalvelin sijaitsevat TKL:n sisäisessä verkossa. NRT-järjestelmän palvelin sijaitsee Helsingissä WM-datan serverihuoneessa. PARAS reaaliaikakoneet PARAS Reaaliaikapalvelin Áikataulutiedot (5) RT1, RT2 Odotusaikaennusteet Paikkatieto (1) Reaaliaikakone rajapinta XML reaaliaikarajapinta TKL tietokanta Reaaliaikadata (2) WM-DATA XML reaaliaikarajapinta Aikataulutiedot (5) Liikennetiedotteet Rajapinta (4) Reittiopas -palvelu (3) Reittioppaan käyttäjille -Pysäkkikohtainen odotusaikaennuste XHTML -muodossa -Bussin sijainti kartalla -Liikennetiedotteet TKL:n työasema Suunnittelija: Seppo Saukko Otsikko: Projekti: Päiväys: 28.02.05 Versio: 1.1 Tiedosto: D101068_C_PARAS_Reaaliakarajapin ta_vaatimusmäärittely.doc Kuva 1. Järjestelmäkaavio
3 (15) Kaaviossa on numeroitu eri järjestelmien rajapinnat ja ne ovat: (1) Rajapinta PARAS reaaliaikakoneen ja Reaaliaikapalvelimen välillä (2) Push -tyyppinen rajapinta kaiken tarpeellisen ja saatavissa olevan reaaliaikatiedon jakamiseen PARAS-järjestelmästä muille järjestelmille. (3) Julkinen reaaliaikarajapinta. Rajapinta on kyselyperustainen ja siitä on mahdollista saada bussien sijainnit sekä arvioidut saapumisajat pysäkeille. Arvioitu saapumisaika on reaaliaikaan pohjautuva jos mahdollista, muuten se on aikataulunmukainen. Saapumisaika-arvioon on liitetty tieto siitä kumman tyyppinen arvioitu saapumisaika on. (4) Liikennetiedotteet-rajapinta yleisten ja linjakohtaisten tiedotusten välittämiseksi (5) Winbus-ohjelman ja PARAS/Reittiopas järjestelmien välinen rajapinta. Projektin aikana selvitetään olisiko rajapintaan tehtävistä muutoksista apua projektin toteuttamisessa. 2 Projektin tavoitteet Tässä luvuissa käytetty merkintä (n) viittaa rajapintaan n kuvassa 1. 2.1 Rajapintojen tavoitteet 2.1.1 PARAS-järjestelmän sisäisen rajapinnan (1) vaatimukset PARAS-järjestelmä tuottaa saapumisaikaennusteet määritellyille pysäkeille PARAS-järjestelmä korjaa saapumisaikaennustetta tarvittaessa Kun PARAS-järjestelmä on havainnut että virtuaalipysäkki on ohitettu kertoo se että pysäkiltä voidaan poistaa tietyn lähdön tiedot PARAS-järjestelmä tuottaa paikkatiedon WGS-84 koordinaatti muodossa 2.1.2 Reaaliaikarajapinnan (2) vaatimukset Reaaliaikarajapinnan läpi välitettävään tietoon liittyvät vaatimukset ovat Tieto välitetään reaaliaikarajapinnan läpi XML -muodossa Rajapinnasta välitetään paikkatieto kaikista valitun operaattorin lähtöjä ajavista busseista (sisältää auton paikkakoordinaatit, lähdön tunnisteen ja odometri -tiedon metreinä) Rajapinnasta välitetään PARAS-järjestelmän tuottamat lähtöjen saapumisaikaennusteet virtuaalipysäkeille. Rajapinnasta välitetään kaikkien lähtöjen edellä/jäljessä tieto sen muuttuessa
4 (15) Rajapinnasta välitetään tieto kaikkien lähtöjen kaikkien virtuaalipysäkkien pysäkkien ohituksista Rajapinnasta välitetään tarvittaessa tieto tietyn lähdön tai kaikkien lähtöjen tietojen poistamisesta Kaikki reaaliaikarajapinnan läpi välitettävät viestit sisältävät lähetysajan sekunnin tarkkuudella Reaaliaikapalvelimen aika ylläpidetään verkosta saatavan aikapalvelun avulla (NTP). Tieto välitetään rajapinnasta läpi niin että PARAS-järjestelmästä saatu muutostieto on välitetty NRT-järjestelmälle kolmen sekunnin kuluessa muutoksen tapahtumisesta. 2.1.3 Julkisen reaaliaikarajapinnan (3) vaatimukset Esittää pyydettäessä ennusteen seuraavien 20 minuutin aikana pysäkille saapuvien reaalibussien saapumisajasta. Saapumisaika on reaaliaikaan perustuva jos mahdollista, muuten se on aikataulunmukainen. Näyttää Reittioppaan käyttäjälle edellisessä kohdassa pyydettyyn ennusteeseen sisältyvien reaalibussien sijainti karttanäytöllä Kartalla esitettävien bussisymbolien yhteydessä esitetään reaalibussin linjatunnus Pysäkkikohtaiset reaalibussien saapumisaikaennusteet esitetään XHTML-sivuna Esittää tiedotteet -rajapinnan (4) kautta tulleet tiedot Reittioppaan käyttäjille Järjestelmä tarjoaa saapumisaikaennusteet kaikille TKL:n pysäkeille Rajapinnasta (2) saatu tieto on käsitelty rajapintaan (3) laitettavaksi kolmen sekunnin kuluessa tiedon vastaanottamisesta. 2.1.4 Rajapinnat (4) Liikennetiedotteen ja (5) MALA-aikataulutiedot Rajapinta (4) Liikennetiedotteet on jo olemassa ja sitä käytetään Olli Kanervan toimittaman speksin mukaisesti. Rajapinnan (5) MALA-aikataulutiedot tietosisällön sopivuutta harkitaan projektin tutkimusvaiheen aikana ja mahdollisesti esitetään TKL:lle parannusehdotuksia kyseistä rajapintaa koskien. 2.2 Toiminnalliset vaatimukset 2.2.1 Lähdön aloitus Aloitettaessa lähdön suoritus, rajapinnasta (2) välitetään saapumisaikaennuste kaikille lähdön reitin virtuaalipysäkeille.
5 (15) 2.2.2 Lähdön suoritus Suoritettaessa lähdön reittiä, rajapinnasta (2) välitetään lähtöä ajavan reaalibussin paikkatietoa. Tarvittaessa rajapinnasta välitetään myös bussin edellä / jäljessä tieto sekä tieto virtuaalipysäkkien ohituksista. 2.2.3 Lähdön lopetus Reaalibussin lopettaessa reitin suorituksen poikkeuksellisesti, rajapinnasta (2) välitetään käsky jolla poistetaan lähdön tiedot. Lähdön suorituksen loputtua päätepysäkille saavuttaessa, rajapinnasta (2) välitetään käsky jolla poistetaan lähdön tiedot. 2.2.4 Toiminta tietoliikenneyhteys katkoksissa Jos reaaliaikapalvelin ei ole saanut reaaliaikatietoa PARAS -reaaliaikakoneilta tiettynä aikana, lähetetään reaaliaikarajapinnan läpi käsky poistaa kaikkien lähtöjen tiedot. Jos reaaliaikarajapinnasta ei ole välitetty tietoa tiettynä aikana, pitää reaaliaikarajapintaa hyödyntävän järjestelmän tyhjentää kaikki reaaliaikarajapinnasta saatu tieto. 2.3 Vaatimusten täyttyminen Projektissa saavutettiin kaikki muut projektisuunnitelmassa asetetut tavoitteet lukuun ottamatta viimeistä kohtaa Kartalla näytetään värikoodeilla, mikäli bussi on edellä tai jäljessä aikatauluaan.. Tämäkin olisi ollut teknisesti mahdollista toteuttaa. TKL:n toivomuksesta ja yhteisesti asiaa käsiteltäessä päätettiin, että toiminto voidaan korvata selkeämmällä toiminnolla: Kartalla olevassa bussisymbolissa esitetään monenko minuutin kuluttua bussin arvioidaan saapuvan pysäkille. Matkustajille oleellisempaa tietoa on milloin bussi lähtee pysäkiltä kuin se että poikkeaako bussin aikataulu suunnitellusta. Lisäksi lähdön lopetusviestin lähettäminen todettiin teknisesti tarpeettomaksi, ja jätettiin siten toetuttamatta. 3 Avoimen reaaliaikarajapinnan toteutusratkaisu Järjestelmän toteutusratkaisua etsittäessä oli periaatteena minimoida olemassa oleviin järjestelmiin ja erityisesti PARAS-järjestelmään tehtävät muutokset. Järjestelmän aikatauluinformaation runkona toimii TKL:n aikataulutietokanta (ns. mala) josta saatavan tiedon sekä Reittiopas että PARAS liittävät omiin tietokantoihinsa. PARAS-järjestelmästä reaaliaikarajapintaan välitettävä informaatio koostuu seuraavista asioista: Autojen reaaliaikainen GPS-perustainen paikkatieto, joka päivitetään 20 sekunnin välein. Vuoron pysäkkikohtaiset saapumisaikaennusteet, joka lähetetään auton kiinnittyessä vuorolle.
6 (15) Auton ajaessa vuoroaan päivitetään autoa koskevat saapumisaikaennusteet tarvittaessa. Auton ohittaessa määritellyn pysäkin poistetaan auton tiedot kyseiseltä pysäkiltä. Auton poistuessa linjalta annetaan poistumisesta ilmoitus. Hankaluuksia tuotti erityisesti autojen tunnisteen määrittäminen siten että rajapinnan molemmissa päissä käsitellään samaa todellista lähtöä. Ratkaisuksi tähän keksittiin muodostaa autolle tunniste päivätyypistä, linjanumerosta, vuoronumerosta ja aikataulunmukaisesta lähtöajasta. 4 Projektin onnistuminen ja riskit Projektin tilaajana toimi Tampereen kaupungin liikennelaitos ja projektille haettiin valtionavustusta AINO-hankkeesta. Projektin vastuualueet oli jaettu seuraavasti: TKL oli vastuussa PARAS-järjestelmästä ja Tampereen kaupungin tietoverkkoon liittyvistä asioista. Insta Visual Solutions Oy oli projektin vetovastuussa sekä vastuussa PARASjärjestelmän rajapinnoista. WM-data Oyj oli vastuussa Reittioppaan rajapinnasta ja käyttöliittymistä. Projektin riskit arvioitiin ennalta seuraavasti: Reaaliaikaisiin rajapintoihin liittyvät tekniset ongelmat esim. vasteaikojen suhteen. - Tämä riski ei toteutunut. Rajapinnasta välitettävä tietomäärä on vain muutamia kymmeniä kilotavuja sekunnissa. Osapuolien sitoutuminen projektiin - Tämä riski ei toteutunut. Kaikki osapuolet olivat mukana viemässä projektia eteenpäin. PARAS-järjestelmän toiminta Tampereen kaupungin tietoverkossa (TIO) - Yhteistyö TIOn kanssa sujui projektin puitteissa mainiosti. PARAS-verkosta Reittioppaaseen avatun putken kanssa ei ollut ongelmia. Sekundaarisia ongelmia sen sijaan tuotti itse PARAS-järjestelmä, joka useistakin eri syistä hidasti reaaliaikaprojektin etenemistä. Projektin tuloksena saatiin aikaiseksi halutut ominaisuudet täyttävä avoin XMLrajapinta ja siihen liittyvä pilottihanke yhdistettynä Reittioppaaseen. Pilottiin on mahdollista tutustua www-osoitteessa: http://hades.tripplanner.fi/trt Järjestelmän koekäyttäjien mielestä kyseinen uusi palvelu on todella mainio ja sen on havaittu toimivan teknisesti hyvin.
7 (15) 5 Julkisen palvelun esittely 5.1 Yleistä 5.2 Paras ajat - palvelu Tässä kappaleessa on esitelty palvelun julkinen puoli matkustajille. Projektin tavoitteena avoimen rajapinnan lisäksi oli internetissä toimiva palvelu karttoineen sekä versio matkapuhelimiin. Lisäksi tavoitteena oli lisätä poikkeustiedotteet reittiopas palveluun. Figure 1 Internet palvelun etusivu. Sivun ulkoasu on yhtenäinen TKL:n muun sivuston kanssa ja lisäksi palvelusta on monipuoliset linkitykset TKL:n aikataulusivustoon. Suunnittelunlähtökohtana oli että käyttäjälle haussa tulee olla vain yksi kenttä, jolloin käyttö on selkeämpää (vrt kokemus Googlesta) ja palvelu ehdottaa eri vaihtoehtoja pyrkien kuitenkin valitsemaan pysäkin heti jos löytyy vain yksi.
8 (15) Figure 2 - Ennusteen hakeminen syötteen avulla. Käyttäjä voi hakea palvelusta pysäkin tunnuksella tai nimellä. Lisäksi järjestelmä sisältää TKL:n reittioppaan kautta kaikki Tampereen osoitteet, joten käyttäjä voi hakea myös osoitteen avulla. Lisäksi käyttäjä voi tallettaa omia pysäkkejä nopeata hakua varten.
9 (15) Figure 3 Käyttäjä voi hakea myös pysäkkiä kartan avulla. Kartalla näytetään pysäkkien nimi ja tunnus. Pysäkki pallot näytetään kahdella tarkimmalla tasolla.
10 (15) Figure 4 - Pysäkkiennusteen näyttäminen. Pysäkkiennusteessa näytettään ennusteaikoja 20 minuutin päähän. Käyttäjä näkee linjat ja kulkuvälineet kartalla. Lisäksi sivulla näytetään linjoihin kohdistuvaa poikkeusinformaatiota. Ennustesivu päivittyy minuutin välein.
11 (15) Figure 5 - Iso kartta. Palvelussa on myös iso kartta mistä voi seurata kokonaistilannetta. Kartalla näytetään reaaliajassa bussien sijainti. Eri linjat esitetään eri väreillä. Reitti perustuu GPS-mittausdataan, joten siinä on pientä värinää kaupunkialueilla talojen aiheuttamista heijastuksista, joka näkyy tarkimmilla karttatasoilla. Kartta päivittyy minuutin välein.
12 (15) Figure 6 Poikkeustiedotteet. Ennusteen yhteydessä näytetään mahdolliset poikkeustiedotteen, ja tiedotteessa on mahdollista lisätä linkki missä on lisää tietoa palvelusta.
13 (15) 5.3 Reittiopas ja poikkeustiedotteet Figure 7 Poikkeustiedotteet näytetään myös reittioppaassa, josta voi siirtyä varsinaiselle tiedotesivulle, missä on tarkemmin kerrottu poikkeuksesta.
14 (15) 5.4 Paras ajat mobiilipalvelu Figure 8 Mobiilipalvelun etusivu, palvelusta on disabloitu kartta ja pyritty saamaan sovitettua pieneen näyttöön. Figure 9 Mobiilipalvelun haun tarkkennus.
15 (15) Figure 10 - Pysäkkiennusteen näyttö mobiilipalvelussa. Figure 11 Pysäkkiennusteen näyttö mobiilipalvelussa. Pysäkit joilla on paljon linjoja ja poikkeusinfoa ovat hieman haastavia, koska pienelle näytölle sovitettavaa dataa on paljon.