{"componentChunkName":"component---src-templates-liity-js","path":"/liity/reittiopas/","result":{"data":{"markdownRemark":{"fields":{"slug":"/liity/reittiopas/"},"frontmatter":{"title":"Reittiopas","panels":[{"title":"Reittiopas","body":"Reittiopas on digitaalinen palvelu, joka helpottaa matkustamista ja liikkumista. Se löytää sopivan reitin lähtö- ja määränpääpaikkojen välillä tiettyyn aikaan huomioiden eri kulkumuodot tarvittaessa. Palvelun käyttäjät voivat valita haluamansa kulkumuodon, kävelymatkan pituuden, nopeuden ja vaihtojen määrän.","links":[],"image":{"publicURL":"/static/d918c978b6c76cd667df2a433078141a/municipality.svg"},"id":"kaupunki","textColor":"#000","swapped":true}]},"html":"

1. Domain nimi

\n

Liikenne Digitransit-palveluun on aina https-salattu. Voit valita vapaasti palvelusi domain-nimen (esim. https://reittiopas.kaupunki.fi), jolloin tarvitsemme TLS-sertifikaatin, joka sinun tulee hankkia. Voit myös käyttää https://kaupunki.digitransit.fi -osoitetta, jolloin erillistä sertifikaattia ei tarvita. Kuvaa/toimita:

\n\n

2. Reittidata

\n

Digitransit-palvelu integroi reittidatasi GTFS-muodossa. Tiedot on mahdollista myös noutaa Waltti-järjestelmästä. Kuvaa:

\n\n

Varmista, että GTFS-paketin data on kunnossa käyttämällä esimerikiksi Googlen GTFS-validaattoria:

\n\n

3. Kulkumuodot

\n

\n \n \n \n \n

\n

Määritä kartalta rajat osoitehaulle. Digitransit-palveluun konfiguroidaan suorakaiteen muotoinen alue, jonka sisältä käyttäjän syöttämiä osoitteita etsitään. Kuvaa:

\n\n

Voit myös määrittää hakualueen monikulmiona. Jotta haussa siirretty tietomäärä pysyisi kompaktina,\nsuositeltu monikulmion pistemäärä on alle 50 pistettä, ja koordinaattien tarkkuus enintään 5 desimaalia.

\n

5. Oletuspaikat

\n

Digitransit-käyttöliittymä yrittää aina paikantaa käyttäjän. Mikäli paikannus ei onnistu, valitaan joissain näkymissä viitepaikaksi määrittelemäsi piste. Kuvaa:

\n\n

6. Teemoitus

\n

Digitransit-käyttöliittymä on muokattavissa logon ja värimaailman osalta. Kuvaa/lähetä:

\n\n

Huom! Värimaailma, logo ja tekstit toteutetaan niiltä osin kuin se on mahdollista. Tämä voi tarkoittaa, ettei toiveitasi pystytä kaikilta osin täyttämään.

\n

7. Linkit

\n

Kuvaa seuraavat linkit:

\n\n

8. Tietoja palvelusta

\n

\n \n \n\n

Esimerkkejä lippuvyöhykkeiden aluedatasta: https://github.com/HSLdevcom/pelias-api/tree/master/middleware/config

\n
    \n
  1. Vyöhykkeiden visualisointi kartalle. Lippuvyöhykkeiden rajaviivat kuvataan linestring/multilinestring geometrioina ilman kaksinkertaista piirtoa alueiden välille.\nVyöhykkeille määritellään vakioitu piirtotyyli: Esimerkki:
    2. \n
\n
    {\n      \"type\" : \"FeatureCollection\",\n       \"name\" : \"Vyöhykkeet\",\n       \"features\" : [{\n            \"type\" : \"Feature\",\n            \"styles\": [\n              { \"color\": \"#666\", \"weight\": 2, \"opacity\": 1 },\n              { \"color\": \"#333\", \"weight\": 12, \"opacity\": 0.2 }\n            ],\n           \"geometry\" : {\n             \"type\" : \"MultiLineString\",\n             \"coordinates\" : [\n                [ [ 21.80091, 63.09565 ],[ 21.80074, 63.1031 ], [ 21.8004, 63.10618 ] ],\n                [ [ 21.81437, 63.11153 ],[ 21.66672, 63.13274 ], [ 21.66158, 63.1356 ], [ 21.66272, 63.13675 ] ],\n                [ [ 21.66158, 63.1356 ], [ 21.66272, 63.13675 ] ]\n             ]\n\t   }\n        }]\n    }
\n

Lisäksi tiedoston pitäisi sisältää kullekin vyöhykkeelle point tai multipoint feature, joissa määritellään vyöhyketunnusten paikat ja symbolien svg grafiikka kartalla. Esimerkki:

\n
   {\n      \"type\": \"Feature\",\n      \"properties\": {\n         \"id\": \"icon-zone-f\",\n         \"svg\": \"<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 36 36'>\n                   <path d='M36 18A18 18 0 1118 0a18 18 0 0118 18' fill='#0ab1c8' fill-rule='evenodd'/>\n                   <path d='M23.21 19h-6.75v7H13V9h11.06v2.8h-7.6v4.4h6.75z' fill='#fff'/>\n                 </svg>\"\n        }\n      },\n      \"geometry\": {\n        \"type\": \"MultiPoint\",\n        \"coordinates\":  [\n          [26.8068, 63.2194], [26.4574,62.97]\n        ]\n      }\n    }
\n

Yllä on F-vyöhykkeelle määritelty 2 tunnusta vyöhykkeen eri osiin. Vakio svg symbolit A, B ... I voi kopioida\nvyöhykedatan esimerkkitiedostosta\nja vaihtaa svg määrittelyhin oman reittioppaan teemavärin. Mikäli tarvitaan jokin muu symboli, sen voi tuottaa itse annetun mallin mukaisesti Roboto-fontilla,\ntai vaihtoehtoisesti pyytää digitransit-kehitystiimiä lisäämään halutut svg elementit.

\n

13. Näin saat päästötietosi mukaan reititykseen

\n

Reittioppaaseen saa mukaan reittiehdotusten CO₂-päästölukemat pyytämällä päästöjen näyttämisen päällekytkennän ja toimittamalla reittien keskimääräiset CO₂-päästöarvot emissions.txt-tiedostossa osana GTFS-pakettia. Tiedosto ei ole GTFS-standardin mukainen vaan sen tulee seurata tässä annettuja ohjeita. Seuraavien sarakkeiden tulisi sisältyä emissions.txt-tiedostoon:

\n\n

Esimerkki emissions.txt:

\n
    route_id,avg_co2_per_vehicle_per_km,avg_passenger_count\n    1001,123,20\n    1002,123.4,20.0\n    1003,0,0
\n

14. Kohteiden näyttäminen reittioppaan kartalla

\n

\n \n \n \n \n

\n

Reittioppaan kartalla voidaan näyttää tarvittaessa kiinnostavia kohteita – esimerkiksi palvelupisteet tai lippuautomaatit. Reittioppaalle toimitetaan tällaisessa tilanteessa linkki olemassaolevaan geoJSON-muotoiseen dataan. Esimerkki datasta:

\n
{\n    \"type\": \"FeatureCollection\",\n    \"features\": [\n        {\n            \"type\": \"Feature\",\n            \"id\": \"1\",\n            \"geometry\": {\n                \"type\": \"Point\",\n                \"coordinates\": [\n                    21.26673,\n                    61.44984\n                ]\n            },\n            \"properties\": {\n                \"category\": \"SERVICE_POINT\",\n                \"name\": \"Nimi\",\n                \"name_fi\": \"Nimi\",\n                \"name_sv\": \"Namn\",\n                \"name_en\": \"Name\",\n                \"popup\": \"<div class=\\\"card-header-wrapper\\\">\\n <span class=\\\"h4\\\"> Nimi<\\/span>\\n <div class=\\\"card-sub-header\\\">Katu 1<\\/div>\\n<\\/div>\\n\",\n                \"text\": \" Nimi\\nKatu 1, 00100\",\n                \"city\": \"Kaupunki\",\n                \"city_fi\": \"Kaupunki\",\n                \"city_sv\": \"Stad\",\n                \"address\": \"Katu 1\",\n                \"address_fi\": \"Katu 1\",\n                \"address_sv\": \"Gata 1\",\n                \"icon\": {\n                    \"id\": \"icon_service_point\",\n                    \"svg\": \"<svg xmlns=\\\"http:\\/\\/www.w3.org\\/2000\\/svg\\\"\\n     xmlns:xlink=\\\"http:\\/\\/www.w3.org\\/1999\\/xlink\\\"\\n     width=\\\"256\\\" height=\\\"256\\\" ... svg>\\n\"\n                }\n            }\n        },\n    ]\n}
\n

Datan osalta tulisi huomioida seuraavat asiat:

\n\n

Ensimmäinen palvelupiste:

\n
”icon”: {\n  “id“: “service-point“,\n  “svg“: “<svg … data kokonaisuudessaan … >“\n}
\n

Muilla palvelupisteillä vain viitataan jo kerran annettuun dataan:

\n
”icon”: {\n  “id“: “service-point“\n}
\n
\n

Response-header esimerkki:

\n
Access-Control-Allow-Origin:\t*\nContent-Type:\tapplication/json
","excerpt":"1. Domain nimi Liikenne Digitransit-palveluun on aina https-salattu. Voit valita vapaasti palvelusi domain-nimen (esim. https://reittiopas.kaupunki.fi), jolloin tarvitsemme TLS-sertifikaatin, joka…"}},"pageContext":{"slug":"/liity/reittiopas/"}},"staticQueryHashes":["3675773199","4050193485"]}