# Liikumise ja andmete glossaar.

Lihtsad määratlused transpordi, lähiteenuste ja rakendustega seotud tööriistade mõistmiseks.

Source: https://www.roote.ai/et/liikumisglossaar/
Language: et
Author: ROOTE

## Jalgratas enesevalitsemiseks

Teenistus jalgratta lühiajaliseks laenutamiseks vastavalt operaatori tingimustele. Võib toimida jaamadega või jaamadeta sõidukite alusel.

Näide : Sa näed ratast ja kasutad vastavat laenutusteenust.

Loe juhendist lisaks : [Kuidas leida linnaratast lähedal?](https://www.roote.ai/et/guides/kuidas-leida-linnaratast-lahkliigiks-ligidal/)

## Jagatud liikumine

Teenuste kogum, mis annab võimaluse kasutada sõidukeid järjestikku erinevate inimeste poolt, mitte ainult ühte omanikku.

Näide : Jalgrattad ja tõukerattad, mida linna piires rentida.

Loe juhendist lisaks : [Kuidas leida linnaratast lähedal?](https://www.roote.ai/et/guides/kuidas-leida-linnaratast-lahkliigiks-ligidal/)

## Kinnituspost

Jaamas olev seadeldis, kuhu ratas saab kinnitada. Selle olemasolu ei garanteeri tagastamise võimalust hetkel.

Näide : Tagastamiseks peab olemas ja vabaks jääma koht.

Loe juhendist lisaks : [Tühi või täis jalgrattajaam: mida teha?](https://www.roote.ai/et/guides/tuhja-voi-taitsa-taiendatud-jalgrattajaam-mida-teha/)

## Jalgrattajaam

Korraldatud koht jagatud rataste võtmiseks või tagastamiseks. Koordinaadid, mahutavus ning saadavus kirjeldavad jaama erinevaid aspekte.

Näide : Jaam võib olla kaardil olemas, kuid hetkel tühi.

Loe juhendist lisaks : [Tühi või täis jalgrattajaam: mida teha?](https://www.roote.ai/et/guides/tuhja-voi-taitsa-taiendatud-jalgrattajaam-mida-teha/)

## Jaamata ehk free-floating

Konfiguratsioon, milles sõidukeid ei pea võtma ega tagastama fikseeritud posti juures; parkimise piirkonnad ja reeglid kehtivad teenuse alusel.

Näide : Tõukeratta tagastamiseks tuleb see jätta lubatud tsooni.

Loe juhendist lisaks : [Jalgratas jaamades või ilma jaamamata: mis vahe on?](https://www.roote.ai/et/guides/jalgratas-jaamades-voi-ilma-jaamamata-mis-vahe-on/)

## Saadavus

Staatus või kogus, mis näitab, mis on kasutada hetkel teadaolevate andmete põhjal. Vaadeldud saadavus võib muutuda ega tähenda broneeringut.

Näide : Kolm ratast on näha jaamas, kuid see ei võrdu kolme broneeritud rattaga.

Loe juhendist lisaks : [Jalgrataste saadavus reaalajas: kuidas seda rakenduses kuvada?](https://www.roote.ai/et/guides/ratsevalised-jalgrataste-reaalajas-saadavus-kuidas-rakenduses-naita/)

## Sõiduki vastuvõtt

Tegevus, kus alustatakse sõiduki kasutamist. Positiivne loendur ei taga, kui teenus on sõidu alustamise hetkel keelatud.

Näide : Ratast on olemas, kuid jaam ei pruugi lubada rentimist.

Loe juhendist lisaks : [Jalgrataste saadavus reaalajas: kuidas seda rakenduses kuvada?](https://www.roote.ai/et/guides/ratsevalised-jalgrataste-reaalajas-saadavus-kuidas-rakenduses-naita/)

## Tagastamine

Sõiduki kasutamise lõpetamine teenuse reeglite järgi. Tagastamise võimalused võivad erineda võtmiseks kehtivatest.

Näide : Jaam võib lubada väljasõitu, kuid tagastamiseks puududa koht.

Loe juhendist lisaks : [Tühi või täis jalgrattajaam: mida teha?](https://www.roote.ai/et/guides/tuhja-voi-taitsa-taiendatud-jalgrattajaam-mida-teha/)

## Elektriline abijalgratas

Ratas, millel on mootor, mis abistab pedaalimist vastavalt omadustele. Liikumisandmetes võivad propulsiivtüüp ja aku olla eraldi määratletud.

Näide : Jaam võib eristada mehaanilisi ja elektrirataste koguseid.

Loe juhendist lisaks : [Jalgrataste saadavus reaalajas: kuidas seda rakenduses kuvada?](https://www.roote.ai/et/guides/ratsevalised-jalgrataste-reaalajas-saadavus-kuidas-rakenduses-naita/)

## Intermodaalsus

Järjestikune mitme liikumisviisi kasutamine ühe marsruudi jooksul. Iga etapp säilitab oma sõiduplaani, ligipääsu ja tingimused.

Näide : Sa sõidad rattaga trammile ja jätkad seejärel jalgsi.

Loe juhendist lisaks : [Kuidas ühendada jalgratas ja ühistransport igapäevaselt?](https://www.roote.ai/et/guides/kuidas-yhendada-jalgratast-ja-uksasiajalist-liiklust-igapaevaselt/)

## Transpordipeatus

Koht, kus transporditeenus võtab või jätab reisijaid. Avatud peatus ei anna automaatselt järgmiste sõitude infot.

Näide : Bussipeatus tagastatakse ilma väljumisaegadeta.

Loe juhendist lisaks : [Kuidas leida lähim bussijaam või trammipeatus?](https://www.roote.ai/et/guides/kuidas-leida-korgeim-linna-kinni-ja-trammipeatus/)

## Platvorm

Koht või sõidukitepeatus transpordikohas. Lähedal võiks olla mitut platvormi eri suundade või teenuste jaoks.

Näide : Mõlemad sõidusuunad võivad olla erinevatel platvormidel.

Loe juhendist lisaks : [Kuidas leida õige bussipeatus ja õige suund?](https://www.roote.ai/et/guides/kuidas-leida-oige-bussipeatus-ja-suunas/)

## Liin

Võrgus määratletud transporditeenus ühe või mitme marsruudi või variandiga. Liini nimi ei garanteeri õiget sõidusuunat.

Näide : Sama liin võib pakkuda erinevaid lõpp-peatusi.

Loe juhendist lisaks : [Kuidas leida õige bussipeatus ja õige suund?](https://www.roote.ai/et/guides/kuidas-leida-oige-bussipeatus-ja-suunas/)

## Sõit

Transporditeenuse täideviimine koos marsruudi ja peatusedega. GTFS-s on sõit seotud liini ja teeninduskalendriga.

Näide : Kaks järjestikust väljumist samalt liinilt on kaks sõitu.

Loe juhendist lisaks : [GTFS, GTFS-RT ja GBFS: mis vahe on?](https://www.roote.ai/et/guides/gtfs-gtfs-rt-ja-gbfs-mis-on-eraldised/)

## Suunamine

Teenuse suuna või sihtkoha märge. See peab olema kontrollitud marsruudi ja pardale astumise kohaga.

Näide : Otsid trami sihtkohta, mitte vastassuunda.

Loe juhendist lisaks : [Kuidas leida õige bussipeatus ja õige suund?](https://www.roote.ai/et/guides/kuidas-leida-oige-bussipeatus-ja-suunas/)

## Lõpp-peatus

Transpordimarsruudi viimane punkt. Liinil võivad olla erinevad variandid ning lõpp-peatused.

Näide : Lühike teenus lõpeb enne tavapärast lõpp-peatust.

Loe juhendist lisaks : [Kuidas leida õige bussipeatus ja õige suund?](https://www.roote.ai/et/guides/kuidas-leida-oige-bussipeatus-ja-suunas/)

## Ühendus

Üleminek ühelt teenuselt või liikumisviisilt teisele sama sõidu jooksul. Kahe peatuse lähedus ei taga automatiseeritud ühendust.

Näide : Tuleb arvestada liikumise ja ootamise ajaga platvormide vahel.

Loe juhendist lisaks : [Kuidas lugeda busside, trammide ja metroo liiniplaane?](https://www.roote.ai/et/guides/kuidas-lugeda-bussit-tramm-i-v%C3%B5i-metroo-plaane/)

## Plaanitav aeg

Teenindusplaani järgi määratud aeg konkreetseks kuupäevaks ja peatumiseks. See ei pruugi kajastada sõiduki praegust asukohta.

Näide : Väljumine on kavandatud kell 8:10 vastavalt kalendrile.

Loe juhendist lisaks : [Busside sõiduplaanid: mis vahe on teoreetiliste ja reaalajas plaanide vahel?](https://www.roote.ai/et/guides/busside-graafikud-teoreetilised-vou-reaalajas/)

## Hinnanguline aeg

Tulevase peatumise prognoos, mis arvutatakse olemasolevatest andmetest ja võib muutuda uute info saabumisel.

Näide : Algne 8:10 aeg on nüüd hinnanguliselt 8:14.

Loe juhendist lisaks : [Busside sõiduplaanid: mis vahe on teoreetiliste ja reaalajas plaanide vahel?](https://www.roote.ai/et/guides/busside-graafikud-teoreetilised-vou-reaalajas/)

## Järgmine väljumine

Järgmine sõit või väljumine antud kohas ja teenusel. Peatuse leidmine ei tähenda järgmiste väljumiste otsingut.

Näide : Peatuste ja väljumiste loendid on kaks eraldi tulemust.

Loe juhendist lisaks : [Kuidas otsida lähimaid ühistranspordi peatusi API abil?](https://www.roote.ai/et/guides/kuidas-ukasida-ligidal-olevaid-ylalaiu-api-ga/)

## Häire

Sündmus, mis mõjutab transporditeenust, näiteks katkestus või marsruudimuutus. Mõjusid tuleb lugeda näidatud piirkonnas ja ajal.

Näide : Teade võib kehtida vaid kindlal liinil teatud kellaajal.

Loe juhendist lisaks : [Kuidas luua assistent, mis leiab liikuvusvõimalused aadressi lähedal?](https://www.roote.ai/et/guides/kuidas-luua-assistent-mobiliteedile-aadressi-lahedal/)

## Teenuse kalender

Informatsioon, mis kirjeldab päeva, millal teenus on plaanitud koos eranditega. Aegade tõlgendamisel tuleb arvestada kalendriga.

Näide : Nädalapäevadel kavandatud sõit ei pruugi pühapäeval toimuda.

Loe juhendist lisaks : [GTFS, GTFS-RT ja GBFS: mis vahe on?](https://www.roote.ai/et/guides/gtfs-gtfs-rt-ja-gbfs-mis-on-eraldised/)

## Linnateenus

Seade või teenus, mis on kasulik koha lähedal, näiteks tualett, joogivee punkt või laadimisseade. Atribuudid võivad olla mittetäielikud.

Näide : Lähedusotsingu tulemus kirjeldab teenust ja tuntud infot.

Loe juhendist lisaks : [Kuidas otsida lähimaid ühistranspordi peatusi API abil?](https://www.roote.ai/et/guides/kuidas-ukasida-ligidal-olevaid-ylalaiu-api-ga/)

## Avalikud tualetid

Tualettruumid, mis on mõeldud avalikuks kasutamiseks kohalike tingimuste alusel. Andmete olemasolu ei taga tasuta kasutust, avamist ega ligipääsetavust.

Näide : Kontrolli tingimusi enne liikumist.

Loe juhendist lisaks : [Kuidas leida tasuta avalikke tualette enda ümber?](https://www.roote.ai/et/guides/kuidas-leida-ulemvalt-olevaid-publikke-tualette-ilma-makseta/)

## Ligipääsetavus

Omadused, mis võimaldavad koha või teenuse kasutamist vastavalt inimese vajadustele. Teadmata andmed ei tähenda ligipääsetavust ega selle puudumist.

Näide : Ligipääs ratastooliga võib olla teada või teadmata.

Loe juhendist lisaks : [Ligipääsetavad avalikud tualetid: mida kontrollida enne liikumist?](https://www.roote.ai/et/guides/ligipublicused-saavutavad-mis-tuleb-enne-liikumist-ule-vaadata/)

## Liikumispuudega inimene (LPI)

Inimene, kellel on liikumisraskused, püsivad või ajutised. LPI märge ei kirjelda kõiki vajalikke ligipääse ega varustust.

Näide : Kaldtee olemasolu ei tähenda puudumist kõikides barjäärides.

Loe juhendist lisaks : [Ligipääsetavad avalikud tualetid: mida kontrollida enne liikumist?](https://www.roote.ai/et/guides/ligipublicused-saavutavad-mis-tuleb-enne-liikumist-ule-vaadata/)

## Avamisajad

Ajad, mil koht teatab olema avatud. See ei kinnita reaalajas toimimist.

Näide : Ajutine sulgemine ei pruugi kajastuda regulaarsel avamisaegadel.

Loe juhendist lisaks : [Kuidas leida tasuta avalikke tualette enda ümber?](https://www.roote.ai/et/guides/kuidas-leida-ulemvalt-olevaid-publikke-tualette-ilma-makseta/)

## Joogivesi

Vesi, mis on määratud inimtarbimiseks sobivaks. Joogiveepunkti või purskkaevu ei tohiks esitada joogiveena ilma selge infota.

Näide : Seadme tüüp ja omadused tuleb eristada.

Loe juhendist lisaks : [Kuidas otsida lähimaid ühistranspordi peatusi API abil?](https://www.roote.ai/et/guides/kuidas-ukasida-ligidal-olevaid-ylalaiu-api-ga/)

## Laadimispunkt

Seade, mis võimaldab sõidukit laadida. Laadimispunkti asukoht ei taga selle saadavust või ühenduse ühilduvust.

Näide : Laadimiskoht ja kasutusolek on eri infosildid.

Loe juhendist lisaks : [Kuidas otsida lähimaid ühistranspordi peatusi API abil?](https://www.roote.ai/et/guides/kuidas-ukasida-ligidal-olevaid-ylalaiu-api-ga/)

## Teenusetüüp

Kategooria, mida kasutatakse linnateenuse valimiseks või kirjeldamiseks. Lubatud väärtused sõltuvad liidesest ja skeemist.

Näide : ROOTE teenuste API kasutab tüüpidena toilets avalikke tualette.

Loe juhendist lisaks : [Kuidas otsida lähimaid ühistranspordi peatusi API abil?](https://www.roote.ai/et/guides/kuidas-ukasida-ligidal-olevaid-ylalaiu-api-ga/)

## Geolokatsioon

Seadme või rakenduse poolt saadud geograafiline asukoht. See sõltub õigustest ja täpsusest.

Näide : Asukoha nupp küsib brauserilt luba.

Loe juhendist lisaks : [Kuidas integreerida liikumiskaarti oma veebilehele?](https://www.roote.ai/et/guides/kuidas-lisada-liikumiskaart-veebilehele/)

## GPS koordinaadid

Väärtused geograafilise punkti tähistamiseks, tavaliselt laius- ja pikkuskraad. Järjestus peab olema kindlaks määratud liideses.

Näide : Lähedusotsingule antakse kaks eraldi koordinaati.

Loe juhendist lisaks : [Kuidas otsida lähimaid ühistranspordi peatusi API abil?](https://www.roote.ai/et/guides/kuidas-ukasida-ligidal-olevaid-ylalaiu-api-ga/)

## Laiuskraad

Koordinaat, mis näitab positsiooni ekvaatori põhja- või lõunapoolsuses, kraadides. Lubatud väärtused on −90 kuni 90.

Näide : Otsingu laiuskraadi edastatakse parameetrina lat.

Loe juhendist lisaks : [Kuidas otsida lähimaid ühistranspordi peatusi API abil?](https://www.roote.ai/et/guides/kuidas-ukasida-ligidal-olevaid-ylalaiu-api-ga/)

## Pikkuskraad

Koordinaat, mis märgib asukohta idast lääne suunas võrreldes nullmeridiaaniga. Näited ROOTE-s kasutavad −180 kuni 180 kraadi.

Näide : Pikkuskraadi saab edastada lon või alias lng kaudu.

Loe juhendist lisaks : [Kuidas otsida lähimaid ühistranspordi peatusi API abil?](https://www.roote.ai/et/guides/kuidas-ukasida-ligidal-olevaid-ylalaiu-api-ga/)

## Geokodeerimine

Otsing, mis teisendab aadressi või geograafilise väljendi koordinaatideks ja kandidaatideks. Võib olla mitu kohta sama nimetusega.

Näide : Kaks linna võivad omada sama tänava nime.

Loe juhendist lisaks : [Kuidas luua assistent, mis leiab liikuvusvõimalused aadressi lähedal?](https://www.roote.ai/et/guides/kuidas-luua-assistent-mobiliteedile-aadressi-lahedal/)

## Pöördgeokodeerimine

Kohtade või nimede otsing koordinaatide põhjal. Tulemuseks võib olla lähikoht, mitte täpne aadress.

Näide : GPS punkt seostatakse lugemise väärtusega.

Loe juhendist lisaks : [Mis on MCP server ja milleks see on?](https://www.roote.ai/et/guides/mis-on-mcp-server-ja-milleks-see-on/)

## Huviobjekt (POI)

Tuvastatav koht, mis on otsingu jaoks kasulik, nt rajatis või seade. POI erineb aadressist.

Näide : Hotelli nimi otsitakse kui rajatist.

Loe juhendist lisaks : [Kuidas luua assistent, mis leiab liikuvusvõimalused aadressi lähedal?](https://www.roote.ai/et/guides/kuidas-luua-assistent-mobiliteedile-aadressi-lahedal/)

## Otsingu lähtepunkt

Punkt, mille ümber läheduses otsitakse ja millele kaugused arvutatakse. Võib erineda kaardi keskpunktist.

Näide : Kaamera liigub, kuid otsing jääb Bordeaux keskmesse.

Loe juhendist lisaks : [Kuidas integreerida liikumiskaarti oma veebilehele?](https://www.roote.ai/et/guides/kuidas-lisada-liikumiskaart-veebilehele/)

## Otsingu raadius

Kaugus lähtestamispunkti ümber, millega piiratakse otsingut. Ühik ja piirid sõltuvad teekonna või tööriista lepingust.

Näide : radius=600 tähistab 600 meetri raadiust REST näites.

Loe juhendist lisaks : [Kuidas otsida lähimaid ühistranspordi peatusi API abil?](https://www.roote.ai/et/guides/kuidas-ukasida-ligidal-olevaid-ylalaiu-api-ga/)

## Geograafiline kaugus

Kaugus arvutatud positsioonide vahel teenuse meetodil. Ei hõlma automaatselt marsruudi ega jalgsikäigu aega.

Näide : Lähedal asuv koht võib vajada ümbersõitu.

Loe juhendist lisaks : [Kuidas otsida lähimaid ühistranspordi peatusi API abil?](https://www.roote.ai/et/guides/kuidas-ukasida-ligidal-olevaid-ylalaiu-api-ga/)

## Kaardi suumi tase

Kaardivaate suurendustase. Kontorleerib kuvatavat ala, kuid ei asenda API päringu raadiust.

Näide : zoom=15 suumib kaarti.

Loe juhendist lisaks : [Kuidas integreerida liikumiskaarti oma veebilehele?](https://www.roote.ai/et/guides/kuidas-lisada-liikumiskaart-veebilehele/)

## Reaalajas andmed

Andmed, mis on uuendatud hiljutist olukorda näitama või hinnanguid toetama. Värskus tuleb hinnata; reaalajas ei tähenda kohest ega garanteeritud.

Näide : Hinnangut uuendatakse hiljutiste andmete põhjal.

Loe juhendist lisaks : [Busside sõiduplaanid: mis vahe on teoreetiliste ja reaalajas plaanide vahel?](https://www.roote.ai/et/guides/busside-graafikud-teoreetilised-vou-reaalajas/)

## Vaatlus

Tuvas või sündmus kindlal ajal. Tuleb eristada kavandatud või hinnangulisest sündmusest.

Näide : Bussi tegelik möödumine võib erineda hinnangust.

Loe juhendist lisaks : [Busside sõiduplaanid: mis vahe on teoreetiliste ja reaalajas plaanide vahel?](https://www.roote.ai/et/guides/busside-graafikud-teoreetilised-vou-reaalajas/)

## Andmete värskus

Andme selgus ja ajakohasus vastavalt kuupäevadele ja lepingutingimustele. Küsingu aeg ei tõenda allika värskust.

Näide : Hiljuti saabunud loendur võib pärineda vanast vaatlusest.

Loe juhendist lisaks : [Jalgrataste saadavus reaalajas: kuidas seda rakenduses kuvada?](https://www.roote.ai/et/guides/ratsevalised-jalgrataste-reaalajas-saadavus-kuidas-rakenduses-naita/)

## Ajatempli märge

Ajainfo, mis on seotud andme või sündmusega. Sõltub välja iseloomust: vaatlus, uuendus, vastuvõtt või aegumine.

Näide : source_updated_at ja received_at kirjeldavad eri hetki.

Loe juhendist lisaks : [Jalgrataste saadavus reaalajas: kuidas seda rakenduses kuvada?](https://www.roote.ai/et/guides/ratsevalised-jalgrataste-reaalajas-saadavus-kuidas-rakenduses-naita/)

## Aegunud andmed (stale)

Info, mida peetakse liiga vanaks vastavalt lepingule või kehtivuspoliitikale. Võib olla säilitatud ajalooliselt ilma värske välja näitamata.

Näide : Kasutajaliides näitab, et saadavus vajab uuendust.

Loe juhendist lisaks : [Jalgrataste saadavus reaalajas: kuidas seda rakenduses kuvada?](https://www.roote.ai/et/guides/ratsevalised-jalgrataste-reaalajas-saadavus-kuidas-rakenduses-naita/)

## Kehtivusaeg (TTL)

Aeg, mille jooksul andmed vahemälus kehtivad ja mille järgi uuendatakse arvestades lepingut. See ei tõenda allika vaatlusaja täpsust.

Näide : Aegunud vahemälu järgib uuendamise poliitikat.

Loe juhendist lisaks : [Jalgrataste saadavus reaalajas: kuidas seda rakenduses kuvada?](https://www.roote.ai/et/guides/ratsevalised-jalgrataste-reaalajas-saadavus-kuidas-rakenduses-naita/)

## Vahemälu

Ajutine tulemite salvestus korduvate identsete otsingute vältimiseks. Vahemälus olev väärtus jääb päritolu ja aja mõjusfääri alla.

Näide : Kaks võrdselt päringut võivad kasutada sama kehtivat vastust.

Loe juhendist lisaks : [Jalgrataste saadavus reaalajas: kuidas seda rakenduses kuvada?](https://www.roote.ai/et/guides/ratsevalised-jalgrataste-reaalajas-saadavus-kuidas-rakenduses-naita/)

## Katvus

Piirkond ja info terviklikkus otsingus või allikas. Osaline katvus piirab järelduste teguvõimet.

Näide : Loend võib olla kasulik, kuigi ei hõlma kõiki teenuseid.

Loe juhendist lisaks : [Mitte ühtegi tulemust või API viga: kuidas teha vahet?](https://www.roote.ai/et/guides/mitte-ulemust-v%C3%B5i-api-viga-kuidas-eristada/)

## Päritolu

Info, mille alusel saab kindlaks teha andmeallika ja selle tootmismeetodi, aidates tõlgendada ulatust.

Näide : Tulemus kannab allikat ja kogumise konteksti.

Loe juhendist lisaks : [Kuidas luua assistent, mis leiab liikuvusvõimalused aadressi lähedal?](https://www.roote.ai/et/guides/kuidas-luua-assistent-mobiliteedile-aadressi-lahedal/)

## Autorsus

Andmeandja või allika nimetamine, mida näidatakse kasutuskogemuses vajadusel.

Näide : required=true märge peab kasutajaliideses püsima.

Loe juhendist lisaks : [Kuidas otsida lähimaid ühistranspordi peatusi API abil?](https://www.roote.ai/et/guides/kuidas-ukasida-ligidal-olevaid-ylalaiu-api-ga/)

## GTFS sõiduplaan

Standardvorming transpordipakkumise kavandamiseks: peatused, liinid, sõidud, kalendrid ja läbimised. Ei pruugi pakkuda automaatseid reaalajas uuendusi.

Näide : Planeeritud läbimised on seotud sõitude ja teenistuspäevadega.

Loe juhendist lisaks : [GTFS, GTFS-RT ja GBFS: mis vahe on?](https://www.roote.ai/et/guides/gtfs-gtfs-rt-ja-gbfs-mis-on-eraldised/)

## GTFS Realtime (GTFS-RT)

Standardvorming sõitude, sõidukite positsioonide ning teatete reaalajas uuendamiseks. Avaldatav sisu sõltub tootjast.

Näide : Positsioonide voo olemasolu ei taga hinnanguid kõikidele peatustele.

Loe juhendist lisaks : [GTFS, GTFS-RT ja GBFS: mis vahe on?](https://www.roote.ai/et/guides/gtfs-gtfs-rt-ja-gbfs-mis-on-eraldised/)

## GBFS

Standard avalike jagatud liikumisandmete vorming. Vastavalt versioonile kirjeldab süsteeme, jaamu, sõidukeid ja staatuseid.

Näide : Jaamade info ja saadavusnumbrid on eraldi voogudes.

Loe juhendist lisaks : [GTFS, GTFS-RT ja GBFS: mis vahe on?](https://www.roote.ai/et/guides/gtfs-gtfs-rt-ja-gbfs-mis-on-eraldised/)

## Teadmata väärtus (null)

Väärtuse puudumine lepingus, kus null tähistab teadmata; ei asendata nulli, valeks ega puudumise tõendiks.

Näide : Null-väärtus rataste loenduril ei tähenda jaama tühjust.

Loe juhendist lisaks : [Mitte ühtegi tulemust või API viga: kuidas teha vahet?](https://www.roote.ai/et/guides/mitte-ulemust-v%C3%B5i-api-viga-kuidas-eristada/)

## API

Liides programmi võimaldamiseks kasutada teise teenuse võimeid määratletud lepingu kaudu, määratledes sisendid ja väljundid.

Näide : Rakendus otsib peatusi ROOTE API kaudu.

Loe juhendist lisaks : [API või MCP: kumba valida mobiilsuse andmete integreerimiseks?](https://www.roote.ai/et/guides/api-voi-mcp-vali-mobiilsuse-andmete-voimlemine/)

## REST API

Veebipõhine HTTP liides, mis kasutab ressursse ja veebimehhanisme. Leping määrab marsruudid, meetodid ja esitusviisid.

Näide : Päring saadetakse GET-marsruudile dokumenteeritult.

Loe juhendist lisaks : [Kuidas otsida lähimaid ühistranspordi peatusi API abil?](https://www.roote.ai/et/guides/kuidas-ukasida-ligidal-olevaid-ylalaiu-api-ga/)

## Endpoint ehk API marsruut

API aadress ja operatsioon konkreetse funktsionaalsuse jaoks. Erinevad marsruudid tagastavad erinevaid tulemusi.

Näide : /v1/transit/nearby otsib transpordikohti.

Loe juhendist lisaks : [Kuidas otsida lähimaid ühistranspordi peatusi API abil?](https://www.roote.ai/et/guides/kuidas-ukasida-ligidal-olevaid-ylalaiu-api-ga/)

## Päringu parameeter

Väärtus URL-osast pärast küsimärki. Selle nimi ja formaat on määratletud liidesega.

Näide : modes=bus,tram valib URL-is transpordimoodid.

Loe juhendist lisaks : [Kuidas integreerida liikumiskaarti oma veebilehele?](https://www.roote.ai/et/guides/kuidas-lisada-liikumiskaart-veebilehele/)

## HTTP staatuskood

Kood, mis näitab päringu tulemust HTTP tasandil. Seda täiendatakse äriloogika kontrolliga.

Näide : HTTP 200 võib sisaldada äriloogika viga.

Loe juhendist lisaks : [Mitte ühtegi tulemust või API viga: kuidas teha vahet?](https://www.roote.ai/et/guides/mitte-ulemust-v%C3%B5i-api-viga-kuidas-eristada/)

## Tühi tulemus (empty)

Otsing ei tagasta kohalolevat ühtegi üksust. See ei tõenda teenuste füüsilist puudumist väljaspool andmeid.

Näide : Päringuga filtreeritud peatust ei leitud.

Loe juhendist lisaks : [Mitte ühtegi tulemust või API viga: kuidas teha vahet?](https://www.roote.ai/et/guides/mitte-ulemust-v%C3%B5i-api-viga-kuidas-eristada/)

## Osaline tulemus (partial)

Tulemus sisaldab kasutatavaid andmeid piirangute või puudustega ning vastava hoiatusega.

Näide : Üks allikas vastab, teine on kättesaamatu.

Loe juhendist lisaks : [Mitte ühtegi tulemust või API viga: kuidas teha vahet?](https://www.roote.ai/et/guides/mitte-ulemust-v%C3%B5i-api-viga-kuidas-eristada/)

## Aegumistähtaeg (timeout)

Ootuse katkestamine, mis ületab teatud aega; tähistab mittetäielikku otsingut, mitte tulemuse puudumist.

Näide : Rakendus pakub uuesti proovimist mitte tühja nimekirja.

Loe juhendist lisaks : [Mitte ühtegi tulemust või API viga: kuidas teha vahet?](https://www.roote.ai/et/guides/mitte-ulemust-v%C3%B5i-api-viga-kuidas-eristada/)

## Päringu sageduse piirang

Piirang päringute arvu kohta, mida teenus lubab; reeglid sõltuvad aktiivsest lepingust.

Näide : Vastus 429 kutsub vastavalt juhistele uuesti alustama.

Loe juhendist lisaks : [Mitte ühtegi tulemust või API viga: kuidas teha vahet?](https://www.roote.ai/et/guides/mitte-ulemust-v%C3%B5i-api-viga-kuidas-eristada/)

## Bearer token

Juurdepääsu identifikaator Authorization päises vastavalt mehhanismile; tuleb hoida turvalises konfiguratsioonis.

Näide : Authorization: Bearer kasutatakse ilma token URL-is avaldamata.

Loe juhendist lisaks : [Kuidas ühendada tehisintellekti assistent MCP ROOTE-ga?](https://www.roote.ai/et/guides/kuidas-%C3%BChendada-tehisintellekti-assistent-mcp-roote-ga/)

## JSON

Tekstipõhine struktuurvorming, millel on objektid, massiivid, stringid ja numbrid; võib olla süntaktiliselt korrektne, kuid mitte vastav API skeemile.

Näide : Stations andmekogu peab vastama oodatud tüübile ja väljadel.

Loe juhendist lisaks : [Kuidas otsida lähimaid ühistranspordi peatusi API abil?](https://www.roote.ai/et/guides/kuidas-ukasida-ligidal-olevaid-ylalaiu-api-ga/)

## OpenAPI

Spetsifikatsioon HTTP API lepingu kirjeldamiseks struktureeritud dokumendis; abistab marsruutide, parameetrite ja vastuste valideerimisel.

Näide : ROOTE leping on avaldatud openapi.json failina.

Loe juhendist lisaks : [Kuidas otsida lähimaid ühistranspordi peatusi API abil?](https://www.roote.ai/et/guides/kuidas-ukasida-ligidal-olevaid-ylalaiu-api-ga/)

## Embed ehk integreeritud kaart

Välise kogemuse sisestamine lehele, nt kaart iframe’s; parameetrid ja õigused määravad kasutuskonteksti.

Näide : ROOTE iframe kuvab jalgrattaid Bordeaux ümbruses.

Loe juhendist lisaks : [Kuidas integreerida liikumiskaarti oma veebilehele?](https://www.roote.ai/et/guides/kuidas-lisada-liikumiskaart-veebilehele/)

## Iframe

HTML element, mis laadib lehele dokumendi; eri domeenid piiravad vanemlehe ligipääsu sisule.

Näide : Otsingumuutused vajavad dokumenteeritud suhtlust vanemaga.

Loe juhendist lisaks : [Kuidas integreerida liikumiskaarti oma veebilehele?](https://www.roote.ai/et/guides/kuidas-lisada-liikumiskaart-veebilehele/)

## MCP – Model Context Protocol

Protokoll, mis lubab tehisintellektil suhelda serveritega, mis pakuvad tööriistu või konteksti, kuid ei määra andmete kvaliteeti.

Näide : Assistent leiab ROOTE otsingu tööriistad.

Loe juhendist lisaks : [Mis on MCP server ja milleks see on?](https://www.roote.ai/et/guides/mis-on-mcp-server-ja-milleks-see-on/)

## MCP server

Programm, mis pakub MCP protokolli võimalusi. Tööriistade tegelik nimekiri määrab, mida klient saab kutsuda.

Näide : tools/list võimaldab vaadata saadaolevat inventari.

Loe juhendist lisaks : [Mis on MCP server ja milleks see on?](https://www.roote.ai/et/guides/mis-on-mcp-server-ja-milleks-see-on/)

## MCP klient

Tehisintellekti komponent, mis suhtleb MCP serveriga ja haldab selle protokolli vahetust.

Näide : Klient edastab ROOTE otsingu argumente.

Loe juhendist lisaks : [Mis on MCP server ja milleks see on?](https://www.roote.ai/et/guides/mis-on-mcp-server-ja-milleks-see-on/)

## MCP host rakendus

Rakendus, mis haldab kasutajaliidest ja MCP kliente ning vastutab tulemuste kasutamise eest.

Näide : Sinu vestlusrakendus ühendab ROOTE serveriga.

Loe juhendist lisaks : [Mis on MCP server ja milleks see on?](https://www.roote.ai/et/guides/mis-on-mcp-server-ja-milleks-see-on/)

## MCP tööriist

Teostatav võtme-, funktsiooni- ja parameetrite skeemiga võimekus, mida assistent kasutab vastavalt nõutud sisendile.

Näide : geocode võtab aadressi, transit_nearby koordinaadid.

Loe juhendist lisaks : [Kuidas ühendada tehisintellekti assistent MCP ROOTE-ga?](https://www.roote.ai/et/guides/kuidas-%C3%BChendada-tehisintellekti-assistent-mcp-roote-ga/)

## Streamable HTTP

MCP transpordimehhanism serveriga suhtlemiseks HTTP kaudu; tugi peab olema kliendis kontrollitud.

Näide : ROOTE kaugserver kasutab https://mcp.roote.ai/mcp.

Loe juhendist lisaks : [Kuidas ühendada tehisintellekti assistent MCP ROOTE-ga?](https://www.roote.ai/et/guides/kuidas-%C3%BChendada-tehisintellekti-assistent-mcp-roote-ga/)

## Andmetel põhinev vastus (grounding)

Vastus, mis põhineb tegelikult kätte saadud informatsioonil, puuduvad väljad jäävad nähtavaks.

Näide : Assistent kordab saadud kohti ilma ajagraafikut leiutamata.

Loe juhendist lisaks : [Kuidas luua assistent, mis leiab liikuvusvõimalused aadressi lähedal?](https://www.roote.ai/et/guides/kuidas-luua-assistent-mobiliteedile-aadressi-lahedal/)

## Tehisintellekti assistendi hallutsinatsioon

Tõestamata info esitamine nagu teadaolevat fakti; liikumises võib olla vale aeg või saadavus.

Näide : Assistent teatab sõidust, kuigi tööriist tagastas ainult peatuse.

Loe juhendist lisaks : [Kuidas luua assistent, mis leiab liikuvusvõimalused aadressi lähedal?](https://www.roote.ai/et/guides/kuidas-luua-assistent-mobiliteedile-aadressi-lahedal/)

## Päringu injektsioon

Katse suunata assistenti operatsioonide muuta välise sisu kaudu; pakkujate kirjeldus peab jääma andmeks, mitte korralduseks.

Näide : Peidetud juhis kohanime sees ei tohi täita.

Loe juhendist lisaks : [Kuidas luua assistent, mis leiab liikuvusvõimalused aadressi lähedal?](https://www.roote.ai/et/guides/kuidas-luua-assistent-mobiliteedile-aadressi-lahedal/)

## Ainult lugemiseks

Võimekus ainult infot lugeda ilma muutmiseta; saadavuse lugemine ei halda broneeringut ega laenutust.

Näide : ROOTE Data tööriistad on infot lugemiseks.

Loe juhendist lisaks : [Mis on MCP server ja milleks see on?](https://www.roote.ai/et/guides/mis-on-mcp-server-ja-milleks-see-on/)