Aina ya huduma
Kategoria inayoelezwa kuchagua au kuelezea huduma za mijini. Thamani zinazokubaliwa zinategemea muundo wa interface.
Mfano
API za Huduma za ROOTE hutumia types=toilets kwa vyoo.
Kamusi ya ROOTE
Kamusi ya usafiri na data.
Maana rahisi kuelewa usafiri, huduma za karibu na zana zinazounganisha kwa programu zako.
79 maana zilizoonyeshwa
A
API
Kiolesura kinachomruhusu programu kutumia huduma za programu nyingine kupitia mkataba uliowekwa. Hutoa maelezo ya pembejeo na majibu yanayotarajiwa.
Mfano
Programu inatafuta vituo kwa API ya ROOTE.
API REST
Njia ya kiolesura cha HTTP inayotumia rasilimali na mbinu za wavuti. Mkataba wa API unaelezea njia zake, mbinu na maonyesho.
Mfano
Utafutaji hutumwa kwa njia ya GET iliyoandikwa.
B
Baiskeli ya umma
Huduma inayokuwezesha kukopa baiskeli kwa muda mfupi kulingana na masharti ya mtoaji. Inaweza kuwa na vituo au magari bila vituo.
Mfano
Unatambua baiskeli na kutumia huduma husika ya kukodisha.
Baiskeli yenye msaada wa umeme
Baiskeli yenye motor inayosaidia kukimbia kulingana na sifa zake. Katika data za usafiri aina ya nguvu na betri vinaweza kuorodheshwa tofauti.
Mfano
Kituo kinaweza kutofautisha baiskeli za kawaida na za umeme.
Bandari ya abiria
Sehemu au mahali pa kupanda gari la usafiri. Bandari kadhaa zilizo karibu zinaweza kuhudumia mwelekeo au huduma tofauti.
Mfano
Mwelekeo wa njia mbili unaweza kutumia bandari tofauti.
Bila kituo — free-floating
Mpangilio ambapo magari hayaambatani na vituo maalum kwa kuchukua au kurudisha. Sheria za maegesho na maeneo yanabaki kama kwa huduma.
Mfano
Skuta inapaswa kurudishwa eneo linaloruhusiwa.
C
Cache
Hifadhi ya muda mfupi ya majibu ili kuepuka utafutaji wa kurudiwa mara nyingi. Thamani iliyohifadhiwa inahifadhi chanzo na muktadha wa muda.
Mfano
Maombi mawili sawa yanaweza kutumia majibu yaliyo halali.
Chanzo
Taarifa zinazoonyesha asili ya data na jinsi zilivyopatikana kulingana na makubaliano. Zinasaidia kuelewa muktadha.
Mfano
Matokeo huhifadhi chanzo na muktadha wa ukusanyaji.
D
Data iliyochakaa — stale
Taarifa inachukuliwa kuwa ya zamani kulingana na masharti au sera ya uhalali. Inaweza kuhifadhiwa kama kumbukumbu, isiwe ya sasa.
Mfano
Interface inaonyesha upatikanaji unapaswa kusasishwa.
Data za muda halisi
Taarifa zinaonyesha hali mpya au kutunza makadirio. Ubora inapaswa kukaguliwa; muda halisi si lazima hasa au thabiti.
Mfano
Makadirio ya kufika yanapangwa tena kwa data mpya.
E
Embed — ramani iliyoingizwa
Kuingiza uzoefu wa nje kwenye ukurasa, mfano ramani kwenye iframe. Vigezo na ruhusa huamua muktadha wa matumizi.
Mfano
Iframe ya ROOTE inaonyesha baiskeli karibu Bordeaux.
Endpoint — njia ya API
Anwani na operesheni zinazotolewa na API kwa huduma fulani. Njia tofauti zinaweza kutoa kundi tofauti la matokeo.
Mfano
/v1/transit/nearby hufuatilia maeneo ya usafiri.
G
GBFS
Muundo wa kawaida wa data za umma za usafiri wa pamoja. Kutegemea toleo na mtiririko, unaelezea mifumo, vituo, magari na hali zao.
Mfano
Taarifa za vituo na hesabu za upatikanaji ni tofauti.
GTFS Muda Halisi — GTFS-RT
Muundo wa kawaida unaoruhusu kutuma sasisho za safari, nafasi za magari na onyo. Aina za taarifa zinazotolewa hutegemea mtengenezaji.
Mfano
Mtiririko wa nafasi hauhakikishi makadirio kwa vituo vyote.
GTFS Ratiba
Muundo wa kawaida wa maelezo ya usafiri uliopangwa: vituo, mistari, safari, ratiba na marudio. Hauwezi moja kwa moja kutoa sasisho za muda halisi.
Mfano
Safari zilizopangwa zinaunganishwa na mistari na siku za huduma.
H
Hali ya HTTP
Nambari inayoonyesha matokeo ya ombi kwa kiwango cha HTTP. Inapaswa kuunganishwa na uthibitisho wa maudhui na hali ya biashara.
Mfano
HTTP 200 inaweza kuwa na kosa la hali ya biashara.
HTTP inayoeleweka mfululizo
Usafirishaji wa MCP unaoruhusu mawasiliano na seva ya mbali kupitia HTTP. Uunganishaji wake hupimwa katika mteja unaotumika.
Mfano
Seva ya mbali ya ROOTE hutumia https://mcp.roote.ai/mcp.
Huduma za miji
Vifaa au huduma muhimu karibu na mahali kama choo, chanjo au kisanduku cha kuchaji. Sifa zinaweza kuwa hazikamilifu.
Mfano
Matokeo ya karibu yanaelezea huduma na taarifa zilizopo.
I
Iframe
Kipengele cha HTML kinachopakia hati ndani ya ukurasa. Katika maeneo tofauti, ukurasa mkuu hauwezi kusoma hali ya hati iliyochapishwa.
Mfano
Mabadiliko ya utafutaji yanahitaji mawasiliano yaliyodhibitiwa kurudi kwa mwenyeji.
J
Jibu la sehemu — partial
Matokeo yenye taarifa zinazoweza kutumika lakini zikiwa na ukomo au vipengele vinavyokosekana vilivyoonyeshwa. Inapaswa kuambatana na onyo la maana.
Mfano
Chanzo kimoja kinajibu huku kingine kikiwa hakipatikani.
Jibu linalotegemea data — grounding
Ujenzi wa jibu kutoka kwa taarifa halisi zilizopatikana au kutolewa. Mashamba yanayokosekana na makataa yanapaswa kuonekana.
Mfano
Msaidizi anajumuisha maeneo yaliyopatikana bila kuunda ratiba zao.
JSON
Muundo wa maandishi uliorahisishwa unaotumia vituo, orodha, mistari na nambari. JSON halali kisinati inaweza isiambatanishe na muundo wa API.
Mfano
Mkusanyiko wa vituo unahitaji aina na mashamba yanayotarajiwa.
K
Karatasi za GPS
Thamani zinazoonyesha mahali kijiografia, kawaida kwa latitudo na longitudo. Mpangilio unapaswa kufafanuliwa kwenye interface.
Mfano
Utafutaji wa karibu huchukua karatasi mbili tofauti.
Kikomo cha maombi — rate limit
Kuzuia idadi ya maombi yanayoruhusiwa na huduma kwa kipindi. Sheria za uanzishaji zinategemea mkataba unaotumika.
Mfano
Msimbo wa 429 unaagiza kuheshimu sheria za kuanzisha upya.
Kipande cha kuunganishia
Kifaa cha kituo ambacho baiskeli inaweza kushikika. Posto lake halihakikishi kuruhusu kurudisha wakati huo.
Mfano
Nafasi ya kurudisha baiskeli inapaswa kupatikana na kuitumiwa.
Kipengele cha ombi
Thamani inayotumwa kwenye sehemu ya URL baada ya alama ya kuuliza. Jina na muundo hutegemea interface inayotumika.
Mfano
modes=bus,tram huchagua aina kwenye URL inayolingana.
Kitambulisho cha Bearer
Kitambulisho cha kufikia kinachotumwa kwenye kichwa cha Authorization kulingana na utaratibu uliopangwa. Kinapaswa kuhifadhiwa kwa usalama.
Mfano
Authorization: Bearer hutumiwa bila kuchapisha token kwenye URL.
Kituo cha baiskeli
Eneo lililopangwa kwa kuchukua au kurudisha baiskeli za pamoja. Kuwepo, uwezo na upatikanaji ni vipengele tofauti vya kituo.
Mfano
Kituo kinaweza kuonekana kwenye ramani lakini kuwa tupu kwa muda.
Kituo cha kuchaji
Kifaa kinachoruhusu kuchaji gari linalooana. Upatikanaji wa kituo au ulinganifu wa kiunganishi havihakikishwi.
Mfano
Mahali pa kuchaji na hali yake ni taarifa tofauti.
Kituo cha mwisho
Mwisho wa njia ya usafiri. Mstari unaweza kuwa na mabadiliko yenye vituo vya mwisho tofauti.
Mfano
Huduma fupi inamaliza kabla ya kituo cha kawaida.
Kituo cha usafiri
Eneo ambapo huduma ya usafiri huwapokea au kuwasafirisha abiria. Kituo kisichofunikwa hakipe basi ratiba ya mara inayofuata.
Mfano
Kituo cha basi kinarudishwa bila ratiba ya kuondoka.
Kubadilisha
Kubadilisha kutoka huduma au aina moja ya usafiri kwenda nyingine katika safari moja. Kuwa karibu kwa vituo viwili hakimaanishi kubadilika kwa urahisi.
Mfano
Ni lazima upange kwenda bandari na kusubiri.
Kuchukua gari
Hatua ya kuanza kutumia gari. Kielezi chenye thamani chanya hakitoshi ikiwa huduma imesema kuchukua hakiwezi sasa.
Mfano
Baiskeli zipo, lakini kituo kinaweza kutoruhusu kukodisha.
Kuingiza maagizo yasiyotarajiwa
Jaribio la kutumia maudhui ya nje kubadilisha maagizo ya msaidizi. Maelezo ya mtoaji yanapaswa kubaki kama data, si maagizo.
Mfano
Maagizo yaliyojificha kwenye jina la mahali hayapaswi kutekelezwa.
Kuinua ramani
Kiwango cha ukaribu wa ramani. Hudhibiti maonyesho na si mbadala wa mduara wa API.
Mfano
zoom=15 hukaribia maoni ya ramani.
Kuondoka kuja
Kuondoka au kufika kuja kwa huduma mahali fulani. Kupata kituo si kutafuta kuondoka kuja kwake.
Mfano
Orodha ya vituo na orodha ya kuondoka ni matokeo tofauti.
Kurudisha gari
Kumaliza matumizi ya gari kulingana na sheria za huduma. Mipaka ya kurudisha inaweza kuwa tofauti na ya kuchukua.
Mfano
Kituo kinaruhusu kuondoka lakini hakina nafasi ya kurudisha.
L
Latitudo
Karatasi inayosema nafasi kaskazini au kusini ya katikati ya dunia, kwa digrii katika mifano ya ROOTE. Thamani halali ni −90 hadi 90.
Mfano
Latitudo ya eneo la utafutaji hutumwa kwa lat.
Longitudo
Karatasi inayoelezea nafasi mashariki au magharibi ya meridiani ya rejea. Mifano ya ROOTE hutumia digrii kati ya −180 na 180.
Mfano
Longitudo inaweza kutumwa kwa lon au jina jingine linalotambuliwa lng.
M
Mahali kijiografia
Kupata eneo la kijiografia kwa kifaa au programu. Inategemea ruhusa na usahihi unaopatikana.
Mfano
Kitufe cha eneo kinahitaji idhini ya kivinjari.
Maji safi ya kunywa
Maji yaliyoelezwa kama salama kwa matumizi ya binadamu. Sehemu ya maji au kisima haipaswi kuonekana kama salama bila taarifa ya wazi.
Mfano
Aina ya kifaa na sifa zake zinapaswa kutofautishwa.
Matatizo ya huduma
Tukio linaloathiri huduma ya usafiri kama kusitishwa au kubadilika kwa njia. Athari zake zinapaswa kusomwa ndani ya kipindi na eneo lililotangazwa.
Mfano
Onyo linaweza kuzingatia mstari tu kwa saa fulani.
Matokeo tupu — empty
Utafutaji usiorudisha entiti yoyote ndani ya eneo la kuangalia. Hii haimaanishi kuwa huduma haina mahali pengine.
Mfano
Hakuna kituo kilipatikana kwa vichujio vilivyotumika.
MCP — Protocol ya Muktadha wa Mfano
Itifaki inayoifanya programu ya AI kuwasiliana na seva zinazotoa zana au muktadha. Haiamli ubora wa data inayorudishwa peke yake.
Mfano
Msaidizi anakuta zana za utafutaji za ROOTE.
Mduara wa utafutaji
Umbali kuzunguka msingi wa utafutaji kutumika kuweka mipaka. Kipimo na mpaka hutegemea makubaliano ya njia au zana.
Mfano
radius=600 inaomba mduara wa mita 600 katika mfano wa REST.
Msingi wa utafutaji
Sehemu kutoka ambapo utafutaji wa karibu hufanywa na umbali unahesabiwa. Inaweza kutofautiana na katikati ya ramani.
Mfano
Camera inasogea lakini utafutaji unabaki katikati ya Bordeaux.
Mstari wa usafiri
Huduma ya usafiri iliyoainishwa ndani ya mtandao, ikiwa na njia au mabadiliko kadhaa. Jina la mstari halitoshi kuelewa mwelekeo sahihi.
Mfano
Mstari mmoja unaweza kuwa na vituo vya mwisho vingi.
Mteja wa MCP
Sehemu ya programu ya AI inayowasiliana na seva ya MCP. Husimamia mawasiliano ya itifaki kwa muunganisho huu.
Mfano
Mteja hutuma hoja za utafutaji kwa ROOTE.
Mtu mwenye ulemavu wa kusogea — PMR
Mtu anayeonyesha ugumu wa kusogea, wa kudumu au wa muda mfupi. Kumbukumbu ya PMR siyo yote kuhusu upatikanaji na vifaa vinavyohitajika.
Mfano
Kuwepo kwa rampa hakutoa picha kamili ya vizuizi.
Muda uliakisiwa
Makadirio ya muda wa kuwasili kunakotoka taarifa za sasa. Huweza kubadilika punde taarifa mpya zinapopatikana.
Mfano
Kuondoka kumewekwa saa 8:10 sasa kukadiriwa kuwa 8:14.
Muda uliopangwa
Muda uliopangwa katika ratiba kwa tarehe na kituo fulani. Hauruhusu kuonyesha hali halisi ya gari.
Mfano
Kuondoka kumewekwa saa 8:10 kwenye ratiba.
Muda wa kupiga chapa
Muda uliounganishwa na data au tukio. Maana yake hutegemea shamba: uchunguzi, sasisho, kupokea au kumalizika.
Mfano
source_updated_at na received_at hazielezei hatua moja.
Muda wa kusubiri umeshindikana — timeout
Kukatizwa kwa kusubiri kupita muda uliopangwa kwa operesheni. Inaonyesha utafutaji haujakamilika, si kutokuwepo kwa matokeo.
Mfano
Programu inapendekeza jaribu tena badala ya onyesha orodha tupu.
Muda wa uhalali — TTL
Muda wa kudhibiti uhalali au marekebisho ya data kwenye cache, kwa mujibu wa makubaliano. Haionyeshi peke yake wakati wa chanzo cha uchunguzi.
Mfano
Cache iliyokwisha ni lazima ifuatwe na sera ya usasishaji.
Mwelekeo
Onyo la mwelekeo au mahali pa mwisho wa huduma. Inapaswa kuthibitishwa na njia na mahala pa kupanda.
Mfano
Unatafuta tramu kuelekea mahali ulipoenda, si mwelekeo mwingine.
O
OpenAPI
Mipango inayoelezea mkataba wa API ya HTTP kwa hati iliyopangwa. Husaidia kusahihisha njia, vigezo, majibu na miundo.
Mfano
Mkataba wa ROOTE umetangazwa ndani ya openapi.json.
P
Programu mwenyeji wa MCP
Programu inayoshughulikia muingiliano na mtumiaji na kusimamia mteja au zaidi wa MCP. Inabaki na wajibu wa matumizi ya matokeo katika uzoefu wake.
Mfano
Programu yako ya mazungumzo inaunganisha seva ya ROOTE.
R
Ratiba ya huduma
Taarifa zinazoelezea siku huduma ya usafiri inapatikana, ikiwa na ubaguzi fulani. Ratiba inapaswa kueleweka pamoja na ratiba hii.
Mfano
Safari inayopangwa kwa wiki haina lazima iwe Jumapili.
S
Saa za ufunguzi
Muda mahali husema ni wazi. Haya si uthibitisho wa moja kwa moja wa hali ya sasa.
Mfano
Kufungwa kwa muda kunaweza kutoonekana kwenye saa za kawaida.
Safari
Uendeshaji wa huduma ya usafiri unaohusiana na njia na vituo. Katika GTFS, safari huunganishwa na mstari na ratiba ya huduma.
Mfano
Kuondoka mara mbili mfululizo kwa mstari mmoja ni safari mbili.
Sehemu ya kuvutia — POI
Mahali panapotambulika na muhimu kwa utafutaji, kama taasisi au kifaa. POI ni tofauti na anwani ya posta tu.
Mfano
Jina la hoteli linaweza kutafutwa kama taasisi.
Seva ya MCP
Programu inayotoa uwezo kulingana na itifaki ya MCP. Zana zinazotajwa na seva huelezea kile ambacho mteja anaweza kuitumia.
Mfano
tools/list hutoa orodha ya zana zinazopatikana.
Soma pekee
Uwezo wa kusoma bila kubadilisha taarifa zinazopatikana na zana. Kusoma upatikanaji hakuhifadhi, kufungua au kukodisha gari.
Mfano
Zana za Data za ROOTE hutumika kusoma taarifa.
T
Thamani isiyojulikana — null
Kutokuwepo kwa thamani inayojulikana kwa mkataba unaotumia null kwa maana hiyo. Haipaswi kubadilishwa na sifuri, potofu au ushahidi wa ukosefu.
Mfano
Kielezi cha baiskeli null hakimaanishi kituo kiko tupu.
U
Uchunguzi
Hali au tukio lililotambuliwa kwa wakati maalum. Linapaswa kutofautishwa na tukio linalopangwa au makadirio.
Mfano
Kuondoka kwa basi halisi kunaweza kutofautiana na makadirio.
Uenezi
Kipimo na ukamilifu wa data zilizopo kwa utafutaji au chanzo. Uenezi usio kamili huzuia hitimisho kuu.
Mfano
Orodha inaweza kusaidia ingawa si ya huduma zote zilizopo.
Ufikikaji
Sifa zinazoruhusu matumizi ya mahali au huduma kulingana na mahitaji ya mtu. Data isiyojulikana haimaanishi kwa hakika kufikika au kutokuwepo.
Mfano
Ufikikaji kwa kiti cha magurudumu unaweza kuonyeshwa au kutofahamika.
Ukomavu wa data
Uhalisia wa taarifa kulingana na tarehe na sheria za makubaliano. Muda wa kuchukua hawezi kuthibitisha ubora wa chanzo.
Mfano
Saa inayopokelewa sasa inaweza kutoka kwa uchunguzi wa zamani.
Umbali wa kijiografia
Umbali uliopimwa kati ya maeneo kulingana na mbinu ya huduma. Hauruhusu moja kwa moja umbali wa njia au muda wa kutembea.
Mfano
Eneo linalokaribu linaweza kuhitaji njia ndefu ya kufikiwa.
Uogezaji wa kijiografia
Utafutaji unaobadilisha anwani au maelezo ya kijiografia kuwa maeneo yenye karatasi. Maeneo mengi yanaweza kuwa na jina sawa.
Mfano
Miji miwili ina mtaa wenye jina moja.
Uogezaji wa kijiografia kiurudufi
Utafutaji wa maeneo au maelezo kutoka kwa karatasi. Matokeo yanaweza kuwa ya sehemu inayokaribu badala ya anwani halisi.
Mfano
Sehemu ya GPS inaambatana na maelezo yanayosomeka.
Uongo wa msaidizi wa AI
Kutengeneza taarifa isiyo imara, inayoonekana kama inayojulikana. Katika usafiri, inaweza kuwa ratiba au upatikanaji wa kubuniwa.
Mfano
Msaidizi anatangaza safari wakati zana ni kituo tu kilichorudishwa.
Upatikanaji
Hali au kiasi kinachoonyesha kinachoweza kutumika kulingana na taarifa zinazojulikana. Upatikanaji uliobainishwa unaweza kubadilika na si hakikisho la uhifadhi.
Mfano
Baiskeli tatu zilizoonekana kituoni sio uhifadhi wa baiskeli tatu.
Usafiri mwingiliano
Matumizi mfululizo ya aina tofauti za usafiri katika safari moja. Kila sehemu ina ratiba, maagizo na masharti yake.
Mfano
Unafuata tramu kwa baiskeli kisha unaendelea kwa miguu.
Usafiri wa pamoja
Huduma zinazoipa watu wengi uwezo wa kutumia gari moja kwa mfululizo badala ya kuwa na gari moja kwa mmiliki mmoja.
Mfano
Baiskeli na skuta za mikopo zinapatikana katika jiji.
Utoaji sifa
Taja mhudumu au chanzo cha data. Ikiombwa, uzoefu wa mtumiaji unapaswa kuonyesha sifa hiyo.
Mfano
Utoaji sifa required=true unapaswa kuwepo kwenye interface.
V
Vyoo vya umma
Vyoo vinavyotolewa kwa matumizi ya umma chini ya masharti ya mahali. Kuwepo kwao kwenye data hakuhakikishi bure, wazi au kufikika sasa.
Mfano
Kagua masharti kabla ya kwenda.
Z
Zana ya MCP
Uwezo unaofafanuliwa na jina, kazi na muundo wa hoja. Msaidizi anapaswa kutumia pembejeo zinazokubaliwa na muundo huu.
Mfano
geocode hupokea anwani; transit_nearby hupokea ramani.
Hakuna ufafanuzi unaolingana. Jaribu neno nyingine au ondoa kichujio.
Rejea za kuendelea na utafiti
Maneno ya ROOTE yanazingatia mikataba yake iliyoandikwa. Viwango na itifaki vina rejea rasmi za pekee.
Rudi kituoni rasilimali