API
Sąsaja programoms naudotis kitos paslaugos funkcijomis pagal apibrėžtą sutartį. Aprašo įvestis ir laukiamas rezultatų formatas.
Pavyzdys
Programėlė ieško stotelių su ROOTE API pagalba.
ROOTE Žodynas
Mobilumo ir duomenų žodynas.
Paprasti apibrėžimai transportui, vietinėms paslaugoms ir įrankiams, kurie juos sieja su jūsų programėlėmis.
79 rodyti apibrėžimus
A
Aprėptis
Informacijos aprėptis ir pilnumas paieškoje ar šaltinyje. Dalinė aprėptis riboja galutines išvadas.
Pavyzdys
Sąrašas gali būti naudingas, bet neatspindi visų paslaugų.
Artimiausias išvykimas
Planuojamas artimiausias sustojimas ar išvykimas. Radus stotelę, dar nėra gavę jos artėjančių reisų.
Pavyzdys
Stotelių sąrašas ir artėjančių reisų sąrašas yra skirtingi rezultatai.
Asmuo su sumažėjusiu mobilumu – ASM
Asmuo, turintis nuolatinių arba laikinių judėjimo sunkumų. ASM žyma viena nėra išsami visų reikalaujamų pritaikymų apibūdinimui.
Pavyzdys
Rampa nėra visų kliūčių aprašymas.
Atvirkštinis geokodavimas
Vieta ar aprašymas gautas iš koordinačių. Rezultatai gali būti artima vieta, o ne tiksli adresų.
Pavyzdys
GPS taškas susiejamas su įskaitomu aprašymu.
B
Be stotelės — free-floating
Transporto priemonių sistema, kurioje įrangos nereikia imti ar palikti konkrečioje vietoje. Parkavimo zonos ir taisyklės nustatytos paslaugos teikėjo.
Pavyzdys
Paspirtuką reikia palikti leidžiamoje zonoje.
Bendra mobilumo paslauga
Paslaugų rinkinys, suteikiantis prieigą prie transporto priemonių, kurias naudojasi keli vartotojai, o ne nuosavybės pagrindu.
Pavyzdys
Mieste siūlomi nuomai dviračiai ir paspirtukai.
D
Dalinis rezultatas — partial
Rezultatas su naudotinais duomenimis, bet kai kuriais trūkumais ar įspėjimais, kurie turi būti pateikti.
Pavyzdys
Vienas šaltinis atsako, o kitas nepasiekiamas.
Darbo laikas
Laikotarpiai, kai vieta deklaruoja esanti atvira. Neviešas patvirtinimas, tad realiu laiku gali būti neatitinkantis.
Pavyzdys
Laikinai uždarymas gali nebūti atspindėtas tvarkaraščiuose.
DI asistento halucinacija
Nepatvirtinta informacija, pateikiama taip, tarsi būtų žinoma. Mobilume tai gali būti sugalvotas tvarkaraštis ar prieinamumas.
Pavyzdys
Asistentas praneša apie reisą, kai duomenų įrankis pateikė tik sustojimą.
Domina vieta — POI
Naudinga paieškai atpažįstama vieta, pvz., įstaiga ar įrenginys. POI skiriasi nuo adresų sistemos.
Pavyzdys
Viešbutis gali būti ieškomas kaip įstaiga.
Duomenimis pagrįstas atsakymas — grounding
Atsakymas paruoštas remiantis gautais ar pateiktais duomenimis. Nebuvimai ir rezervacijos privalo būti matomi.
Pavyzdys
Asistentas naudoja pateiktas vietas be spekuliacijų apie tvarkaraščius.
Duomenų šviežumas
Informacijos aktualumo reitingas pagal datos žymes ir sutarties taisykles. Užklauso laikas ne visada išreiškia tikrą šviežumą.
Pavyzdys
Dabar gautas skaitiklis gali atspindėti seną stebėjimą.
Dviračių stotelė
Organizuota vieta, kur galima pasiimti arba grąžinti bendro naudojimo dviračius. Koordinatės, pajėgumai ir prieinamumas aprašo skirtingas stotelės savybes.
Pavyzdys
Stotelė gali būti rodoma žemėlapyje, bet šiuo metu tuščia.
E
Elektrinis dviratis
Dviratis, kurio pedalus papildo variklis pagal jo savybes. Mobilumo duomenyse variklio tipas ir baterija gali būti nurodomi atskirai.
Pavyzdys
Stotelėje gali būti atskirti mechaniniai ir elektriniai dviračiai.
G
Galinis sustojimas
Maršruto pabaiga. Linijos gali turėti variantų su skirtingais galais.
Pavyzdys
Trumpesnis reisas baigiasi prieš įprastą galą.
Galinis taškas — API maršrutas
API adresas ir veiksmas konkrečiai funkcijai. Kiekvienas maršrutas gali grąžinti skirtingų rezultatų grupes.
Pavyzdys
/v1/transit/nearby ieško transporto vietų.
Galiojimo laikas — TTL
Laikotarpis taikomas duomenų galiojimui ar atnaujinimui talpykloje pagal sutartį. Vien šis laikas neatspindi stebėjimo momento.
Pavyzdys
Pasibaigusi talpykla turi būti atnaujinta pagal numatytą politiką.
GBFS
Viešas standartinis bendros mobilumo duomenų formatas. Apima sistemas, stoteles, transporto priemones ir jų būseną, priklausomai nuo versijos ir srautų.
Pavyzdys
Stotelės informacija ir prieinamumo skaitikliai atskirti.
Gėlas vanduo
Vanduo, tinkamas žmogaus vartojimui. Vandens taškas ar fontanas neturi būti pažymėti kaip geriami be aiškios informacijos.
Pavyzdys
Įrangos tipas ir atributai turi būti skiriami.
Geografinė vieta
Geografinės pozicijos gavimas įrenginiu ar programėle. Priklauso nuo leidimų ir tikslių duomenų.
Pavyzdys
Vietos nustatymo mygtukas prašo naršyklės leidimo.
Geografinis atstumas
Atstumas tarp taškų, apskaičiuotas pagal paslaugos metodą. Nėra maršruto atstumas ar pėsčiųjų laikas.
Pavyzdys
Netoliese esanti vieta gali būti pasiekiama tik aplinkiniu keliu.
Geokodavimas
Paieška, paverčianti adresą arba geografiją kandidatų sąrašu su koordinatėmis. Galimi keli atitikimai tokiam įrašui.
Pavyzdys
Du miestai gali turėti gatvę su tokiu pačiu pavadinimu.
GPS koordinatės
Reikšmės žemės taškui aprašyti, dažno pagal platumą ir ilgumą. Eiliškumas turi būti nurodytas pagal sąsają.
Pavyzdys
Artumo paieška gauna dvi atskiras koordinates.
Grąžinimas
Transporto priemonės naudojimo pabaiga pagal paslaugos taisykles. Grąžinimo galimybės gali skirtis nuo paėmimo galimybių.
Pavyzdys
Stotelė leidžia išvykti, bet grąžinimo vietos nebėra.
GTFS Realtime — GTFS-RT
Standartinis formatas realaus laiko atnaujinimams: reisų pakeitimams, transporto priemonių vietoms, įspėjimams. Publikuojamos kategorijos priklauso nuo duomenų teikėjo.
Pavyzdys
Pozicijų srautas nereiškia realaus laiko daugybei stotelių.
GTFS tvarkaraštis
Standartinis transporto paslaugų planavimo formatas: stotelės, linijos, reisai, kalendoriai ir grafikai. Nenumato realaus laiko atnaujinimų.
Pavyzdys
Tvarkaraštyje numatyti sustojimai susieti su reisais ir paslaugos dienomis.
H
HTTP būsena
Kodas, nurodantis užklausos rezultatą HTTP lygmenyje. Privaloma tikrinti ir duomenų turinį bei verslo statusą.
Pavyzdys
HTTP 200 gali turėti errors verslo logiką.
I
Iframe
HTML elementas įkeliantis dokumentą puslapyje. Kitame domene tėvinis puslapis negali laisvai skaityti iframe turinio.
Pavyzdys
Paieškos pakeitimams būtinas dokumentuotas keitimasis tarp iframe ir tėvo.
Ilguma
Koordinatė, nurodanti poziciją į rytus arba vakarus nuo pagrindinio meridiano laipsniais pagal ROOTE pavyzdžius. Galimos reikšmės nuo −180 iki 180.
Pavyzdys
Ilguma gali būti perduodama kaip lon arba dokumentuotu alias lng.
Intermodalumas
Kelių transporto rūšių seka vienoje kelionėje. Kiekvienas segmentas turi savus tvarkaraščius, sąlygas ir prieigą.
Pavyzdys
Pirmas važiuojate tramvajumi, paskui tęsiate pėsčiomis.
Į
Įkrovimo stotelė
Įrenginys, leidžiantis pakrauti suderinamą transporto priemonę. Vieta nenurodo įrenginio prieinamumo ar jungties suderinamumo.
Pavyzdys
Įkrovimo vietos vieta ir naudojimo būsena yra atskiros informacijos dalys.
Įterpti — integruotas žemėlapis
Išorinės patirties įterpimas puslapyje, pavyzdžiui, žemėlapis iframe. Parametrai ir leidimai lemia kontekstą.
Pavyzdys
ROOTE iframe rodo dviračius Bordo miesto apylinkėje.
J
JSON
Struktūruotas tekstinis formatas su objektais, masyvais, tekstu ir skaičiais. Sintaksiškai galimas, bet neatitinkantis API schemos failas neprivalo būti tinkamas.
Pavyzdys
stations kolekcija turi turėti laukus ir tipo aprašymą.
K
Kilmė
Duomenų kilmės ir jų gavimo būdo identifikavimo informacija pagal sutartį. Pagal tai galima interpretuoti pateiktą informaciją.
Pavyzdys
Rezultatas išsaugo šaltinį ir rinkimo kontekstą.
Kryptis
Nurodo paslaugos kryptį arba tikslą. Reikalinga patvirtinti pagal maršrutą ir įlaipinimo vietą.
Pavyzdys
Ieškote tramvajaus į savo kryptį, ne priešinga.
L
Laiko žyma
Laiko žymuo, susijęs su duomeniu ar įvykiu. Reikšmė priklauso nuo konteksto: stebėjimo, atnaujinimo, gavimo ar galiojimo laikas.
Pavyzdys
source_updated_at ir received_at aprašo skirtingus procesus.
M
Maršrutas
Transporto paslauga tinkle su vienu ar daugiau maršrutų ar variantų. Linijos pavadinimas ne visada nurodo tikslų kryptį.
Pavyzdys
Tokia pati linija gali turėti kelis galinius sustojimus.
MCP — Model Context Protocol
Protokolas, leidžiantis DI programai bendrauti su serveriais, siūlančiais įrankius ar kontekstą. Neapibrėžia atsakymų kokybės vienu.
Pavyzdys
Asistentas atranda ROOTE paieškos įrankius.
MCP įrankis
Vykdoma funkcija, aprašyta vardu, funkcija ir argumentų schema. Asistentas turi naudoti pagal šią schemą priimamus duomenis.
Pavyzdys
geocode priima adresą; transit_nearby priima koordinates.
MCP klientas
DI programos komponentas, kuris bendrauja su MCP serveriu. Valdo protokolo mainus šiai jungčiai.
Pavyzdys
Klientas perduoda paieškos parametrus ROOTE serveriui.
MCP pagrindinė programėlė
Programėlė, kuri vykdo vartotojo sąveiką ir valdo vieną arba kelis MCP klientus. Atsakinga už rezultatų panaudojimą.
Pavyzdys
Jūsų pokalbių programėlė jungiasi prie ROOTE serverio.
MCP serveris
Programa, pateikianti MCP protokolo funkcijas. Realiai paskelbti įrankiai nustato, ką klientas gali naudoti.
Pavyzdys
tools/list leidžia peržiūrėti turimus įrankius.
Miesto paslauga
Įrenginys ar paslauga netoliese, pvz., tualetai, vandens taškas ar įkrovimo stotelė. Informacija gali būti nevisiška.
Pavyzdys
Netoliese rastas rezultatas aprašo žinomą paslaugą.
N
Nešėjo žetonas
Prieigos identifikatorius Authorization antraštėje pagal sutartį. Privalo būti saugomas saugiai.
Pavyzdys
Authorization: Bearer naudojama be žetono viešoje URL vietoje.
Nežinoma reikšmė — null
Reikšmės nebuvimas su null įrašu pagal sutartį. Neturėtų būti keičiamas į nulį, false ar įrodymą apie nebuvimą.
Pavyzdys
Dviračių skaitiklis null nereiškia, kad stotelė tuščia.
Numatomas laikas
Apskaičiuotas būsimo sustojimo laikas, priklauso nuo turimų duomenų ir gali keistis.
Pavyzdys
Numatytas 8:10 sustojimas dabar prognozuojamas 8:14.
O
OpenAPI
Specifikacija, aprašanti HTTP API sutartį struktūruotame faile. Padeda tikrinti maršrutus, parametrus, atsakymus ir schemas.
Pavyzdys
ROOTE sutartis pateikta openapi.json faile.
P
Paieškos centras
Taškas, nuo kurio vykdoma artumo paieška ir apskaičiuojami atstumai. Gali skirtis nuo žemėlapio centro.
Pavyzdys
Kamera juda, bet paieška lieka surišta su Bordo miestu.
Paieškos spindulys
Atstumas nuo centro taško, apibrėžiantis paieškos ribas. Matuoklė ir ribos priklauso nuo sąsajos ir jos sutarties.
Pavyzdys
radius=600 prašo 600 metrų spindulio REST pavyzdyje.
Pasenę duomenys — stale
Informacija, laikoma per sena pagal sutartį ar galiojimo politiką. Gali būti saugoma kaip istorija, bet neaccess kaip šviežia.
Pavyzdys
Vartotojo sąsaja rodo, kad prieinamumas turi būti atnaujintas.
Paslaugos kalendorius
Informacija apie paslaugos vykdymo dienas su galimomis išimtimis. Tvarkaraščiai turi būti interpretuojami kartu su kalendoriumi.
Pavyzdys
Savaitės dienomis numatytas reisas gali neveikti sekmadienį.
Paslaugos tipas
Kategorija pasirinkti arba apibrėžti miesto paslaugą. Priimtinos reikšmės priklauso nuo sąsajos ir jos schemos.
Pavyzdys
ROOTE API paslaugos naudoja types=toilets tualetams.
Peronas
Vietos ar transporto įlaipinimo taškas. Netoli esantys skirtingi peronai gali tarnauti skirtingoms kryptims ar paslaugoms.
Pavyzdys
Abiejų eismo krypčių linija gali naudotis skirtingais peronais.
Persėdimas
Pereiti nuo vienos paslaugos ar transporto rūšies prie kitos kelionėje. Netoli esantys sustojimai nebūtinai leidžia patogiai persėsti.
Pavyzdys
Reikia laiko nueiti nuo vieno perono prie kito ir palaukti.
Platuma
Koordinatė, nurodanti poziciją į šiaurę arba pietus nuo pusiaujo laipsniais pagal ROOTE pavyzdžius. Galimos reikšmės nuo −90 iki 90.
Pavyzdys
Paieškos taško platuma perduodama kaip lat.
Pratęsimo limitas — timeout
Operacijos sutrumpinimas, kai trunka per ilgai. Reiškia užklausos nepabaigimą, o ne rezultatų nebuvimą.
Pavyzdys
Programėlė siūlo bandyti dar kartą vietoj tuščios rezultatų lentelės.
Prieinamumas
Būsena ar kiekis, parodantis, kas gali būti naudojama pagal žinomas žinias. Stebimas prieinamumas gali keistis ir nereiškia rezervacijos.
Pavyzdys
Trys dviračiai stotelėje reiškia jų buvimą, bet ne rezervaciją.
Prieinamumas
Savybės, leidžiančios naudotis vieta ar paslauga pagal žmogaus poreikius. Nežinoma informacija nereiškia nei pasiekiama, nei nepasiekiama.
Pavyzdys
Ratuko prieinamumas gali būti nurodytas arba nežinomas.
Priskyrimas
Duomenų tiekėjo ar šaltinio paminėjimas. Reikalinga rodyti vartotojo sąsajoje, jei reikalaujama.
Pavyzdys
required=true atributas turi būti matomas sąsajoje.
R
Realaus laiko duomenys
Atnaujinta informacija, atspindinti naujausią situaciją arba naudojama prognozėms. Svarbu vertinti duomenų šviežumą; realiu laiku nereiškia garantuoto momentinio atnaujinimo.
Pavyzdys
Prognozuojamas sustojimas perskaičiuotas pagal naujus duomenis.
Reisas
Transporto paslaugos vykdymas priskiriamas konkrečiam maršrutui ir sustojimams. GTFS kūriniuose reisas susijęs su linija ir paslaugos kalendoriumi.
Pavyzdys
Du vienos linijos išvykimai yra du atskiri reisai.
REST API
HTTP pagrindu veikianti sąsaja, naudojant resursus ir interneto mechanizmus. Sutartis aprašo maršrutus, metodus ir duomenų formatus.
Pavyzdys
Paieška vykdoma nurodytu GET maršrutu.
S
Savitarna dviračiai
Paslauga leidžianti laikinai pasiskolinti dviratį pagal operatoriaus sąlygas. Gali veikti su stotelėmis arba be jų.
Pavyzdys
Surandate dviratį ir naudojatės atitinkama nuomos paslauga.
Stebėjimas
Būsena ar įvykis, užfiksuotas konkrečiu laiku. Skirtina nuo planinių ar prognozuotų įvykių.
Pavyzdys
Faktinis autobuso pravažiavimas gali skirtis nuo paskelbto.
Streamable HTTP
MCP transportas, leidžiantis keistis duomenimis per HTTP su nuotoliniu serveriu. Klientas turi palaikyti šį protokolą.
Pavyzdys
ROOTE nuotolinis serveris naudoja https://mcp.roote.ai/mcp.
Sutrikimas
Įvykis, paveikiantis transporto paslaugą, pvz., nutrūkimas arba maršruto pakeitimas. Realų poveikį nurodo vieta ir laikas.
Pavyzdys
Įspėjimas gali būti galiojantis tik tam tikromis valandomis linijoje.
T
Talpykla
Laikinosios atminties saugykla, skirta dubliuotoms užklausoms išvengti. Talpykloj saugoma duomenų kilmė ir laiko kontekstas.
Pavyzdys
Dvi identiškos užklausos gali naudoti vieną galiojančią atsakymą.
Tik skaitymui
Gali tik peržiūrėti informaciją, be teisės keisti ar daryti veiksmus. Peržiūra neužrezervuoja ar neatidaro transporto priemonių.
Pavyzdys
ROOTE duomenų įrankiai naudojami informacijos peržiūrai.
Transporto priemonės paėmimas
Veiksmas, pradėti naudotis transporto priemone. Teigiamas skaitiklis ne visuomet reiškia, kad paėmimas leidžiamas.
Pavyzdys
Dviračiai yra, bet stotelė gali nebeleisti jų nuomotis.
Transporto stotelė
Vieta, kur transporto paslauga paima ar išlaipina keleivius. Tuščia stotelė nebūtinai pateikia artėjančių reisų laikus.
Pavyzdys
Autobuso stotelė be išvykimo tvarkaraščio.
Tuščias rezultatas — empty
Paieška neranda jokių objektų nurodytoje srityje. Tai nereiškia, kad paslaugų išvis nėra už ribų.
Pavyzdys
Lentelėje nėra stotelių pagal filtrus.
Tvarkaraščio laikas
Planuojamas laikas paslaugos plane konkrečiai datai ir reisui. Nereprezentuoja realaus laiko padėties.
Pavyzdys
Išvykimas numatytas 8:10 pagal grafiką.
Tvirtinimo vieta
Stationo įranga, prie kurios galima pritvirtinti dviratį. Jos buvimas negarantuoja galimybės dviratį palikti būtent tuo metu.
Pavyzdys
Grąžinti dviratį reikia turėti laisvą vietą.
U
Užklausos injekcija
Bandymai naudoti išorinį turinį paslaugos ar asistento elgsenai pakeisti. Teikėjų aprašymai privalo būti duomenys, o ne komandų rinkinys.
Pavyzdys
Paslėpta instrukcija vietos pavadinime neturi būti vykdoma.
Užklausos parametras
Reikšmė URL dalyje po klaustuku. Pavadinimą ir formatą apibrėžia sąsaja.
Pavyzdys
modes=bus,tram pasirinks autobusų ir tramvajų naudotojus URL.
Užklausų dažnio limitas — rate limit
Apribojimas, kiek užklausų per tam tikrą laiką leidžiama paslaugai. Taisyklės priklauso nuo aktyvios sutarties.
Pavyzdys
HTTP 429 kodas prašo laikytis atnaujinimo gairių.
V
Viešieji tualetai
Viešam naudojimui skirti tualetai pagal vietos sąlygas. Jų buvimas duomenyse negarantuoja, kad yra nemokami, atidaryti ar prieinami.
Pavyzdys
Prieš einant patikrinkite nurodytas sąlygas.
Ž
Žemėlapio priartinimas
Parodymo lygio žemėlapyje rodiklis. Kontroliuoja matomumą, bet nepakeičia API užklausos atstumo.
Pavyzdys
zoom=15 artina žemėlapio peržiūrą.
Nėra atitinkančių apibrėžimų. Pabandykite kitą žodį arba pašalinkite filtrą.
Gilintis į šaltinius
ROOTE specifiniai terminai yra pagal jo dokumentuotas sutartis. Standartai ir protokolai turi savo oficialius šaltinius.
Atgal į išteklių centrą