# Kamusi ya usafiri na data.

Maana rahisi kuelewa usafiri, huduma za karibu na zana zinazounganisha kwa programu zako.

Source: https://www.roote.ai/sw/kamusi-ya-mobility/
Language: sw
Author: ROOTE

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya kupata baiskeli ya kutumia mwenyewe karibu na wewe?](https://www.roote.ai/sw/guides/jinsi-ya-kupata-baiskeli-ya-kutumika-karibu-na-wewe/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya kupata baiskeli ya kutumia mwenyewe karibu na wewe?](https://www.roote.ai/sw/guides/jinsi-ya-kupata-baiskeli-ya-kutumika-karibu-na-wewe/)

## 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.

Soma zaidi kwenye mwongozo : [Kituo cha baiskeli kikiwa kinajaa au kipotupu: nifanye nini?](https://www.roote.ai/sw/guides/kituo-cha-baiskeli-kikiwa-kinajaa-au-kipo-tupu-na-nini-cha-kufanya/)

## 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.

Soma zaidi kwenye mwongozo : [Kituo cha baiskeli kikiwa kinajaa au kipotupu: nifanye nini?](https://www.roote.ai/sw/guides/kituo-cha-baiskeli-kikiwa-kinajaa-au-kipo-tupu-na-nini-cha-kufanya/)

## 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.

Soma zaidi kwenye mwongozo : [Baiskeli katika Kituo au Bila Kituo: Tofauti Zipo Nini?](https://www.roote.ai/sw/guides/baiskeli-katika-kituo-au-bila-kituo-ni-tofauti-gani/)

## 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.

Soma zaidi kwenye mwongozo : [Upatikanaji wa baiskeli wakati halisi: jinsi ya kuionyesha katika programu?](https://www.roote.ai/sw/guides/upatikanaji-baiskeli-wakati-halisi-jinsi-ya-kuionyesha-katika-programu/)

## 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.

Soma zaidi kwenye mwongozo : [Upatikanaji wa baiskeli wakati halisi: jinsi ya kuionyesha katika programu?](https://www.roote.ai/sw/guides/upatikanaji-baiskeli-wakati-halisi-jinsi-ya-kuionyesha-katika-programu/)

## 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.

Soma zaidi kwenye mwongozo : [Kituo cha baiskeli kikiwa kinajaa au kipotupu: nifanye nini?](https://www.roote.ai/sw/guides/kituo-cha-baiskeli-kikiwa-kinajaa-au-kipo-tupu-na-nini-cha-kufanya/)

## 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.

Soma zaidi kwenye mwongozo : [Upatikanaji wa baiskeli wakati halisi: jinsi ya kuionyesha katika programu?](https://www.roote.ai/sw/guides/upatikanaji-baiskeli-wakati-halisi-jinsi-ya-kuionyesha-katika-programu/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya kuunganisha baiskeli na usafiri wa umma kila siku?](https://www.roote.ai/sw/guides/jinsi-ya-kuunganisha-baiskeli-na-misafirishano-ya-mambo-kila-siku/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kupata Kituo cha Basi au Tram kilicho Karibu Sana?](https://www.roote.ai/sw/guides/jinsi-ya-kuwapata-kituo-cha-basi-au-tram-kilicho-karibu-sana/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya kupata kituo cha basi kipendacho na mwelekezo sahihi?](https://www.roote.ai/sw/guides/jinsi-ya-kupata-kituo-cha-basi-kipendacho-na-kielekezo-sahihi/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya kupata kituo cha basi kipendacho na mwelekezo sahihi?](https://www.roote.ai/sw/guides/jinsi-ya-kupata-kituo-cha-basi-kipendacho-na-kielekezo-sahihi/)

## 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.

Soma zaidi kwenye mwongozo : [GTFS, GTFS-RT na GBFS: Tofauti ni zipi?](https://www.roote.ai/sw/guides/tofauti-kati-ya-gtfs-gtfs-rt-na-gbfs/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya kupata kituo cha basi kipendacho na mwelekezo sahihi?](https://www.roote.ai/sw/guides/jinsi-ya-kupata-kituo-cha-basi-kipendacho-na-kielekezo-sahihi/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya kupata kituo cha basi kipendacho na mwelekezo sahihi?](https://www.roote.ai/sw/guides/jinsi-ya-kupata-kituo-cha-basi-kipendacho-na-kielekezo-sahihi/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya kusoma mchoro wa basi, tram au metro?](https://www.roote.ai/sw/guides/jinsi-ya-kusoma-mchoro-wa-basi-tram-au-metro/)

## 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.

Soma zaidi kwenye mwongozo : [Ratiba za mabasi: tofauti gani kati ya ratiba za nadharia na za wakati halisi?](https://www.roote.ai/sw/guides/ratiba-za-mabasi-tofauti-kati-ya-ratiba-za-nadharia-na-za-wakati-halisi/)

## 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.

Soma zaidi kwenye mwongozo : [Ratiba za mabasi: tofauti gani kati ya ratiba za nadharia na za wakati halisi?](https://www.roote.ai/sw/guides/ratiba-za-mabasi-tofauti-kati-ya-ratiba-za-nadharia-na-za-wakati-halisi/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kutafuta Vituo vya Usafiri Karibu kwa kutumia API?](https://www.roote.ai/sw/guides/kujitafuta-mahali-pa-usafiri-karibu-nawe-ukitumia-api/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kuunda Msaidizi Anayepata Usafiri Karibu na Anwani?](https://www.roote.ai/sw/guides/kujenga-msaidizi-wa-kipata-usalama-wa-mobility-katika-anwani/)

## 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.

Soma zaidi kwenye mwongozo : [GTFS, GTFS-RT na GBFS: Tofauti ni zipi?](https://www.roote.ai/sw/guides/tofauti-kati-ya-gtfs-gtfs-rt-na-gbfs/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kutafuta Vituo vya Usafiri Karibu kwa kutumia API?](https://www.roote.ai/sw/guides/kujitafuta-mahali-pa-usafiri-karibu-nawe-ukitumia-api/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya kupata vyoo vya umma bila malipo karibu nawe?](https://www.roote.ai/sw/guides/jinsi-ya-kupata-tao-la-umma-bila-malipo-katika-mtaa-wako/)

## 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.

Soma zaidi kwenye mwongozo : [Tualeti za umma zinazopatikana kwa wote: Ni nini cha kuangalia kabla ya kusafiri?](https://www.roote.ai/sw/guides/tualetimyaumumilinayopatikana-kupitia-je-uangalizi-gani/)

## 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.

Soma zaidi kwenye mwongozo : [Tualeti za umma zinazopatikana kwa wote: Ni nini cha kuangalia kabla ya kusafiri?](https://www.roote.ai/sw/guides/tualetimyaumumilinayopatikana-kupitia-je-uangalizi-gani/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya kupata vyoo vya umma bila malipo karibu nawe?](https://www.roote.ai/sw/guides/jinsi-ya-kupata-tao-la-umma-bila-malipo-katika-mtaa-wako/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kutafuta Vituo vya Usafiri Karibu kwa kutumia API?](https://www.roote.ai/sw/guides/kujitafuta-mahali-pa-usafiri-karibu-nawe-ukitumia-api/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kutafuta Vituo vya Usafiri Karibu kwa kutumia API?](https://www.roote.ai/sw/guides/kujitafuta-mahali-pa-usafiri-karibu-nawe-ukitumia-api/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kutafuta Vituo vya Usafiri Karibu kwa kutumia API?](https://www.roote.ai/sw/guides/kujitafuta-mahali-pa-usafiri-karibu-nawe-ukitumia-api/)

## Mahali kijiografia

Kupata eneo la kijiografia kwa kifaa au programu. Inategemea ruhusa na usahihi unaopatikana.

Mfano : Kitufe cha eneo kinahitaji idhini ya kivinjari.

Soma zaidi kwenye mwongozo : [Jinsi ya kujumuisha ramani ya usafiri kwenye tovuti yako?](https://www.roote.ai/sw/guides/jinsi-ya-kujumuisha-ramani-ya-usafiri-kwenye-tovuti-yako/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kutafuta Vituo vya Usafiri Karibu kwa kutumia API?](https://www.roote.ai/sw/guides/kujitafuta-mahali-pa-usafiri-karibu-nawe-ukitumia-api/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kutafuta Vituo vya Usafiri Karibu kwa kutumia API?](https://www.roote.ai/sw/guides/kujitafuta-mahali-pa-usafiri-karibu-nawe-ukitumia-api/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kutafuta Vituo vya Usafiri Karibu kwa kutumia API?](https://www.roote.ai/sw/guides/kujitafuta-mahali-pa-usafiri-karibu-nawe-ukitumia-api/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kuunda Msaidizi Anayepata Usafiri Karibu na Anwani?](https://www.roote.ai/sw/guides/kujenga-msaidizi-wa-kipata-usalama-wa-mobility-katika-anwani/)

## 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.

Soma zaidi kwenye mwongozo : [Serveri ya MCP ni Nini na Inatumika Kipi?](https://www.roote.ai/sw/guides/server-mcp-na-madhumuni-ya-mtandao-na-matumizi/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kuunda Msaidizi Anayepata Usafiri Karibu na Anwani?](https://www.roote.ai/sw/guides/kujenga-msaidizi-wa-kipata-usalama-wa-mobility-katika-anwani/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya kujumuisha ramani ya usafiri kwenye tovuti yako?](https://www.roote.ai/sw/guides/jinsi-ya-kujumuisha-ramani-ya-usafiri-kwenye-tovuti-yako/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kutafuta Vituo vya Usafiri Karibu kwa kutumia API?](https://www.roote.ai/sw/guides/kujitafuta-mahali-pa-usafiri-karibu-nawe-ukitumia-api/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kutafuta Vituo vya Usafiri Karibu kwa kutumia API?](https://www.roote.ai/sw/guides/kujitafuta-mahali-pa-usafiri-karibu-nawe-ukitumia-api/)

## Kuinua ramani

Kiwango cha ukaribu wa ramani. Hudhibiti maonyesho na si mbadala wa mduara wa API.

Mfano : zoom=15 hukaribia maoni ya ramani.

Soma zaidi kwenye mwongozo : [Jinsi ya kujumuisha ramani ya usafiri kwenye tovuti yako?](https://www.roote.ai/sw/guides/jinsi-ya-kujumuisha-ramani-ya-usafiri-kwenye-tovuti-yako/)

## 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.

Soma zaidi kwenye mwongozo : [Ratiba za mabasi: tofauti gani kati ya ratiba za nadharia na za wakati halisi?](https://www.roote.ai/sw/guides/ratiba-za-mabasi-tofauti-kati-ya-ratiba-za-nadharia-na-za-wakati-halisi/)

## Uchunguzi

Hali au tukio lililotambuliwa kwa wakati maalum. Linapaswa kutofautishwa na tukio linalopangwa au makadirio.

Mfano : Kuondoka kwa basi halisi kunaweza kutofautiana na makadirio.

Soma zaidi kwenye mwongozo : [Ratiba za mabasi: tofauti gani kati ya ratiba za nadharia na za wakati halisi?](https://www.roote.ai/sw/guides/ratiba-za-mabasi-tofauti-kati-ya-ratiba-za-nadharia-na-za-wakati-halisi/)

## 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.

Soma zaidi kwenye mwongozo : [Upatikanaji wa baiskeli wakati halisi: jinsi ya kuionyesha katika programu?](https://www.roote.ai/sw/guides/upatikanaji-baiskeli-wakati-halisi-jinsi-ya-kuionyesha-katika-programu/)

## 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.

Soma zaidi kwenye mwongozo : [Upatikanaji wa baiskeli wakati halisi: jinsi ya kuionyesha katika programu?](https://www.roote.ai/sw/guides/upatikanaji-baiskeli-wakati-halisi-jinsi-ya-kuionyesha-katika-programu/)

## 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.

Soma zaidi kwenye mwongozo : [Upatikanaji wa baiskeli wakati halisi: jinsi ya kuionyesha katika programu?](https://www.roote.ai/sw/guides/upatikanaji-baiskeli-wakati-halisi-jinsi-ya-kuionyesha-katika-programu/)

## 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.

Soma zaidi kwenye mwongozo : [Upatikanaji wa baiskeli wakati halisi: jinsi ya kuionyesha katika programu?](https://www.roote.ai/sw/guides/upatikanaji-baiskeli-wakati-halisi-jinsi-ya-kuionyesha-katika-programu/)

## 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.

Soma zaidi kwenye mwongozo : [Upatikanaji wa baiskeli wakati halisi: jinsi ya kuionyesha katika programu?](https://www.roote.ai/sw/guides/upatikanaji-baiskeli-wakati-halisi-jinsi-ya-kuionyesha-katika-programu/)

## 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.

Soma zaidi kwenye mwongozo : [Hakuna matokeo au kosa la API: jinsi ya kujitofautisha?](https://www.roote.ai/sw/guides/hakuna-matokeo-au-kosa-la-api-jinsi-ya-kujitofautisha/)

## Chanzo

Taarifa zinazoonyesha asili ya data na jinsi zilivyopatikana kulingana na makubaliano. Zinasaidia kuelewa muktadha.

Mfano : Matokeo huhifadhi chanzo na muktadha wa ukusanyaji.

Soma zaidi kwenye mwongozo : [Jinsi ya Kuunda Msaidizi Anayepata Usafiri Karibu na Anwani?](https://www.roote.ai/sw/guides/kujenga-msaidizi-wa-kipata-usalama-wa-mobility-katika-anwani/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kutafuta Vituo vya Usafiri Karibu kwa kutumia API?](https://www.roote.ai/sw/guides/kujitafuta-mahali-pa-usafiri-karibu-nawe-ukitumia-api/)

## 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.

Soma zaidi kwenye mwongozo : [GTFS, GTFS-RT na GBFS: Tofauti ni zipi?](https://www.roote.ai/sw/guides/tofauti-kati-ya-gtfs-gtfs-rt-na-gbfs/)

## 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.

Soma zaidi kwenye mwongozo : [GTFS, GTFS-RT na GBFS: Tofauti ni zipi?](https://www.roote.ai/sw/guides/tofauti-kati-ya-gtfs-gtfs-rt-na-gbfs/)

## 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.

Soma zaidi kwenye mwongozo : [GTFS, GTFS-RT na GBFS: Tofauti ni zipi?](https://www.roote.ai/sw/guides/tofauti-kati-ya-gtfs-gtfs-rt-na-gbfs/)

## 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.

Soma zaidi kwenye mwongozo : [Hakuna matokeo au kosa la API: jinsi ya kujitofautisha?](https://www.roote.ai/sw/guides/hakuna-matokeo-au-kosa-la-api-jinsi-ya-kujitofautisha/)

## 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.

Soma zaidi kwenye mwongozo : [API au MCP: lequel choisir pour intégrer des données de mobilité ?](https://www.roote.ai/sw/guides/api-au-mcp-kuchagua-kwa-kuunganisha-data-za-mobility/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kutafuta Vituo vya Usafiri Karibu kwa kutumia API?](https://www.roote.ai/sw/guides/kujitafuta-mahali-pa-usafiri-karibu-nawe-ukitumia-api/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kutafuta Vituo vya Usafiri Karibu kwa kutumia API?](https://www.roote.ai/sw/guides/kujitafuta-mahali-pa-usafiri-karibu-nawe-ukitumia-api/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya kujumuisha ramani ya usafiri kwenye tovuti yako?](https://www.roote.ai/sw/guides/jinsi-ya-kujumuisha-ramani-ya-usafiri-kwenye-tovuti-yako/)

## 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.

Soma zaidi kwenye mwongozo : [Hakuna matokeo au kosa la API: jinsi ya kujitofautisha?](https://www.roote.ai/sw/guides/hakuna-matokeo-au-kosa-la-api-jinsi-ya-kujitofautisha/)

## 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.

Soma zaidi kwenye mwongozo : [Hakuna matokeo au kosa la API: jinsi ya kujitofautisha?](https://www.roote.ai/sw/guides/hakuna-matokeo-au-kosa-la-api-jinsi-ya-kujitofautisha/)

## 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.

Soma zaidi kwenye mwongozo : [Hakuna matokeo au kosa la API: jinsi ya kujitofautisha?](https://www.roote.ai/sw/guides/hakuna-matokeo-au-kosa-la-api-jinsi-ya-kujitofautisha/)

## 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.

Soma zaidi kwenye mwongozo : [Hakuna matokeo au kosa la API: jinsi ya kujitofautisha?](https://www.roote.ai/sw/guides/hakuna-matokeo-au-kosa-la-api-jinsi-ya-kujitofautisha/)

## 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.

Soma zaidi kwenye mwongozo : [Hakuna matokeo au kosa la API: jinsi ya kujitofautisha?](https://www.roote.ai/sw/guides/hakuna-matokeo-au-kosa-la-api-jinsi-ya-kujitofautisha/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kuunganisha Msaidizi wa AI na MCP ROOTE?](https://www.roote.ai/sw/guides/jinsi-ya-kuunganisha-msaidizi-ya-ai-na-mcp-roote/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kutafuta Vituo vya Usafiri Karibu kwa kutumia API?](https://www.roote.ai/sw/guides/kujitafuta-mahali-pa-usafiri-karibu-nawe-ukitumia-api/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kutafuta Vituo vya Usafiri Karibu kwa kutumia API?](https://www.roote.ai/sw/guides/kujitafuta-mahali-pa-usafiri-karibu-nawe-ukitumia-api/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya kujumuisha ramani ya usafiri kwenye tovuti yako?](https://www.roote.ai/sw/guides/jinsi-ya-kujumuisha-ramani-ya-usafiri-kwenye-tovuti-yako/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya kujumuisha ramani ya usafiri kwenye tovuti yako?](https://www.roote.ai/sw/guides/jinsi-ya-kujumuisha-ramani-ya-usafiri-kwenye-tovuti-yako/)

## 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.

Soma zaidi kwenye mwongozo : [Serveri ya MCP ni Nini na Inatumika Kipi?](https://www.roote.ai/sw/guides/server-mcp-na-madhumuni-ya-mtandao-na-matumizi/)

## 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 zaidi kwenye mwongozo : [Serveri ya MCP ni Nini na Inatumika Kipi?](https://www.roote.ai/sw/guides/server-mcp-na-madhumuni-ya-mtandao-na-matumizi/)

## 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.

Soma zaidi kwenye mwongozo : [Serveri ya MCP ni Nini na Inatumika Kipi?](https://www.roote.ai/sw/guides/server-mcp-na-madhumuni-ya-mtandao-na-matumizi/)

## 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.

Soma zaidi kwenye mwongozo : [Serveri ya MCP ni Nini na Inatumika Kipi?](https://www.roote.ai/sw/guides/server-mcp-na-madhumuni-ya-mtandao-na-matumizi/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kuunganisha Msaidizi wa AI na MCP ROOTE?](https://www.roote.ai/sw/guides/jinsi-ya-kuunganisha-msaidizi-ya-ai-na-mcp-roote/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kuunganisha Msaidizi wa AI na MCP ROOTE?](https://www.roote.ai/sw/guides/jinsi-ya-kuunganisha-msaidizi-ya-ai-na-mcp-roote/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kuunda Msaidizi Anayepata Usafiri Karibu na Anwani?](https://www.roote.ai/sw/guides/kujenga-msaidizi-wa-kipata-usalama-wa-mobility-katika-anwani/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kuunda Msaidizi Anayepata Usafiri Karibu na Anwani?](https://www.roote.ai/sw/guides/kujenga-msaidizi-wa-kipata-usalama-wa-mobility-katika-anwani/)

## 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.

Soma zaidi kwenye mwongozo : [Jinsi ya Kuunda Msaidizi Anayepata Usafiri Karibu na Anwani?](https://www.roote.ai/sw/guides/kujenga-msaidizi-wa-kipata-usalama-wa-mobility-katika-anwani/)

## 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.

Soma zaidi kwenye mwongozo : [Serveri ya MCP ni Nini na Inatumika Kipi?](https://www.roote.ai/sw/guides/server-mcp-na-madhumuni-ya-mtandao-na-matumizi/)