# Liikenteen ja tietojen sanasto.

Yksinkertaiset määritelmät liikenteen, lähipalveluiden ja niitä sovelluksiisi yhdistävien työkalujen ymmärtämiseksi.

Source: https://www.roote.ai/fi/liikenne-sanasto/
Language: fi
Author: ROOTE

## Pyöränvuokraus

Palvelu, jossa voi lainata polkupyörän tilapäiseen käyttöön operaattorin ehtojen mukaan. Toimii asemien kautta tai asemattomilla ajoneuvoilla.

Esimerkki : Näet pyörän ja käytät siihen liittyvää vuokrauspalvelua.

Syvenny oppaassa : [Miten löytää lähiseudun jakopyörä?](https://www.roote.ai/fi/guides/miten-loydaan-lahiseudun-jakopyora-roote/)

## Jaettu liikkuminen

Palvelut, jotka tarjoavat ajoneuvoja useiden käyttäjien peräkkäiseen käyttöön, eivätkä yksittäisille omistajille varattuja ajoneuvoja.

Esimerkki : Pyöriä ja sähköpotkulautoja vuokrattavana kaupungissa.

Syvenny oppaassa : [Miten löytää lähiseudun jakopyörä?](https://www.roote.ai/fi/guides/miten-loydaan-lahiseudun-jakopyora-roote/)

## Teline

Asemaan asennettu kiinnityspiste polkupyörälle. Telineen läsnäolo ei takaa, että pyörän voi palauttaa sillä hetkellä.

Esimerkki : Palautuspaikan on oltava käytettävissä ja toimiva.

Syvenny oppaassa : [Tyhjä tai täynnä oleva pyöräasema: mitä tehdä?](https://www.roote.ai/fi/guides/tyhja-tai-taynnakoinen-pyora-asema-mita-tehda/)

## Pyöräasema

Järjestetty paikka yhteispyörien ottamiseen tai palauttamiseen. Koordinaatit, kapasiteetti ja saatavuus kuvaavat erilaisia aseman ominaisuuksia.

Esimerkki : Asema voi näkyä kartalla, mutta olla hetkellisesti tyhjä.

Syvenny oppaassa : [Tyhjä tai täynnä oleva pyöräasema: mitä tehdä?](https://www.roote.ai/fi/guides/tyhja-tai-taynnakoinen-pyora-asema-mita-tehda/)

## Asematon — vapaa sijoitus

Järjestelmä, jossa ajoneuvoja ei tarvitse ottaa tai palauttaa kiinteisiin telineisiin. Pysäköintialueet ja säännöt ovat palvelun mukaiset.

Esimerkki : Sähköpotkulauta pitää palauttaa sallittuun alueeseen.

Syvenny oppaassa : [Pyörä asemalla tai ilman asemaa: mitä eroja?](https://www.roote.ai/fi/guides/pyora-asemalla-tai-ilman-asemaa-mita-erot/)

## Saatavuus

Tila tai määrä, joka kertoo, mitä voi käyttää tunnetun tiedon mukaan. Havaittu saatavuus voi muuttua eikä se ole varaus.

Esimerkki : Kolme pyörää asemalla ei tarkoita, että ne kaikki on varattu.

Syvenny oppaassa : [Pyörien saatavuus reaaliajassa: miten näyttää se sovelluksessa?](https://www.roote.ai/fi/guides/pyorien-saatavuutta-reaaliajassa-sovelluksessa/)

## Ajoneuvon nouto

Toiminto, jossa aloitetaan ajoneuvon käyttö. Positiivinen laskurin arvo ei riitä, jos palvelu ilmoittaa, että nouto on estetty.

Esimerkki : Pyöriä on asemalla, mutta palvelu ei välttämättä salli vuokrausta.

Syvenny oppaassa : [Pyörien saatavuus reaaliajassa: miten näyttää se sovelluksessa?](https://www.roote.ai/fi/guides/pyorien-saatavuutta-reaaliajassa-sovelluksessa/)

## Palautus

Ajoneuvon käytön lopetus palvelun sääntöjen mukaisesti. Palautuspaikat voivat poiketa noutopaikoista.

Esimerkki : Asema sallii noudon, mutta palautuspaikkoja ei ole vapaana.

Syvenny oppaassa : [Tyhjä tai täynnä oleva pyöräasema: mitä tehdä?](https://www.roote.ai/fi/guides/tyhja-tai-taynnakoinen-pyora-asema-mita-tehda/)

## Sähköavusteinen polkupyörä

Polkupyörä, jossa moottori avustaa polkemista ominaisuuksien mukaan. Liikennetiedoissa voimanlähde ja akku voidaan ilmoittaa erikseen.

Esimerkki : Asema voi eritellä mekaaniset ja sähköpyörät.

Syvenny oppaassa : [Pyörien saatavuus reaaliajassa: miten näyttää se sovelluksessa?](https://www.roote.ai/fi/guides/pyorien-saatavuutta-reaaliajassa-sovelluksessa/)

## Kombinoitu liikkuminen

Useamman kulkutavan peräkkäinen käyttö samassa matkassa. Jokaisella etapilla on oma aikataulu, pääsy ja ehdot.

Esimerkki : Poljet raitiovaunulle ja jatkat sitten kävellen.

Syvenny oppaassa : [Kuinka yhdistää pyörä ja joukkoliikenne arjessa?](https://www.roote.ai/fi/guides/kuinka-yhdistaa-pyora-ja-joukkoliikenne-arkipaivassa/)

## Pysäkki

Paikka, jossa liikennepalvelu ottaa tai jättää matkustajia. Avoin pysäkki ei automaattisesti kerro tulevista lähdöistä.

Esimerkki : Linja-autopysäkki ilman lähtöaikataulua.

Syvenny oppaassa : [Kuinka löytää lähin linja-auto- tai raitiovaunupysäkki?](https://www.roote.ai/fi/guides/mista-lyhin-linja-auto-tai-raitiovaunu-pysaakki-loytyy/)

## Laituri

Matkustajien nousemis- tai poistumiskohta kulkuneuvosta. Viereiset laiturit voivat palvella eri reittejä tai suuntia.

Esimerkki : Linjalla eri suuntien vuorot voivat käyttää erillisiä laitureita.

Syvenny oppaassa : [Kuinka löytää oikea bussipysäkki ja suunta?](https://www.roote.ai/fi/guides/kuinka-loyt%C3%A4%C3%A4-oikea-linjan-pysakki-ja-suuntainen-bussi/)

## Linja

Liikennepalvelu verkossa, jolla on yksi tai useampi reitti tai variantti. Linjan nimi ei yksin kerro kulkusuuntaa.

Esimerkki : Linjalla voi olla useita päätepysäkkejä.

Syvenny oppaassa : [Kuinka löytää oikea bussipysäkki ja suunta?](https://www.roote.ai/fi/guides/kuinka-loyt%C3%A4%C3%A4-oikea-linjan-pysakki-ja-suuntainen-bussi/)

## Vuoro

Liikennepalvelun toteutus yhdellä reitillä ja aikataulussa. GTFS:ssä vuoro liitetty linjaan ja palvelukalenteriin.

Esimerkki : Kaksi peräkkäistä lähtöä samalta linjalta ovat kaksi vuoroa.

Syvenny oppaassa : [GTFS, GTFS-RT ja GBFS: mitkä ovat erot?](https://www.roote.ai/fi/guides/gtfs-gtfsrt-ja-gbfs-mika-erot/)

## Suunta

Palvelun kulkusuunta tai kohde. Tarkistettava reitin ja nousupaikan mukaan.

Esimerkki : Haet raitiovaunua omalle matkakohteelle, ei vastakkaiseen suuntaan.

Syvenny oppaassa : [Kuinka löytää oikea bussipysäkki ja suunta?](https://www.roote.ai/fi/guides/kuinka-loyt%C3%A4%C3%A4-oikea-linjan-pysakki-ja-suuntainen-bussi/)

## Pääteasema

Kuljetuksen reitin loppupiste. Linjalla voi olla eri variantteja, joiden päätepisteet eroavat.

Esimerkki : Lyhyt vuoro päättyy ennen tavallista pääteasemaa.

Syvenny oppaassa : [Kuinka löytää oikea bussipysäkki ja suunta?](https://www.roote.ai/fi/guides/kuinka-loyt%C3%A4%C3%A4-oikea-linjan-pysakki-ja-suuntainen-bussi/)

## Vaihto

Palvelun tai kulkumuodon vaihto matkalla. Kaksi pysäkkiä lähekkäin ei takaa onnistunutta vaihtoa.

Esimerkki : Vaihtoon kuuluu siirtyminen laiturilta toiselle ja odotus.

Syvenny oppaassa : [Kuinka lukea bussin, raitiovaunun tai metron karttaa?](https://www.roote.ai/fi/guides/kuinka-lukea-bussin-ratikka-tai-metro-karttaa/)

## Aikataulun mukainen aika

Palvelusuunnitelman mukainen aika tietylle päivälle ja vuorolle. Ei välttämättä kerro ajoneuvon nykytilaa.

Esimerkki : Lähtö on merkitty kello 8:10 kalenteriin.

Syvenny oppaassa : [Bussien aikataulut: mikä ero on teoreettisilla ja reaaliaikaisilla aikatauluilla?](https://www.roote.ai/fi/guides/bussien-aikataulut-teoreettiset-vai-realiaikaiset/)

## Arvioitu aika

Tulevan vuoron arvio laskettuna saatavilla olevan tiedon pohjalta. Muuttuu tietojen päivittyessä.

Esimerkki : Alun perin klo 8:10 odotettu vuoro arvioidaan nyt klo 8:14.

Syvenny oppaassa : [Bussien aikataulut: mikä ero on teoreettisilla ja reaaliaikaisilla aikatauluilla?](https://www.roote.ai/fi/guides/bussien-aikataulut-teoreettiset-vai-realiaikaiset/)

## Seuraava lähtö

Tuleva lähtö tai vuoro tietystä paikasta. Pysäkin haku ei ole sama kuin lähetysten haku.

Esimerkki : Pysäkit ja lähdöt ovat eri hakutuloksia.

Syvenny oppaassa : [Kuinka etsiä lähellä olevia liikennepysäkkejä API-rajapinnalla?](https://www.roote.ai/fi/guides/kuinka-etsi%C3%A4-l%C3%A4hell%C3%A4-olevia-liikennepys%C3%A4kkej%C3%A4-api-rajapinnan-avulla/)

## Häiriö

Tapahtuma, joka vaikuttaa liikennepalveluun, kuten keskeytys tai reittimuutos. Vaikutusalue ja voimassaoloaika on ilmoitettava.

Esimerkki : Hälytys voi koskea linjaa vain tietyllä aikavälillä.

Syvenny oppaassa : [Kuinka luoda avustaja, joka löytää liikkumismahdollisuuksia osoitteen ympäriltä?](https://www.roote.ai/fi/guides/kuinka-luoda-liikkumisavustaja-osoitteen-ymparille/)

## Palvelukalenteri

Tieto siitä, millä päivillä palvelu toimii, mahdollisine poikkeuksineen. Aikataulu tulkittava kalenterin mukaan.

Esimerkki : Arkisin oleva vuoro ei välttämättä kulje sunnuntaina.

Syvenny oppaassa : [GTFS, GTFS-RT ja GBFS: mitkä ovat erot?](https://www.roote.ai/fi/guides/gtfs-gtfsrt-ja-gbfs-mika-erot/)

## Kaupunkipalvelu

Lähialueen palvelu tai varustus, kuten WC, vesipiste tai latauspiste. Tietoja voi puuttua.

Esimerkki : Lähipalvelutulos sisältää tunnetut tiedot palvelusta.

Syvenny oppaassa : [Kuinka etsiä lähellä olevia liikennepysäkkejä API-rajapinnalla?](https://www.roote.ai/fi/guides/kuinka-etsi%C3%A4-l%C3%A4hell%C3%A4-olevia-liikennepys%C3%A4kkej%C3%A4-api-rajapinnan-avulla/)

## Julkiset WC:t

Yleisölle tarkoitetut WC:t paikallisin ehdoin. Tieto niiden maksuttomuudesta, avoimuudesta tai saavutettavuudesta ei ole taattu.

Esimerkki : Tarkista erikseen olosuhdetiedot ennen siirtymistä.

Syvenny oppaassa : [Miten löytää maksuttomat julkiset WC-tilat läheltäsi?](https://www.roote.ai/fi/guides/miten-loydaan-lahimmassa-olevat-maksuttomat-julkiset-wc-tilat/)

## Saavutettavuus

Paikan tai palvelun käyttömahdollisuudet käyttäjän tarpeiden mukaan. Tuntematon tieto ei tarkoita eikä poissulje saavutettavuutta.

Esimerkki : Pyörätuolikelpoisuus voi olla tiedossa tai tuntematon.

Syvenny oppaassa : [Saavutettavat julkiset wc-tilat: mitä tarkistaa ennen liikkumista?](https://www.roote.ai/fi/guides/saavutettavat-julkiset-wc-tilat-mita-tarkistaa-ennen-liikkumista/)

## Liikuntarajoitteinen (LPR)

Henkilö, jolla on liikkumisen vaikeuksia pysyvästi tai väliaikaisesti. LPR-merkintä ei yksin kuvaa kaikkia tarvittavia pääsyjä tai varusteita.

Esimerkki : Kynnysramppi ei kerro koko mahdollisista esteistä.

Syvenny oppaassa : [Saavutettavat julkiset wc-tilat: mitä tarkistaa ennen liikkumista?](https://www.roote.ai/fi/guides/saavutettavat-julkiset-wc-tilat-mita-tarkistaa-ennen-liikkumista/)

## Aukioloajat

Ajanjaksot, jolloin paikka ilmoittaa olevansa avoinna. Ei aina tarkoita reaaliaikaista toiminnassaoloa.

Esimerkki : Tilapäinen sulku ei välttämättä näy normaalissa aukioloajassa.

Syvenny oppaassa : [Miten löytää maksuttomat julkiset WC-tilat läheltäsi?](https://www.roote.ai/fi/guides/miten-loydaan-lahimmassa-olevat-maksuttomat-julkiset-wc-tilat/)

## Juomavesi

Ihmiskäyttöön soveltuva vesi. Vesipiste tai suihkulähde ei ole automaattisesti juomakelpoista ilman selkeää tietoa.

Esimerkki : Varustetyyppi ja ominaisuudet on erotettava.

Syvenny oppaassa : [Kuinka etsiä lähellä olevia liikennepysäkkejä API-rajapinnalla?](https://www.roote.ai/fi/guides/kuinka-etsi%C3%A4-l%C3%A4hell%C3%A4-olevia-liikennepys%C3%A4kkej%C3%A4-api-rajapinnan-avulla/)

## Latauspiste

Laitteisto ajoneuvon lataukseen sopivalle. Sijainti ei takaa saatavuutta tai liittimen yhteensopivuutta.

Esimerkki : Latauspaikka ja sen käyttötiedot ovat erillisiä tietoja.

Syvenny oppaassa : [Kuinka etsiä lähellä olevia liikennepysäkkejä API-rajapinnalla?](https://www.roote.ai/fi/guides/kuinka-etsi%C3%A4-l%C3%A4hell%C3%A4-olevia-liikennepys%C3%A4kkej%C3%A4-api-rajapinnan-avulla/)

## Palvelutyyppi

Kategoria kaupunkipalvelun valintaan tai kuvaamiseen. Käytettävät arvot riippuvat rajapinnasta ja sen skeemasta.

Esimerkki : ROOTE Palvelut API:ssa käytetään types=toilets WC:lle.

Syvenny oppaassa : [Kuinka etsiä lähellä olevia liikennepysäkkejä API-rajapinnalla?](https://www.roote.ai/fi/guides/kuinka-etsi%C3%A4-l%C3%A4hell%C3%A4-olevia-liikennepys%C3%A4kkej%C3%A4-api-rajapinnan-avulla/)

## Sijainti

Sijainnin määrittäminen laitteella tai sovelluksella. Riippuu luvista ja tarkkuudesta.

Esimerkki : Sijaintipainike pyytää selaimen luvan.

Syvenny oppaassa : [Miten integroida mobiilikartta sivustolle?](https://www.roote.ai/fi/guides/mobiilisuunnitelma-sivulle/)

## GPS-koordinaatit

Arvot, jotka kuvaavat maantieteellistä pistettä, yleensä leveys- ja pituusasteina. Järjestys tulee määrittää rajapinnassa.

Esimerkki : Lähihaussa annetaan kaksi erillistä koordinaattia.

Syvenny oppaassa : [Kuinka etsiä lähellä olevia liikennepysäkkejä API-rajapinnalla?](https://www.roote.ai/fi/guides/kuinka-etsi%C3%A4-l%C3%A4hell%C3%A4-olevia-liikennepys%C3%A4kkej%C3%A4-api-rajapinnan-avulla/)

## Leveyspiiri

Koordinaatti pohjois-etelä-sijainnille päiväntasaajaan nähden, asteina ROOTE-esimerkeissä. Arvot välillä −90…90.

Esimerkki : Hakupisteen leveysaste lähetetään lat-parametrilla.

Syvenny oppaassa : [Kuinka etsiä lähellä olevia liikennepysäkkejä API-rajapinnalla?](https://www.roote.ai/fi/guides/kuinka-etsi%C3%A4-l%C3%A4hell%C3%A4-olevia-liikennepys%C3%A4kkej%C3%A4-api-rajapinnan-avulla/)

## Pituuspiiri

Koordinaatti itä-länsi-sijainnille nolla-meridiaaniin nähden. ROOTE-esimerkit asteina −180…180.

Esimerkki : Pituusaste voi olla lon tai dokumentoidussa aliaksessa lng.

Syvenny oppaassa : [Kuinka etsiä lähellä olevia liikennepysäkkejä API-rajapinnalla?](https://www.roote.ai/fi/guides/kuinka-etsi%C3%A4-l%C3%A4hell%C3%A4-olevia-liikennepys%C3%A4kkej%C3%A4-api-rajapinnan-avulla/)

## Geokoodaus

Haku, joka muuttaa osoitteen tai maantieteellisen lauseen koordinaattiehdokkaiksi. Saman syötteen voi vastata useita paikkoja.

Esimerkki : Kahdella kaupungilla voi olla kadut samalla nimellä.

Syvenny oppaassa : [Kuinka luoda avustaja, joka löytää liikkumismahdollisuuksia osoitteen ympäriltä?](https://www.roote.ai/fi/guides/kuinka-luoda-liikkumisavustaja-osoitteen-ymparille/)

## Käänteinen geokoodaus

Paikan tai nimen haku koordinaattien perusteella. Tulos voi kuvata läheistä aluetta eikä tarkkaa osoitetta.

Esimerkki : GPS-piste yhdistetään luettavaan osoitetekstiin.

Syvenny oppaassa : [Mikä on MCP-palvelin ja mihin sitä käytetään?](https://www.roote.ai/fi/guides/mcp-palvelin-mika-se-on-ja-mihin-sita-kaytetaan/)

## Kiinnostuspiste (POI)

Tunnistettava hyödyllinen paikka, kuten yritys tai palvelupiste. POI eroaa pelkästä postiosoitteesta.

Esimerkki : Hotellin nimi haetaan kohteena yrityksenä.

Syvenny oppaassa : [Kuinka luoda avustaja, joka löytää liikkumismahdollisuuksia osoitteen ympäriltä?](https://www.roote.ai/fi/guides/kuinka-luoda-liikkumisavustaja-osoitteen-ymparille/)

## Hakukohde

Keskeinen piste, josta lähialuehaku ja etäisyydet lasketaan. Eri sijainti kuin kartan keskikohta.

Esimerkki : Kameran siirtyessä haku pysyy Bordeaux’n keskellä.

Syvenny oppaassa : [Miten integroida mobiilikartta sivustolle?](https://www.roote.ai/fi/guides/mobiilisuunnitelma-sivulle/)

## Hakusäde

Etäisyys hakukohdan ympärillä hakualuetta rajaamaan. Yksikkö ja rajat riippuvat sopimuksen reitistä tai työkalusta.

Esimerkki : radius=600 pyytää 600 metrin säteen REST-esimerkissä.

Syvenny oppaassa : [Kuinka etsiä lähellä olevia liikennepysäkkejä API-rajapinnalla?](https://www.roote.ai/fi/guides/kuinka-etsi%C3%A4-l%C3%A4hell%C3%A4-olevia-liikennepys%C3%A4kkej%C3%A4-api-rajapinnan-avulla/)

## Maantieteellinen etäisyys

Etäisyys paikasta toiseen palvelun menetelmällä laskettuna. Ei automaattisesti reittietä tai kävelyaikaa.

Esimerkki : Lähellä oleva paikka voi vaatia kiertoteitä kulkureitillä.

Syvenny oppaassa : [Kuinka etsiä lähellä olevia liikennepysäkkejä API-rajapinnalla?](https://www.roote.ai/fi/guides/kuinka-etsi%C3%A4-l%C3%A4hell%C3%A4-olevia-liikennepys%C3%A4kkej%C3%A4-api-rajapinnan-avulla/)

## Karttasuurennus

Karttanäkymän suurennustaso. Ohjaa näyttöä, ei korvaa API-haun säteen asetusta.

Esimerkki : zoom=15 tuo kartan lähemmäs.

Syvenny oppaassa : [Miten integroida mobiilikartta sivustolle?](https://www.roote.ai/fi/guides/mobiilisuunnitelma-sivulle/)

## Reaaliaikatiedot

Ajantasaiset tiedot, jotka kuvaavat viimeisimpiä tilanteita tai tukevat arvioita. Tuoreutta on arvioitava; reaaliaika ei tarkoita välitöntä tai takuuta.

Esimerkki : Pysäkin oleskeluarvio laskettu ajantasaisten tietojen pohjalta.

Syvenny oppaassa : [Bussien aikataulut: mikä ero on teoreettisilla ja reaaliaikaisilla aikatauluilla?](https://www.roote.ai/fi/guides/bussien-aikataulut-teoreettiset-vai-realiaikaiset/)

## Havainto

Tilanne tai tapahtuma tiettynä ajankohtana. Erottava ennustetusta tai arvioidusta tapahtumasta.

Esimerkki : Bussin todellinen ohitus voi poiketa ennusteesta.

Syvenny oppaassa : [Bussien aikataulut: mikä ero on teoreettisilla ja reaaliaikaisilla aikatauluilla?](https://www.roote.ai/fi/guides/bussien-aikataulut-teoreettiset-vai-realiaikaiset/)

## Tietojen tuoreus

Tiedon ajantasaisuuden luokitus päivämäärien ja sopimuksen sääntöjen mukaan. Kyselyaika ei todista lähteen tuoreutta.

Esimerkki : Nyt vastaanotettu laskuri voi olla vanhasta havainnosta.

Syvenny oppaassa : [Pyörien saatavuus reaaliajassa: miten näyttää se sovelluksessa?](https://www.roote.ai/fi/guides/pyorien-saatavuutta-reaaliajassa-sovelluksessa/)

## Aikaleima

Tiedon tai tapahtuman aikaan liittyvä merkintä. Tulkitse kontekstin mukaan: havainto, päivitys, vastaanotto tai vanheneminen.

Esimerkki : source_updated_at ja received_at kuvaavat eri vaiheita.

Syvenny oppaassa : [Pyörien saatavuus reaaliajassa: miten näyttää se sovelluksessa?](https://www.roote.ai/fi/guides/pyorien-saatavuutta-reaaliajassa-sovelluksessa/)

## Epäajantasainen tieto — stale

Tieto, jota pidetään liian vanhana sopimuksen tai voimassaolokäytännön mukaan. Säilytetään historiatietona, ei tuoreena.

Esimerkki : Käyttöliittymä ilmoittaa, että saatavuustieto pitää päivittää.

Syvenny oppaassa : [Pyörien saatavuus reaaliajassa: miten näyttää se sovelluksessa?](https://www.roote.ai/fi/guides/pyorien-saatavuutta-reaaliajassa-sovelluksessa/)

## Voimassaoloaika — TTL

Aika, jolla välimuistiin tallennetun tiedon päivitystä tai voimassaoloa hallitaan sopimuksen mukaan. Ei yksin todista havainnon ajankohtaa.

Esimerkki : Aikakatkennut välimuisti noudattaa ennalta määrättyä päivityskäytäntöä.

Syvenny oppaassa : [Pyörien saatavuus reaaliajassa: miten näyttää se sovelluksessa?](https://www.roote.ai/fi/guides/pyorien-saatavuutta-reaaliajassa-sovelluksessa/)

## Välimuisti

Väliaikainen tallennus toistuvien samojen hakujen estämiseksi. Välimuistissa oleva arvo säilyttää alkuperänsä ja ajankohdan.

Esimerkki : Kaksi samaa pyyntöä voi käyttää edelleen voimassa olevaa vastausta.

Syvenny oppaassa : [Pyörien saatavuus reaaliajassa: miten näyttää se sovelluksessa?](https://www.roote.ai/fi/guides/pyorien-saatavuutta-reaaliajassa-sovelluksessa/)

## Kattavuus

Hakukentän ja tiedon täydellisyyden alue ja taso. Osittainen kattavuus rajoittaa saavutettavia tuloksia.

Esimerkki : Lista voi olla hyödyllinen vaikka se ei kata kaikkia palveluita.

Syvenny oppaassa : [Ei tulosta tai API-virhe: kuinka tehdä ero?](https://www.roote.ai/fi/guides/ei-tulosta-tai-api-virhe-kuinka-eroittaa/)

## Alkuperä

Tietoa tiedon ja sopimuksen lähteestä ja tuotantotavasta. Auttaa tulkitsemaan tiedon luonnetta.

Esimerkki : Tulos säilyttää tiedon lähteen ja keräyskontekstin.

Syvenny oppaassa : [Kuinka luoda avustaja, joka löytää liikkumismahdollisuuksia osoitteen ympäriltä?](https://www.roote.ai/fi/guides/kuinka-luoda-liikkumisavustaja-osoitteen-ymparille/)

## Lähdeviite

Tietolähteen tai tarjoajan maininta. Jos vaadittu, käyttöliittymä esittää sen.

Esimerkki : required=true -merkintä pitää näkyä käyttöliittymässä.

Syvenny oppaassa : [Kuinka etsiä lähellä olevia liikennepysäkkejä API-rajapinnalla?](https://www.roote.ai/fi/guides/kuinka-etsi%C3%A4-l%C3%A4hell%C3%A4-olevia-liikennepys%C3%A4kkej%C3%A4-api-rajapinnan-avulla/)

## GTFS-aikataulu

Vakiomuoto suunnitellun liikennepanoksen kuvaamiseen: pysäkit, linjat, vuorot, kalenterit ja ajankohdat. Ei sisällä reaaliaikapäivityksiä.

Esimerkki : Aikataulutetut lähdöt linkitetty linjoihin ja palvelupäiviin.

Syvenny oppaassa : [GTFS, GTFS-RT ja GBFS: mitkä ovat erot?](https://www.roote.ai/fi/guides/gtfs-gtfsrt-ja-gbfs-mika-erot/)

## GTFS Realtime (GTFS-RT)

Vakiomuoto liikennetietojen, kuten vuoropäivitysten, ajoneuvojen sijaintien ja hälytysten välittämiseen. Julkaistavat kategoriat vaihtelevat tuottajan mukaan.

Esimerkki : Sijaintivirta ei tarkoita, että kaikissa pysäkeissä olisi arvioita.

Syvenny oppaassa : [GTFS, GTFS-RT ja GBFS: mitkä ovat erot?](https://www.roote.ai/fi/guides/gtfs-gtfsrt-ja-gbfs-mika-erot/)

## GBFS

Vakiomuoto jaettua liikennettä koskeville julkisille tiedoille. Kuvaa järjestelmät, asemat, ajoneuvot ja niiden tilat versioiden ja syötteiden mukaan.

Esimerkki : Asematiedot ja saatavuuslaskurit ovat erillisiä tiedostoja.

Syvenny oppaassa : [GTFS, GTFS-RT ja GBFS: mitkä ovat erot?](https://www.roote.ai/fi/guides/gtfs-gtfsrt-ja-gbfs-mika-erot/)

## Tuntematon arvo — null

Arvon puuttuminen sopimuksessa, jossa null tarkoittaa tietämättömyyttä. Ei korvata nollalla, epätosi-arvolla tai poissuljetulla arvolla.

Esimerkki : Null-laskuri pyörille ei tarkoita tyhjää asemaa.

Syvenny oppaassa : [Ei tulosta tai API-virhe: kuinka tehdä ero?](https://www.roote.ai/fi/guides/ei-tulosta-tai-api-virhe-kuinka-eroittaa/)

## API

Rajapinta, jolla ohjelma voi käyttää toisen palvelun toimintoja määritetyn sopimuksen mukaan. Sisältää syötteet ja vastaukset.

Esimerkki : Sovellus hakee pysäkkejä ROOTE API:lla.

Syvenny oppaassa : [API vai MCP: kumpi valita liikkumistietojen integrointiin?](https://www.roote.ai/fi/guides/api-vai-mcp-kumpi-valita-liikkumistietojen-integrointiin/)

## REST API

HTTP-rajapinta, joka käyttää resurssipohjaista arkkitehtuuria ja verkon mekanismeja. Rajapinta määrittelee reitit, metodit ja esitykset.

Esimerkki : Haku lähetetään dokumentoidulle GET-reitille.

Syvenny oppaassa : [Kuinka etsiä lähellä olevia liikennepysäkkejä API-rajapinnalla?](https://www.roote.ai/fi/guides/kuinka-etsi%C3%A4-l%C3%A4hell%C3%A4-olevia-liikennepys%C3%A4kkej%C3%A4-api-rajapinnan-avulla/)

## Endpoint — API-reitti

Osoite ja toiminto API:ssa tietyn toiminnon suorittamiseen. Eri reitit voivat palauttaa erilaisia tuloksia.

Esimerkki : /v1/transit/nearby hakee lähiliikennepaikat.

Syvenny oppaassa : [Kuinka etsiä lähellä olevia liikennepysäkkejä API-rajapinnalla?](https://www.roote.ai/fi/guides/kuinka-etsi%C3%A4-l%C3%A4hell%C3%A4-olevia-liikennepys%C3%A4kkej%C3%A4-api-rajapinnan-avulla/)

## Kyselyparametri

Arvo URL-osoitteen kysymysmerkin jälkeisessä osassa. Nimi ja muoto määritellään rajapinnassa.

Esimerkki : modes=bus,tram valitsee linja-autot ja raitiovaunut osoitteessa.

Syvenny oppaassa : [Miten integroida mobiilikartta sivustolle?](https://www.roote.ai/fi/guides/mobiilisuunnitelma-sivulle/)

## HTTP-tila

Koodi, joka kertoo HTTP-pyynnön tuloksen. Täydentyy sisällön ja liiketoimintatilanteen tarkistuksilla.

Esimerkki : HTTP 200 voi sisältää liiketoiminnan virheilmoituksen.

Syvenny oppaassa : [Ei tulosta tai API-virhe: kuinka tehdä ero?](https://www.roote.ai/fi/guides/ei-tulosta-tai-api-virhe-kuinka-eroittaa/)

## Tyhjä tulos — empty

Haku, joka ei palauta yhtään yksikköä tarkastelualueella. Ei todista palveluiden puutetta tiedoissa.

Esimerkki : Ei pysäkkejä suodatusehdoilla.

Syvenny oppaassa : [Ei tulosta tai API-virhe: kuinka tehdä ero?](https://www.roote.ai/fi/guides/ei-tulosta-tai-api-virhe-kuinka-eroittaa/)

## Osittainen vastaus — partial

Tulos sisältää käyttökelpoista tietoa rajallisesti tai varoituksia puutteista. Mukana tulee olla asiaankuuluvat ilmoitukset.

Esimerkki : Yksi lähde vastaa, toinen ei ole saatavilla.

Syvenny oppaassa : [Ei tulosta tai API-virhe: kuinka tehdä ero?](https://www.roote.ai/fi/guides/ei-tulosta-tai-api-virhe-kuinka-eroittaa/)

## Aikakatkaisu — timeout

Odotuksen keskeytys ennalta määrätyn rajan ylityttyä. Ei tarkoita tulosten puutetta, vaan epäonnistunutta hakua.

Esimerkki : Sovellus ehdottaa uutta yritystä tyhjän sijaan.

Syvenny oppaassa : [Ei tulosta tai API-virhe: kuinka tehdä ero?](https://www.roote.ai/fi/guides/ei-tulosta-tai-api-virhe-kuinka-eroittaa/)

## Kutsukatto — rate limit

Rajoitus sallitulle pyyntökertoimelle palvelussa. Säännöt ja uudelleenyritysohjeet määräytyvät sopimuksen mukaan.

Esimerkki : Koodi 429 edellyttää ohjeistuksen seuraamista.

Syvenny oppaassa : [Ei tulosta tai API-virhe: kuinka tehdä ero?](https://www.roote.ai/fi/guides/ei-tulosta-tai-api-virhe-kuinka-eroittaa/)

## Bearer-tunnus

Käyttöoikeusavain Authorization-headerissä sopimuksen mukaisesti. Pidettävä turvassa.

Esimerkki : Authorization: Bearer ilman tunnuksen julkaisua URL:ssa.

Syvenny oppaassa : [Kuinka liittää tekoälyavustaja MCP ROOTEen?](https://www.roote.ai/fi/guides/kuinka-liittaa-tekoaly-avustaja-mcp-rooteen/)

## JSON

Rakenteellinen tekstimuoto, joka käyttää objekteja, taulukoita, merkkijonoja ja numeroita. Syntaksin oikeellisuus ei takaa rajapinnan skeeman noudattamista.

Esimerkki : Stations-kokoelman tulee sisältää vaaditut tyypit ja kentät.

Syvenny oppaassa : [Kuinka etsiä lähellä olevia liikennepysäkkejä API-rajapinnalla?](https://www.roote.ai/fi/guides/kuinka-etsi%C3%A4-l%C3%A4hell%C3%A4-olevia-liikennepys%C3%A4kkej%C3%A4-api-rajapinnan-avulla/)

## OpenAPI

Spesifikaatio API-sopimukselle rakenteellisessa dokumentissa. Auttaa reittien, parametrien, vastausten ja skeemojen tarkistuksessa.

Esimerkki : ROOTE-sopimus julkaistu openapi.json:ssa.

Syvenny oppaassa : [Kuinka etsiä lähellä olevia liikennepysäkkejä API-rajapinnalla?](https://www.roote.ai/fi/guides/kuinka-etsi%C3%A4-l%C3%A4hell%C3%A4-olevia-liikennepys%C3%A4kkej%C3%A4-api-rajapinnan-avulla/)

## Embed — upotettu kartta

Ulkoisen kokemuksen upotus sivulle, esim. kartta iframessa. Parametrit ja oikeudet määrittävät käyttöyhteyden.

Esimerkki : ROOTE-iframe näyttää pyörät Bordeaux’n ympärillä.

Syvenny oppaassa : [Miten integroida mobiilikartta sivustolle?](https://www.roote.ai/fi/guides/mobiilisuunnitelma-sivulle/)

## Iframe

HTML-elementti, joka lataa dokumentin sivulle. Eri domaineilla pääsivu ei saa lukea suljetun dokumentin sisäisiä tiloja.

Esimerkki : Hakumuutokset vaativat dokumentoidun viestinvaihdon yläsivulle.

Syvenny oppaassa : [Miten integroida mobiilikartta sivustolle?](https://www.roote.ai/fi/guides/mobiilisuunnitelma-sivulle/)

## MCP — Model Context Protocol

Protokolla tekoälysovelluksen ja palvelimien välillä, jotka tarjoavat työkaluja tai kontekstia. Ei määrittele yksin tietojen laatua.

Esimerkki : Assistentti löytää ROOTEn hakutyökalut.

Syvenny oppaassa : [Mikä on MCP-palvelin ja mihin sitä käytetään?](https://www.roote.ai/fi/guides/mcp-palvelin-mika-se-on-ja-mihin-sita-kaytetaan/)

## MCP-palvelin

Ohjelma, joka tarjoaa MCP-protokollan mukaisia toimintoja. Palvelimen ilmoittamat työkalut kertovat, mitä asiakas voi käyttää.

Esimerkki : tools/list näyttää saatavilla olevan työkaluluettelon.

Syvenny oppaassa : [Mikä on MCP-palvelin ja mihin sitä käytetään?](https://www.roote.ai/fi/guides/mcp-palvelin-mika-se-on-ja-mihin-sita-kaytetaan/)

## MCP-asiakas

TE-sovelluksen osa, joka kommunikoi MCP-palvelimen kanssa. Hoitaa yhteyden protokollaviestit.

Esimerkki : Asiakas välittää hakuparametrit ROOTEen.

Syvenny oppaassa : [Mikä on MCP-palvelin ja mihin sitä käytetään?](https://www.roote.ai/fi/guides/mcp-palvelin-mika-se-on-ja-mihin-sita-kaytetaan/)

## MCP-isäntäapp

Sovellus, joka vastaanottaa käyttäjän kanssa käytävän vuorovaikutuksen ja hallitsee MCP-asiakkaita. Vastaa tulosten käytöstä kokemuksessa.

Esimerkki : Keskustelusovelluksesi yhdistää ROOTE-palvelimeen.

Syvenny oppaassa : [Mikä on MCP-palvelin ja mihin sitä käytetään?](https://www.roote.ai/fi/guides/mcp-palvelin-mika-se-on-ja-mihin-sita-kaytetaan/)

## MCP-työkalu

Suoritettava toiminto nimellä, funktiolla ja argumenttiskaemalla. Assistentin on käytettävä skeman hyväksymiä syötteitä.

Esimerkki : geocode ottaa osoitteen; transit_nearby koordinaatit.

Syvenny oppaassa : [Kuinka liittää tekoälyavustaja MCP ROOTEen?](https://www.roote.ai/fi/guides/kuinka-liittaa-tekoaly-avustaja-mcp-rooteen/)

## Streamable HTTP

MCP-siirtoprotokolla palvelimen kanssa HTTP:n yli. Asiakkaan tuki on tarkistettava.

Esimerkki : ROOTE-palvelin käyttää https://mcp.roote.ai/mcp.

Syvenny oppaassa : [Kuinka liittää tekoälyavustaja MCP ROOTEen?](https://www.roote.ai/fi/guides/kuinka-liittaa-tekoaly-avustaja-mcp-rooteen/)

## Tietoihin perustuva vastaus — grounding

Vastaus rakennetaan kerätyistä tai saaduista todellisista tiedoista. Puuttuvat kentät ja varaukset näkyvissä.

Esimerkki : Assistentti toistaa palautetut paikat ilman keksittyjä aikoja.

Syvenny oppaassa : [Kuinka luoda avustaja, joka löytää liikkumismahdollisuuksia osoitteen ympäriltä?](https://www.roote.ai/fi/guides/kuinka-luoda-liikkumisavustaja-osoitteen-ymparille/)

## TE-avustajan harha

Tiedon tuottaminen ilman perustetta, esitettäväksi kuin tunnettaisi. Liikenteessä voi olla keksitty aikataulu tai saatavuus.

Esimerkki : Assistentti lupaa pysäkin, vaikka työkalu palautti vain paikan.

Syvenny oppaassa : [Kuinka luoda avustaja, joka löytää liikkumismahdollisuuksia osoitteen ympäriltä?](https://www.roote.ai/fi/guides/kuinka-luoda-liikkumisavustaja-osoitteen-ymparille/)

## Prompt-injektio

Yritys muuttaa avustajan ohjeita ulkoisella sisällöllä. Palveluntarjoajan kuvaukset säilytetään tiedoina, ei käskyinä.

Esimerkki : Paikan nimen sisällä oleva piilotettu ohje ei saa vaikuttaa.

Syvenny oppaassa : [Kuinka luoda avustaja, joka löytää liikkumismahdollisuuksia osoitteen ympäriltä?](https://www.roote.ai/fi/guides/kuinka-luoda-liikkumisavustaja-osoitteen-ymparille/)

## Vain luku -tila

Mahdollisuus lukea ilman muokkausoikeutta. Saatavuustiedon lukeminen ei varaa, avaa eikä vuokraa ajoneuvoa.

Esimerkki : ROOTE Data -työkalut ovat tiedon katselua varten.

Syvenny oppaassa : [Mikä on MCP-palvelin ja mihin sitä käytetään?](https://www.roote.ai/fi/guides/mcp-palvelin-mika-se-on-ja-mihin-sita-kaytetaan/)