LYHYT VASTAUS
Jos näytöllä näkyy muutakin kuin lähdöt, helpointa on käyttää sisällönhallintaa, jossa on valmis aikatauluosio. Jos näytöllä näkyvät pelkät lähdöt, riittää usein julkinen pysäkkinäyttö selaimessa. Oma toteutus Digitransit-rajapinnalla kannattaa vain, kun tarvitset erityisen näkymän.
Rajapinnan käytöstä ei peritä maksua, mutta se vaatii API-avaimen. Sama tieto on saatavilla myös Waltti-alueilta ja muualta Suomesta.
Kolme tapaa verrattuna
| 1. Sisällönhallinta | 2. Pysäkkinäyttö selaimessa | 3. Oma toteutus | |
|---|---|---|---|
| Sopii, kun | Näytöllä on myös hakemisto, tiedotteita tai säätä | Näytöllä on vain lähtöjä | Tarvitset oman ulkoasun tai erikoisnäkymän |
| Käyttöönotto | Toimittaja määrittää pysäkit | Luot näkymän ja avaat linkin näytöllä | Kehitystyö, API-avain ja palvelin |
| Ylläpito | Palvelun toimittaja | Sinä tai näytön ylläpitäjä | Sinä tai kehittäjä |
| Ulkoasu | Sovitetaan muuhun sisältöön | Pysäkkinäytön oma ulkoasu | Vapaa |
| Vaatii näytöltä | Yhteensopivan soittimen | Selaimen tai soittimen, jossa linkki pysyy auki | Selaimen tai oman sovelluksen |
1. Valmis sisällönhallinta
Tämä on tavallisin tapa kiinteistöissä, koska aikataulut ovat vain yksi osa näytön sisältöä. Pysäkit valitaan kerran, ja lähdöt päivittyvät sen jälkeen automaattisesti yrityshakemiston, tiedotteiden tai sään rinnalla.
Omassa DCS-ohjelmistossamme joukkoliikenteen lähdöt näkyvät lähimmiltä pysäkeiltä reaaliajassa koko Suomessa, ja näkymä räätälöidään kohteen mukaan. Kun tilaat aulanäytön meiltä, hoidamme myös määrityksen.
2. Julkinen pysäkkinäyttö
HSL:n, Fintrafficin ja Waltti Solutionsin Digitransit-alustaan kuuluu pysäkkinäyttösovellus (Digitransit Stop Display). Siinä valitaan yksi tai useampi pysäkki, ja sovellus luo linkin näkymään. Näkymä voi vaihtua usean näkymän välillä, ja se voi näyttää myös pysäkkien häiriötiedotteet.
- Tarkista pysäkkinäytön nykyiset käyttöehdot ja se, onko linkki pysyvä. Sovelluksen dokumentaation mukaan kirjautumattoman käyttäjän linkki ei päivity muutosten mukana, vaan muutoksesta tehdään uusi linkki.
- Testaa, että näyttö palaa samaan näkymään sähkökatkon jälkeen ja ettei selain kysy mitään käynnistyessä.
- Tarkista etukäteen, sopiiko pysäkkinäytön ulkoasu aulaan, koska sitä ei voi vapaasti muuttaa.
3. Oma toteutus Digitransit-rajapinnalla
Digitransitin reititysrajapinta (GraphQL) kertoo pysäkkien lähdöt. Se yhdistää aikataulut ja reaaliaikaiset ennusteet. Oma toteutus antaa vapaat kädet, mutta sen ylläpito jää toteuttajalle.
| Asia | Mitä se tarkoittaa |
|---|---|
| API-avain | Rekisteröidy Digitransitin API-portaalissa ja tilaa rajapinta. Ilman avainta rajapinta vastaa virheellä 401. |
| Avaimen suojaus | Älä jätä avainta aulassa näkyvän sivun koodiin. Hae tiedot mieluiten oman palvelimen kautta. |
| Hinta | Digitransit ei peri liittymisestä tai käytöstä maksua. Kustannus syntyy kehitystyöstä ja ylläpidosta. |
| Lisenssi | CC BY 4.0, eli Digitransit on mainittava lähteenä. |
| Kuormitus | Vältä yli 10 pyyntöä sekunnissa. Aulanäytölle riittää reilusti harvempi päivitys. |
| Muutokset | Rajapinta voi muuttua. Joku on nimettävä seuraamaan muutoksia. |
Muu Suomi
Digitransitilla on omat rajapinnat HSL-alueelle, Waltti-alueille ja koko Suomelle ja Virolle. Jos kaupunki kuuluu Walttiin, kuten esimerkiksi Tampere ja Oulu, oikea rajapinta on yleensä Waltti. Aikataulut löytyvät laajasti, mutta reaaliaikaisen tiedon kattavuus riippuu alueen tuottamasta aineistosta. Se kannattaa tarkistaa pysäkkikohtaisesti.
Mitä näytölle kannattaa näyttää
- Vain tarvittavat pysäkit: yleensä lähimmät pysäkit, joille ehtii kävellen. Kuvaile suunta selkeästi, esimerkiksi ”Keskustaan”.
- Muutama seuraava lähtö: pitkä lista on vaikealukuinen, joten näytä esimerkiksi 4–8 lähtöä.
- Kävelymatka huomioon: lähtö, johon ei enää ehdi, kannattaa jättää pois.
- Iso teksti: linjanumero ja minuutit pitää nähdä sieltä, mistä aulaan kävellään.
- Häiriöt: näytä poikkeustiedotteet, jos ne ovat saatavilla, ja varaudu tiedon katkeamiseen.
Näytön koko ja sijoitus mitoitetaan katseluetäisyyden mukaan. Ohjeet löytyvät oppaasta Aulanäytön valinta.
Lähteet
- Digitransit: rajapintojen dokumentaatio, API-rekisteröinti ja käyttöehdot (digitransit.fi; lähdekoodi ja dokumentaatio GitHubissa HSLdevcom/digitransit-site), tarkistettu 1.11.2026.
- Digitransit Stop Display: sovelluksen dokumentaatio (GitHub, HSLdevcom/digitransit-virtualmonitor), tarkistettu 1.11.2026.