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.
ROOTE glossaar
Liikumise ja andmete glossaar.
Lihtsad määratlused transpordi, lähiteenuste ja rakendustega seotud tööriistade mõistmiseks.
79 kuvatud määratlused
A
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.
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.
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.
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.
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.
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.
Autorsus
Andmeandja või allika nimetamine, mida näidatakse kasutuskogemuses vajadusel.
Näide
required=true märge peab kasutajaliideses püsima.
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.
Avamisajad
Ajad, mil koht teatab olema avatud. See ei kinnita reaalajas toimimist.
Näide
Ajutine sulgemine ei pruugi kajastuda regulaarsel avamisaegadel.
B
Bearer token
Juurdepääsu identifikaator Authorization päises vastavalt mehhanismile; tuleb hoida turvalises konfiguratsioonis.
Näide
Authorization: Bearer kasutatakse ilma token URL-is avaldamata.
E
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.
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.
Endpoint ehk API marsruut
API aadress ja operatsioon konkreetse funktsionaalsuse jaoks. Erinevad marsruudid tagastavad erinevaid tulemusi.
Näide
/v1/transit/nearby otsib transpordikohti.
G
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.
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.
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.
Geolokatsioon
Seadme või rakenduse poolt saadud geograafiline asukoht. See sõltub õigustest ja täpsusest.
Näide
Asukoha nupp küsib brauserilt luba.
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.
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.
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.
H
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.
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.
Huviobjekt (POI)
Tuvastatav koht, mis on otsingu jaoks kasulik, nt rajatis või seade. POI erineb aadressist.
Näide
Hotelli nimi otsitakse kui rajatist.
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.
I
Iframe
HTML element, mis laadib lehele dokumendi; eri domeenid piiravad vanemlehe ligipääsu sisule.
Näide
Otsingumuutused vajavad dokumenteeritud suhtlust vanemaga.
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.
J
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.
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.
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.
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.
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.
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.
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.
K
Kaardi suumi tase
Kaardivaate suurendustase. Kontorleerib kuvatavat ala, kuid ei asenda API päringu raadiust.
Näide
zoom=15 suumib kaarti.
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.
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.
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.
L
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.
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.
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.
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.
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.
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.
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.
M
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.
MCP host rakendus
Rakendus, mis haldab kasutajaliidest ja MCP kliente ning vastutab tulemuste kasutamise eest.
Näide
Sinu vestlusrakendus ühendab ROOTE serveriga.
MCP klient
Tehisintellekti komponent, mis suhtleb MCP serveriga ja haldab selle protokolli vahetust.
Näide
Klient edastab ROOTE otsingu argumente.
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.
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.
O
OpenAPI
Spetsifikatsioon HTTP API lepingu kirjeldamiseks struktureeritud dokumendis; abistab marsruutide, parameetrite ja vastuste valideerimisel.
Näide
ROOTE leping on avaldatud openapi.json failina.
Osaline tulemus (partial)
Tulemus sisaldab kasutatavaid andmeid piirangute või puudustega ning vastava hoiatusega.
Näide
Üks allikas vastab, teine on kättesaamatu.
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.
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.
P
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.
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.
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.
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.
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.
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.
Päritolu
Info, mille alusel saab kindlaks teha andmeallika ja selle tootmismeetodi, aidates tõlgendada ulatust.
Näide
Tulemus kannab allikat ja kogumise konteksti.
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.
R
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.
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.
S
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.
Streamable HTTP
MCP transpordimehhanism serveriga suhtlemiseks HTTP kaudu; tugi peab olema kliendis kontrollitud.
Näide
ROOTE kaugserver kasutab https://mcp.roote.ai/mcp.
Suunamine
Teenuse suuna või sihtkoha märge. See peab olema kontrollitud marsruudi ja pardale astumise kohaga.
Näide
Otsid trami sihtkohta, mitte vastassuunda.
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.
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.
T
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.
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.
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.
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.
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.
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.
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.
V
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.
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.
Ü
Ü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.
Sobivat määratlust ei leitud. Proovi teist sõna või eemalda filter.
Sügavamaks uurimiseks allikad
ROOTE spetsiifilised terminid pärinevad tema dokumenteeritud lepingutest. Standarditel ja protokollidel on oma ametlikud allikad.
Tagasi ressursside keskusesse