{"componentChunkName":"component---src-templates-page-js","path":"/palvelu/","result":{"data":{"markdownRemark":{"fields":{"slug":"/palvelu/"},"frontmatter":{"title":"Palvelut","isFront":null,"panels":[]},"html":"

Digitransit-palvelut

\n

Digitransit-palvelukokonaisuuden tärkeimmät osat ovat:

\n
    \n
  1. Reititysmoottori
    2. \n
  2. Osoitehaku
    3. \n
  3. Taustakartat
    4. \n
  4. Reittiopas-käyttöliittymä
    5. \n
\n

Ensimmäiset kolme yllämainituista palveluista tarvitsevat lähdeaineiston, jonka tuottamiseksi palvelualustalle on rakennettu vastaavat datalatausprosessit.

\n

GTFS- ja karttadatalla varustettu reititysmoottori OpenTripPlanner tarjoaa joukon matkasuunnitteluun liittyviä toimintoja,\nkuten multimodaalinen ovelta ovelle reititys, pysäkki- ja linjahaut.

\n

Pelias-osoitehakumoottorin avulla voidaan etsiä syötetyn merkkijonon paikkakoordinaatit, tai kysyä mikä paikka tai osoite on lähinnä annettua koordinaattia.

\n

Taustakarttapalvelu tarjoaa karttatietoa rasteri- ja vektoritiilinä.

\n

Reittiopas-käyttöliittymäpalvelu tarjoaa selainpohjaisen käyttöliittymän, jonka avulla alustan muita palveluja voidaan hyödyntää mm. tekemällä reittihakuja.

\n

Näiden lisäksi Digitransit sisältää joukon erilaisia reaaliaikaa ja oheistietoa tarjoavia palveluja, jotka eivät ole välttämättömiä\nreitityspalvelun käyttöönoton kannalta. Tarkempi kuvaus osapalveluista löytyy kehittäjädokumentaatiosta.

\n

Palveluiden käynnistys omassa ylläpidossa

\n

Kaikki Digitransit-osapalvelut on pakattu valmiiksi Docker-konteiksi, joita pystyy varsin helposti ajamaan omalla palvelinalustalla.\nKonttien toimintaa pystyy myös jossain määrin ohjaamaan ympäristömuuttujien avulla.

\n

Helpoin ratkaisu on käyttää Digitransitin tuottamaa lähdedataa (OpenTripPlanner ja Pelias data kontit sekä hsl-map-server),\njolloin raskaita datalatausprosesseja ei tarvitse rakentaa. Rajoituksena on toki tällöin se, että tarjotun datan sisältö on sama kuin Digitransitissa.\nReititys ei onnistu kaupungissa, jonka GTFS dataa ei tunneta Digitransit-alustalla, eikä osoitehaku löydä kohteita Suomen rajojen ulkopuolelta.

\n

Mikäli oma data on tarpeen jossakin osapalvelussa, Digitransitin datalatausprosessi on tarpeen kopioida ja muokata halutuksi.\nJoiltakin osin tämä onnistu pelkillä ympäristömuuttujilla (esimerkiksi OpenTripPlanner datalataukseen voi lisätä uusia datalähteitä),\nmutta yleisessä tapauksessa on tarpeen tehdä oma versio github/hsldevcom lähdekoodikirjastoista ja muokata niitä, tai rakentaa oma datapalvelu.

\n

OpenTripPlanner-reitiyksen datalatauskonfiguraatio on varsin helppo muokata käyttämään omaa dataa. Konfiguraatiossa luetellaan verkko-osoitteet,\njoista GTFS datapaketit haetaan, sekä OSM karttadatatiedostojen hakuosoite. Osoitelistan voi vaihtaa halutuksi.

\n

Osoitehaun lähdeaineisto on määritelty joukolla skriptejä, jotka noutavat ja prosessoivat aineistopaketteja.\nNäitäkin on varsin helppo lisätä, poistaa ja muuttaa. Yksittäisen aineiston indeksointi osoitetietokantaan tehdään räätälöidyllä\njavascript-kirjastolla, esimerkiksi https://github.com/hsldevcom/pelias-gtfs. Datalatausjärjestelmään on sisäänrakennetty\nhallinnollisen hierarkian lisääminen kohteisiin käyttämällä WhosOnFirst-palvelusta haettua Suomen aluejakoa. Tämä menetelmä pitää\nkorvata tai datasisältö vaihtaa Suomen rajojen ulkopuolella.

\n

Taustakarttojen datalataus on vahvasti sidoksissa HSL:n tarjoamiin karttapalveluihin. Korvaava karttapalvelu on mahdollista luoda\nkehittäjädokumenttien ohjeiden mukaisesti.

\n

On myös mahdollista ylläpitää vain osaa palveluista ja käyttää muilta osin Digitransitin rajapintoja; uusi Suomessa toimiva paikallinen reittiopas\nvoi helposti hyödyntää koko maan kattavaa osoitehakua.

\n

Esimerkki oman reittiopaspalvelun käynnistämisestä hsl-reittioppaan datalla:

\n
    \n
  1. Asenna Docker palvelimelle
    2. \n
  2. Käynnistä reititysmoottori:
    3. \n
\n
docker run -d --rm  -p 9080:8080 -e ROUTER_NAME=hsl -e JAVA_OPTS=-Xmx4g -e ROUTER_DATA_CONTAINER_URL=https://api.digitransit.fi/routing-data/v2/hsl hsldevcom/opentripplanner:prod
\n

Nyt reititystä palvellaan osoitteessa localhost:9080.

\n
    \n
  1. Käynnistä osoitedatan tietokantapalvelu:
    2. \n
\n
docker run -d --rm --name pelias-data-container hsldevcom/pelias-data-container
\n
    \n
  1. Käynnistä osoitehakupalvelu:
    2. \n
\n
docker run -d --rm --name pelias-api -p 3100:8080 --link pelias-data-container:pelias-data-container hsldevcom/pelias-api
\n

Osoitehakua palvellaan osoitteessa localhost:3100. Avaa selain ja testaa haku: https://localhost:3100/v1/search?text=Helsinki

\n
    \n
  1. Käynnistä käyttöliittymäpalvelu:
    2. \n
\n
docker run -d --rm  -p 8080:8080 -e OTP_URL=http://localhost:9080/otp/ -e CONFIG=hsl -e GEOCODING_BASE_URL=localhost:3100/v1 hsldevcom/digitransit-ui
\n

Nyt voit selata osoitteeseen localhost:8080 ja alkaa käyttämään omaa yksityistä reittopaspalvelua, jonka taustakartat tulevat Digitransitista.

\n

Käyttöliittymän teemoitus

\n

Reittioppaan oletusteema ei sisällä kaupunkikohtaisia piirteitä. Se on konfiguroitu koko Suomen datalle soveltuvilla asetuksilla.

\n

Käyttöliittymä voidaan teemoittaa ja konfiguroida sopivaksi halutulle kohdealueelle luomalla uusi konfiguraatiotiedosto lähdekoodikirjaston\nhttps://github.com/HSLdevcom/digitransit-ui app/configurations kansioon. Tarkemmat ohjeet löytyvät osoitteesta\nhttps://github.com/HSLdevcom/digitransit-ui/blob/master/docs/Themes.md .

\n

Resurssitarpeet

\n

Esimerkkejä:

\n\n

Näillä resursseilla pystyy palvelemaan useita samanaikaisia käyttäjiä lähes viiveettä. Kuorman kasvaessa on tarpeen ottaa käyttöön kuormantasausratkaisuja,\njoilla kyselyt saadaan hajautettua usealle palvelimelle. Esimerkki: Digitransit palvelee Helsingin alueen väestöä runsaalla 20:llä\nreititysmoottori-instanssilla.

\n

Palvelukuormaa on mahdollista alentaa ja palvelun vasteaikaa parantaa erilaisilla välimuistiratkaisuilla (CDN, proxy caching).\nErityisesti taustakarttapalvelu hyötyy näistä.

\n

Palveluiden alueelliset ominaispiirteet

\n

Digitransitin käyttämä versio OpenTripPlanner-reititysmoottorista on varsin geneerinen, eikä sisällä merkittäviä pelkästään Suomea koskevia muutoksia.\nJoitakin erityispiirteitä, kuten paikallinen lippuhintalaskenta, voidaan aktivoida konfiguraation avulla.

\n

Pelias-osoitehakua on kehitetty tukemaan monikielisiä hakuja ja skandinaavista merkistöä. Maakohtaiset erityispiirteet\non määritetty konfiguraatiotiedostossa.

\n

Linkkejä lähdekoodikirjastoihin

\n","excerpt":"Digitransit-palvelut Digitransit-palvelukokonaisuuden tärkeimmät osat ovat: Reititysmoottori Osoitehaku Taustakartat Reittiopas-käyttöliittymä Ensimmäiset kolme yllämainituista palveluista tarvitsevat…"}},"pageContext":{"slug":"/palvelu/"}},"staticQueryHashes":["3675773199","4050193485"]}