# Glosář mobility a dat.

Jednoduché definice pro lepší porozumění dopravě, místním službám a nástrojům, které je propojují s vašimi aplikacemi.

Source: https://www.roote.ai/cs/mobilitni-glosar/
Language: cs
Author: ROOTE

## Samoobslužné kolo

Služba umožňující dočasné půjčení kola podle podmínek provozovatele. Může fungovat se stanicemi nebo bez nich.

Příklad : Najdete kolo a použijete příslušnou půjčovnu.

Podrobněji v průvodci : [Jak najít volné kolo v blízkosti?](https://www.roote.ai/cs/guides/jak-najit-volne-kolo-nekde-uz-si-vasi-blizkosti/)

## Sdílená mobilita

Sada služeb poskytujících přístup k vozidlům používaným několika lidmi postupně, místo vlastnictví jedním člověkem.

Příklad : V městě jsou k dispozici kola a koloběžky k pronájmu.

Podrobněji v průvodci : [Jak najít volné kolo v blízkosti?](https://www.roote.ai/cs/guides/jak-najit-volne-kolo-nekde-uz-si-vasi-blizkosti/)

## Stojan pro připnutí

Zařízení ve stanici, kam lze připnout kolo. Přítomnost neznamená záruku, že lze v tu chvíli kolo vrátit.

Příklad : Návratové místo musí být volné a použitelné.

Podrobněji v průvodci : [Stanice kol prázdná nebo plná: co dělat?](https://www.roote.ai/cs/guides/stanice-kol-porad-plna-ci-prazdna-co-delat/)

## Stanice kol

Místo určené k půjčení nebo vrácení sdílených kol. Souřadnice, kapacity a dostupnost popisují různé aspekty stanice.

Příklad : Stanice může být na mapě i dočasně prázdná.

Podrobněji v průvodci : [Stanice kol prázdná nebo plná: co dělat?](https://www.roote.ai/cs/guides/stanice-kol-porad-plna-ci-prazdna-co-delat/)

## Bez stanice — free-floating

Model, kde vozidla nemusí být půjčována nebo vrácena na pevné místo. Oblasti a pravidla parkování odpovídají službě.

Příklad : Koloběžku musí uživatel vrátit do povolené zóny.

Podrobněji v průvodci : [Kolo se stanicemi nebo bez stanic: jaké jsou rozdíly?](https://www.roote.ai/cs/guides/kolo-se-stanicemi-ci-bez-stanic-jake-jsou-rozdily/)

## Dostupnost

Stav nebo množství dostupné podle známých informací. Pozorovaná dostupnost se může měnit a není rezervací.

Příklad : Tři kola viděná ve stanici nejsou tři rezervovaná kola.

Podrobněji v průvodci : [Dostupnost kol v reálném čase: jak ji zobrazit v aplikaci?](https://www.roote.ai/cs/guides/dostupnost-kol-v-realnem-case-jak-ji-zobrazit-v-aplikaci/)

## Převzetí vozidla

Začátek používání vozidla. Pozitivní počet nestačí, pokud služba hlásí, že nelze vozidlo právě vyzvednout.

Příklad : Kola jsou k dispozici, ale stanice může blokovat jejich půjčení.

Podrobněji v průvodci : [Dostupnost kol v reálném čase: jak ji zobrazit v aplikaci?](https://www.roote.ai/cs/guides/dostupnost-kol-v-realnem-case-jak-ji-zobrazit-v-aplikaci/)

## Vrácení

Ukončení používání vozidla podle pravidel služby. Možnosti vrácení se mohou lišit od možností vyzvednutí.

Příklad : Stanice umožňuje vyzvednutí, ale nemá volné místo pro vrácení.

Podrobněji v průvodci : [Stanice kol prázdná nebo plná: co dělat?](https://www.roote.ai/cs/guides/stanice-kol-porad-plna-ci-prazdna-co-delat/)

## Elektrokolo

Kolo asistované motorem pomáhajícím šlapání podle jeho parametrů. Typ pohonu a baterie mohou být v datech uvedeny samostatně.

Příklad : Stanice může rozlišovat mezi mechanickými a elektrickými koly.

Podrobněji v průvodci : [Dostupnost kol v reálném čase: jak ji zobrazit v aplikaci?](https://www.roote.ai/cs/guides/dostupnost-kol-v-realnem-case-jak-ji-zobrazit-v-aplikaci/)

## Intermodalita

Postupné využití různých způsobů dopravy během jednoho cestování. Každý úsek má své jízdní řády, přístupy a podmínky.

Příklad : Na tramvaj dojedete na kole, pak pokračujete pěšky.

Podrobněji v průvodci : [Jak každý den kombinovat kolo a veřejnou dopravu?](https://www.roote.ai/cs/guides/jak-kombinovat-kolo-a-mestska-doprava-kazdodenne/)

## Zastávka dopravy

Místo, kde dopravní služba nabírá nebo vysazuje cestující. Otevřená zastávka nemusí automaticky zobrazovat příjezdy.

Příklad : Zastávka autobusu je vrácena bez časů odjezdů.

Podrobněji v průvodci : [Jak najít nejbližší zastávku autobusu nebo tramvaje?](https://www.roote.ai/cs/guides/jak-najit-nejblizsi-zastavku-bus-tramvaj/)

## Nástupiště

Prostor pro nástup v dopravním místě. Několik nástupišť vedle sebe může sloužit různým směrům nebo linkám.

Příklad : Oba směry linky mohou mít samostatná nástupiště.

Podrobněji v průvodci : [Jak najít správnou zastávku a správný směr autobusu?](https://www.roote.ai/cs/guides/jak-najit-spravnou-zastavku-a-spravny-smer-autobusu/)

## Linka

Dopravní služba v rámci sítě s jedním nebo více trasami či variantami. Název linky nemusí určit směr jízdy.

Příklad : Ta samá linka může mít různé konečné zastávky.

Podrobněji v průvodci : [Jak najít správnou zastávku a správný směr autobusu?](https://www.roote.ai/cs/guides/jak-najit-spravnou-zastavku-a-spravny-smer-autobusu/)

## Jízda

Provedení spoje dopravní služby s trasou a zastávkami. V GTFS je spoj spojen s linkou a jízdním řádem.

Příklad : Dva po sobě jdoucí odjezdy téže linky jsou dva spoje.

Podrobněji v průvodci : [GTFS, GTFS-RT a GBFS: jaké jsou rozdíly?](https://www.roote.ai/cs/guides/gtfs-gtfs-rt-a-gbfs-jake-rozdily/)

## Směr

Určení směru nebo cíle služby. Musí být ověřeno podle trasy a místa nástupu.

Příklad : Hledáte tramvaj ve správném směru, ne zpět.

Podrobněji v průvodci : [Jak najít správnou zastávku a správný směr autobusu?](https://www.roote.ai/cs/guides/jak-najit-spravnou-zastavku-a-spravny-smer-autobusu/)

## Konečná

Konec trasy dopravní služby. Linka může mít varianty s různými konečnými stanicemi.

Příklad : Krátká linka končí před obvyklou konečnou.

Podrobněji v průvodci : [Jak najít správnou zastávku a správný směr autobusu?](https://www.roote.ai/cs/guides/jak-najit-spravnou-zastavku-a-spravny-smer-autobusu/)

## Přestup

Přechod z jedné služby nebo druhu dopravy na jiný během cesty. Blízkost zastávek nemusí zaručit dostupný přestup.

Příklad : Nástup i čekání zahrnují i přesun mezi nástupišti.

Podrobněji v průvodci : [Jak číst plán autobusu, tramvaje nebo metra?](https://www.roote.ai/cs/guides/jak-cist-plan-autobusu-tramvaje-nebo-metra/)

## Plánovaný čas

Čas uvedený v jízdním řádu pro dané datum a zastávku. Nemusí odpovídat aktuální poloze vozidla.

Příklad : Odjezd je naplánován na 8:10 podle jízdního řádu.

Podrobněji v průvodci : [Jízdní řády autobusů: jaký je rozdíl mezi teoretickými a reálnými jízdními řády?](https://www.roote.ai/cs/guides/jizdni-rady-autobusu-jaka-je-rozdil-mezi-teoretickymi-a-relnym-casem/)

## Odhadovaný čas

Předpověď budoucího příjezdu vycházející z dostupných informací. Může se měnit s novými daty.

Příklad : Příjezd předpovězený na 8:10 je nyní odhadován na 8:14.

Podrobněji v průvodci : [Jízdní řády autobusů: jaký je rozdíl mezi teoretickými a reálnými jízdními řády?](https://www.roote.ai/cs/guides/jizdni-rady-autobusu-jaka-je-rozdil-mezi-teoretickymi-a-relnym-casem/)

## Příští odjezd

Nadcházející příjezd nebo odjezd pro místo a službu. Nalezení zastávky není stejné jako nalezení následujících odjezdů.

Příklad : Seznam zastávek a odjezdů jsou dva odlišné výsledky.

Podrobněji v průvodci : [Jak vyhledat dopravní zastávky v okolí pomocí API?](https://www.roote.ai/cs/guides/jak-vyhledat-dopravni-zastavky-blizko-se-pomoci-api/)

## Porucha

Událost ovlivňující dopravní službu, jako přerušení nebo změna trasy. Efekty jsou uvedeny v oblasti a časovém rámci.

Příklad : Upozornění může platit jen pro danou linku v určité hodiny.

Podrobněji v průvodci : [Jak vytvořit asistenta, který najde mobilitu kolem adresy?](https://www.roote.ai/cs/guides/jak-vytvorit-asistenta-ktory-najde-mobilitu-okolo-adresy/)

## Jízdní řád služby

Informace o dnech, kdy je služba plánována, včetně výjimek. Časy jsou platné v souladu s kalendářem.

Příklad : Spoj plánovaný v pracovních dnech nemusí jezdit v neděli.

Podrobněji v průvodci : [GTFS, GTFS-RT a GBFS: jaké jsou rozdíly?](https://www.roote.ai/cs/guides/gtfs-gtfs-rt-a-gbfs-jake-rozdily/)

## Městská služba

Vybavení nebo služba v blízkosti, například toalety, vodní zdroj nebo nabíjecí stanice. Atributy mohou být neúplné.

Příklad : Výsledek vyhledávání uvádí službu a dostupné informace.

Podrobněji v průvodci : [Jak vyhledat dopravní zastávky v okolí pomocí API?](https://www.roote.ai/cs/guides/jak-vyhledat-dopravni-zastavky-blizko-se-pomoci-api/)

## Veřejné toalety

Toalety určené veřejnosti za místních podmínek. Přítomnost v datech nezaručuje zdarma použití, provozní dobu ani přístupnost.

Příklad : Před cestou zkontrolujte uvedené podmínky.

Podrobněji v průvodci : [Jak najít veřejné zdarma toalety ve svém okolí?](https://www.roote.ai/cs/guides/jak-najit-verejne-zdarma-toalety-okolni/)

## Bezbariérovost

Vlastnosti umožňující použití místa nebo služby podle potřeb osoby. Neznámá data neznamenají dostupnost či nedostupnost.

Příklad : Bezbariérovost pro vozíčkáře může být uvedena i nemusí.

Podrobněji v průvodci : [Veřejné přístupné toalety: co zkontrolovat před cestou?](https://www.roote.ai/cs/guides/verejne-pristupne-toalety-co-zkontrolovat/)

## Osoba s omezenou mobilitou – OMSM

Osoba s obtížemi v pohybu, trvalými či dočasnými. Označení OMSM nezahrnuje všechny detaily přístupů či vybavení.

Příklad : Rampa nemusí odstraňovat všechny bariéry.

Podrobněji v průvodci : [Veřejné přístupné toalety: co zkontrolovat před cestou?](https://www.roote.ai/cs/guides/verejne-pristupne-toalety-co-zkontrolovat/)

## Provozní doba

Časové úseky, kdy je místo otevřené. Nejde o potvrzení aktuálního provozu.

Příklad : Dočasné uzavření nemusí být v běžných údajích zaznamenáno.

Podrobněji v průvodci : [Jak najít veřejné zdarma toalety ve svém okolí?](https://www.roote.ai/cs/guides/jak-najit-verejne-zdarma-toalety-okolni/)

## Pitná voda

Voda označená jako vhodná ke konzumaci lidmi. Vodní zdroj nebo fontána musí mít explicitní informaci o pitnosti.

Příklad : Typ zařízení a atributy je nutné rozlišovat.

Podrobněji v průvodci : [Jak vyhledat dopravní zastávky v okolí pomocí API?](https://www.roote.ai/cs/guides/jak-vyhledat-dopravni-zastavky-blizko-se-pomoci-api/)

## Nabíjecí stanice

Zařízení umožňující nabíjení kompatibilního vozidla. Lokalizace nezaručuje dostupnost nebo typ konektoru.

Příklad : Místo nabíjení a jeho stav jsou odlišné informace.

Podrobněji v průvodci : [Jak vyhledat dopravní zastávky v okolí pomocí API?](https://www.roote.ai/cs/guides/jak-vyhledat-dopravni-zastavky-blizko-se-pomoci-api/)

## Typ služby

Kategorie používaná pro výběr nebo popis městské služby. Přijatelné hodnoty závisí na rozhraní a jeho schématu.

Příklad : API služeb ROOTE používá types=toilets pro veřejné toalety.

Podrobněji v průvodci : [Jak vyhledat dopravní zastávky v okolí pomocí API?](https://www.roote.ai/cs/guides/jak-vyhledat-dopravni-zastavky-blizko-se-pomoci-api/)

## Geolokace

Získání geografické polohy zařízením nebo aplikací. Závisí na oprávněních a dostupné přesnosti.

Příklad : Tlačítko lokalizace vyžaduje souhlas prohlížeče.

Podrobněji v průvodci : [Jak integrovat mobilitní mapu do svého webu?](https://www.roote.ai/cs/guides/jak-integrovat-mobilitni-mapu-do-webu/)

## GPS souřadnice

Hodnoty udávající geografický bod, obvykle zeměpisná šířka a délka. Pořadí je dle použitého rozhraní.

Příklad : Vyhledávání blízkosti přijímá dvě oddělené souřadnice.

Podrobněji v průvodci : [Jak vyhledat dopravní zastávky v okolí pomocí API?](https://www.roote.ai/cs/guides/jak-vyhledat-dopravni-zastavky-blizko-se-pomoci-api/)

## Zeměpisná šířka

Souřadnice udávající pozici severně či jižně od rovníku, ve stupních dle příkladů ROOTE. Platné hodnoty jsou od −90 do 90.

Příklad : Šířka vyhledávacího bodu je v parametru lat.

Podrobněji v průvodci : [Jak vyhledat dopravní zastávky v okolí pomocí API?](https://www.roote.ai/cs/guides/jak-vyhledat-dopravni-zastavky-blizko-se-pomoci-api/)

## Zeměpisná délka

Souřadnice určující pozici východně nebo západně od základního poledníku. Příklady ROOTE uvádějí stupně mezi −180 a 180.

Příklad : Délka může být v parametru lon nebo aliasu lng.

Podrobněji v průvodci : [Jak vyhledat dopravní zastávky v okolí pomocí API?](https://www.roote.ai/cs/guides/jak-vyhledat-dopravni-zastavky-blizko-se-pomoci-api/)

## Geokódování

Vyhledávání převádějící adresu nebo výraz na kandidátní místa se souřadnicemi. Více míst může odpovídat stejné vstupní hodnotě.

Příklad : Dvě města mohou mít stejnou pojmenovanou ulici.

Podrobněji v průvodci : [Jak vytvořit asistenta, který najde mobilitu kolem adresy?](https://www.roote.ai/cs/guides/jak-vytvorit-asistenta-ktory-najde-mobilitu-okolo-adresy/)

## Reverzní geokódování

Hledání míst nebo popisů zadaných souřadnicemi. Výsledek může být blízkým místem, ne přesnou adresou.

Příklad : GPS bod je spojen s čitelným názvem.

Podrobněji v průvodci : [Co je server MCP a k čemu slouží?](https://www.roote.ai/cs/guides/co-je-to-server-mcp-a-k-cemu-slouzi/)

## Bod zájmu — POI

Identifikovatelný užitečný objekt vyhledávání, například zařízení nebo vybavení. POI se liší od běžné poštovní adresy.

Příklad : Název hotelu lze vyhledat jako zařízení.

Podrobněji v průvodci : [Jak vytvořit asistenta, který najde mobilitu kolem adresy?](https://www.roote.ai/cs/guides/jak-vytvorit-asistenta-ktory-najde-mobilitu-okolo-adresy/)

## Start vyhledávání

Bod, odkud se provádí vyhledávání v okolí a počítají vzdálenosti. Může se lišit od zobrazeného středu mapy.

Příklad : Kamera se pohybuje, ale vyhledávání je zaměřeno na Bordeaux.

Podrobněji v průvodci : [Jak integrovat mobilitní mapu do svého webu?](https://www.roote.ai/cs/guides/jak-integrovat-mobilitni-mapu-do-webu/)

## Vyhledávací poloměr

Vzdálenost od výchozího bodu použitá k vymezení oblasti pro vyhledávání. Jednotky a limity závisí na definici rozhraní nebo nástroje.

Příklad : radius=600 zadá vyhledávání v okruhu 600 metrů v REST příkladu.

Podrobněji v průvodci : [Jak vyhledat dopravní zastávky v okolí pomocí API?](https://www.roote.ai/cs/guides/jak-vyhledat-dopravni-zastavky-blizko-se-pomoci-api/)

## Geografická vzdálenost

Vzdálenost mezi pozicemi vypočtená podle metody služby. Nemusí být odpovídající vzdálenosti trasy nebo chůzi.

Příklad : Blízké místo může být dostupné až po objížďce.

Podrobněji v průvodci : [Jak vyhledat dopravní zastávky v okolí pomocí API?](https://www.roote.ai/cs/guides/jak-vyhledat-dopravni-zastavky-blizko-se-pomoci-api/)

## Přiblížení mapy

Úroveň zvětšení pohledu na mapu. Ovlivňuje zobrazování, ale nenahrazuje vyhledávací poloměr API.

Příklad : zoom=15 přiblíží zobrazení mapy.

Podrobněji v průvodci : [Jak integrovat mobilitní mapu do svého webu?](https://www.roote.ai/cs/guides/jak-integrovat-mobilitni-mapu-do-webu/)

## Data v reálném čase

Aktualizované informace zobrazující aktuální situaci nebo podporující odhad. Je třeba hodnotit aktuálnost; reálný čas není okamžitost ani záruka.

Příklad : Odhad příjezdu je přepočítán z nových dat.

Podrobněji v průvodci : [Jízdní řády autobusů: jaký je rozdíl mezi teoretickými a reálnými jízdními řády?](https://www.roote.ai/cs/guides/jizdni-rady-autobusu-jaka-je-rozdil-mezi-teoretickymi-a-relnym-casem/)

## Pozorování

Stav nebo událost zaznamenaná v určitý okamžik. Liší se od plánovaného nebo odhadovaného stavu.

Příklad : Skutečný průjezd autobusu se může lišit od aktuálního odhadu.

Podrobněji v průvodci : [Jízdní řády autobusů: jaký je rozdíl mezi teoretickými a reálnými jízdními řády?](https://www.roote.ai/cs/guides/jizdni-rady-autobusu-jaka-je-rozdil-mezi-teoretickymi-a-relnym-casem/)

## Aktuálnost dat

Kvalifikace novosti informace podle dat a pravidel smlouvy. Čas dotazu neprokazuje čerstvost zdroje.

Příklad : Současný počet může pocházet ze staršího pozorování.

Podrobněji v průvodci : [Dostupnost kol v reálném čase: jak ji zobrazit v aplikaci?](https://www.roote.ai/cs/guides/dostupnost-kol-v-realnem-case-jak-ji-zobrazit-v-aplikaci/)

## Časové razítko

Časová značka připojená k datu nebo události. Význam závisí na poli: pozorování, aktualizace, přijetí nebo vypršení.

Příklad : source_updated_at a received_at označují různé fáze.

Podrobněji v průvodci : [Dostupnost kol v reálném čase: jak ji zobrazit v aplikaci?](https://www.roote.ai/cs/guides/dostupnost-kol-v-realnem-case-jak-ji-zobrazit-v-aplikaci/)

## Zastaralá data — stale

Informace považovaná za příliš starou podle smlouvy nebo pravidel platnosti. Může být uložená jako nedávná historie bez označení jako čerstvá.

Příklad : Rozhraní upozorňuje, že dostupnost je třeba aktualizovat.

Podrobněji v průvodci : [Dostupnost kol v reálném čase: jak ji zobrazit v aplikaci?](https://www.roote.ai/cs/guides/dostupnost-kol-v-realnem-case-jak-ji-zobrazit-v-aplikaci/)

## Doba platnosti — TTL

Doba používaná ke správě platnosti nebo obnovení cachovaných dat dle smlouvy. Sami o sobě neprokazují čas pozorování zdroje.

Příklad : Expirace cache musí dodržovat nastavenou politiku obnovy.

Podrobněji v průvodci : [Dostupnost kol v reálném čase: jak ji zobrazit v aplikaci?](https://www.roote.ai/cs/guides/dostupnost-kol-v-realnem-case-jak-ji-zobrazit-v-aplikaci/)

## Cache

Dočasné ukládání výsledků pro opakované vyhledání stejných dotazů. Hodnota v cache si uchovává svůj původ a časový kontext.

Příklad : Dva stejné dotazy mohou znovu použít platnou odpověď.

Podrobněji v průvodci : [Dostupnost kol v reálném čase: jak ji zobrazit v aplikaci?](https://www.roote.ai/cs/guides/dostupnost-kol-v-realnem-case-jak-ji-zobrazit-v-aplikaci/)

## Pokrytí

Rozsah a úplnost informací k dispozici pro vyhledávání nebo zdroj. Částečné pokrytí omezuje možnosti závěrů.

Příklad : Seznam může být užitečný i bez kompletního zastoupení všech služeb.

Podrobněji v průvodci : [Žádný výsledek nebo chyba API: jak to rozeznat?](https://www.roote.ai/cs/guides/zadny-vysledek-ci-chyba-api-jak-rozeznat/)

## Původ

Informace identifikující zdroj dat a podle smlouvy způsob jejich vzniku. Pomáhají pochopit jejich význam a rozsah.

Příklad : Výsledek uchovává zdroj a kontext sběru.

Podrobněji v průvodci : [Jak vytvořit asistenta, který najde mobilitu kolem adresy?](https://www.roote.ai/cs/guides/jak-vytvorit-asistenta-ktory-najde-mobilitu-okolo-adresy/)

## Uvedení zdroje

Odkaz na poskytovatele nebo zdroj spojený s daty. Pokud je vyžadováno, používající aplikace musí údaj zobrazit.

Příklad : Při required=true musí být uvedení zachováno v rozhraní.

Podrobněji v průvodci : [Jak vyhledat dopravní zastávky v okolí pomocí API?](https://www.roote.ai/cs/guides/jak-vyhledat-dopravni-zastavky-blizko-se-pomoci-api/)

## GTFS jízdní řády

Standardní formát popisu plánované nabídky dopravy: zastávky, linky, spoje, kalendáře a časy. Nezahrnuje automaticky aktualizace v reálném čase.

Příklad : Plánované průjezdy jsou vázané na spoje a dny provozu.

Podrobněji v průvodci : [GTFS, GTFS-RT a GBFS: jaké jsou rozdíly?](https://www.roote.ai/cs/guides/gtfs-gtfs-rt-a-gbfs-jake-rozdily/)

## GTFS Realtime — GTFS-RT

Standardní formát pro přenos aktualizací spojů, pozic vozidel a upozornění. Publikované kategorie závisí na výrobci dat.

Příklad : Proud pozic neznamená odhad pro všechny zastávky.

Podrobněji v průvodci : [GTFS, GTFS-RT a GBFS: jaké jsou rozdíly?](https://www.roote.ai/cs/guides/gtfs-gtfs-rt-a-gbfs-jake-rozdily/)

## GBFS

Standardní formát veřejně dostupných dat o sdílené mobilitě. Popisuje systémy, stanice, vozidla a jejich stavy dle verze a toků.

Příklad : Informace o stanicích a počty dostupnosti jsou oddělené.

Podrobněji v průvodci : [GTFS, GTFS-RT a GBFS: jaké jsou rozdíly?](https://www.roote.ai/cs/guides/gtfs-gtfs-rt-a-gbfs-jake-rozdily/)

## Neznámá hodnota — null

Absence známé hodnoty definované v rámci smlouvy jako null. Nemá být nahrazena nulou, false ani důkazem absence.

Příklad : Počet kol null neznamená prázdnou stanici.

Podrobněji v průvodci : [Žádný výsledek nebo chyba API: jak to rozeznat?](https://www.roote.ai/cs/guides/zadny-vysledek-ci-chyba-api-jak-rozeznat/)

## API

Rozhraní umožňující programu využít funkce jiné služby dle definované smlouvy. Přesně specifikuje vstupy a očekávané odpovědi.

Příklad : Aplikace vyhledává zastávky pomocí API ROOTE.

Podrobněji v průvodci : [API nebo MCP: které zvolit pro integraci mobilních dat?](https://www.roote.ai/cs/guides/api-nebo-mcp-ktere-zvolit-pro-integraci-mobilnich-dat/)

## API REST

HTTP rozhraní využívající zdroje a webové mechanismy. Smlouva určuje cesty, metody a reprezentace.

Příklad : Vyhledání je poslání GET dotazu na dokumentovanou cestu.

Podrobněji v průvodci : [Jak vyhledat dopravní zastávky v okolí pomocí API?](https://www.roote.ai/cs/guides/jak-vyhledat-dopravni-zastavky-blizko-se-pomoci-api/)

## Endpoint — API cesta

Adresa a operace poskytnutá API pro danou funkci. Různé cesty mohou vracet různé typy výsledků.

Příklad : /v1/transit/nearby vyhledá místa dopravy v okolí.

Podrobněji v průvodci : [Jak vyhledat dopravní zastávky v okolí pomocí API?](https://www.roote.ai/cs/guides/jak-vyhledat-dopravni-zastavky-blizko-se-pomoci-api/)

## Dotazovací parametr

Hodnota za otazníkem v URL, jejíž jméno a formát určuje použité rozhraní.

Příklad : modes=bus,tram vybírá druhy dopravy v URL.

Podrobněji v průvodci : [Jak integrovat mobilitní mapu do svého webu?](https://www.roote.ai/cs/guides/jak-integrovat-mobilitni-mapu-do-webu/)

## HTTP stav

Kód označující výsledek HTTP požadavku. Měl by být doplněn kontrolou obsahu a aplikačního stavu.

Příklad : HTTP 200 může obsahovat chybový stav aplikace.

Podrobněji v průvodci : [Žádný výsledek nebo chyba API: jak to rozeznat?](https://www.roote.ai/cs/guides/zadny-vysledek-ci-chyba-api-jak-rozeznat/)

## Prázdný výsledek — empty

Vyhledání bez nalezených entit v daném rozsahu. Neznamená absenci služeb mimo dostupné informace.

Příklad : Nebyly nalezeny žádné zastávky s použitými filtry.

Podrobněji v průvodci : [Žádný výsledek nebo chyba API: jak to rozeznat?](https://www.roote.ai/cs/guides/zadny-vysledek-ci-chyba-api-jak-rozeznat/)

## Částečná odpověď — partial

Výsledek s použitelnými, ale omezenými či neúplnými daty doprovázený příslušnými varováními.

Příklad : Jeden zdroj odpoví, druhý není k dispozici.

Podrobněji v průvodci : [Žádný výsledek nebo chyba API: jak to rozeznat?](https://www.roote.ai/cs/guides/zadny-vysledek-ci-chyba-api-jak-rozeznat/)

## Vypršení časového limitu — timeout

Přerušení čekání překračující předem definovaný interval. Znamená neúplné vyhledávání, ne nutně žádné výsledky.

Příklad : Aplikace nabídne opakování místo zobrazení prázdného seznamu.

Podrobněji v průvodci : [Žádný výsledek nebo chyba API: jak to rozeznat?](https://www.roote.ai/cs/guides/zadny-vysledek-ci-chyba-api-jak-rozeznat/)

## Limity požadavků — rate limit

Omezení frekvence dotazů povolených službou. Pravidla obnovy závisí na aktivní smlouvě.

Příklad : Kód 429 informuje o nutnosti dodržet časovou rezervu.

Podrobněji v průvodci : [Žádný výsledek nebo chyba API: jak to rozeznat?](https://www.roote.ai/cs/guides/zadny-vysledek-ci-chyba-api-jak-rozeznat/)

## Bearer token

Přístupový identifikátor zasílaný v hlavičce Authorization dle definovaného mechanismu. Musí být bezpečně uchováván.

Příklad : Authorization: Bearer se používá bez zveřejnění tokenu v URL.

Podrobněji v průvodci : [Jak připojit IA asistenta k MCP ROOTE?](https://www.roote.ai/cs/guides/jak-pripojit-ia-pomocnika-k-mcp-roote/)

## JSON

Textový strukturovaný formát využívající objekty, pole, řetězce a čísla. Syntakticky správný JSON nemusí odpovídat schématu API.

Příklad : Kolekce stanic musí mít očekávaný typ a pole.

Podrobněji v průvodci : [Jak vyhledat dopravní zastávky v okolí pomocí API?](https://www.roote.ai/cs/guides/jak-vyhledat-dopravni-zastavky-blizko-se-pomoci-api/)

## OpenAPI

Specifikace popisující API HTTP v jednom strukturovaném dokumentu. Pomáhá ověřit cesty, parametry a odpovědi.

Příklad : Smlouva ROOTE je publikována v openapi.json.

Podrobněji v průvodci : [Jak vyhledat dopravní zastávky v okolí pomocí API?](https://www.roote.ai/cs/guides/jak-vyhledat-dopravni-zastavky-blizko-se-pomoci-api/)

## Embed — vložená mapa

Vložení externího obsahu do stránky, například mapy v iframe. Parametry a oprávnění určují kontext použití.

Příklad : Iframe ROOTE zobrazuje kola okolo Bordeaux.

Podrobněji v průvodci : [Jak integrovat mobilitní mapu do svého webu?](https://www.roote.ai/cs/guides/jak-integrovat-mobilitni-mapu-do-webu/)

## Iframe

HTML prvek načítající dokument uvnitř stránky. Na jiných doménách nelze volně číst stav vloženého dokumentu.

Příklad : Změny vyhledávání vyžadují dokumentovanou komunikaci s rodičem.

Podrobněji v průvodci : [Jak integrovat mobilitní mapu do svého webu?](https://www.roote.ai/cs/guides/jak-integrovat-mobilitni-mapu-do-webu/)

## MCP — Model Context Protocol

Protokol umožňující aplikacím AI komunikovat se servery poskytujícími nástroje či kontext. Neposkytuje sám o sobě kvalitu vrácených dat.

Příklad : Asistent objeví nástroje ROOTE pro vyhledávání.

Podrobněji v průvodci : [Co je server MCP a k čemu slouží?](https://www.roote.ai/cs/guides/co-je-to-server-mcp-a-k-cemu-slouzi/)

## MCP server

Program vystavující schopnosti podle protokolu MCP. Nabízené nástroje určují, co klient může volat.

Příklad : tools/list zobrazí dostupný inventář.

Podrobněji v průvodci : [Co je server MCP a k čemu slouží?](https://www.roote.ai/cs/guides/co-je-to-server-mcp-a-k-cemu-slouzi/)

## MCP klient

Součást AI aplikace, která komunikuje se serverem MCP. Spravuje výměnu protokolu na tomto spojení.

Příklad : Klient předává argumenty vyhledávání do ROOTE.

Podrobněji v průvodci : [Co je server MCP a k čemu slouží?](https://www.roote.ai/cs/guides/co-je-to-server-mcp-a-k-cemu-slouzi/)

## Hostitelská aplikace MCP

Aplikace, která zprostředkovává interakci s uživatelem a spravuje jeden či více klientů MCP. Zodpovídá za využití výsledků ve svém prostředí.

Příklad : Vaše konverzační aplikace připojuje server ROOTE.

Podrobněji v průvodci : [Co je server MCP a k čemu slouží?](https://www.roote.ai/cs/guides/co-je-to-server-mcp-a-k-cemu-slouzi/)

## MCP nástroj

Spustitelná schopnost popsaná jménem, funkcí a schématem argumentů. Asistent by měl používat přijaté vstupy dle schématu.

Příklad : geocode přijímá adresu; transit_nearby přijímá souřadnice.

Podrobněji v průvodci : [Jak připojit IA asistenta k MCP ROOTE?](https://www.roote.ai/cs/guides/jak-pripojit-ia-pomocnika-k-mcp-roote/)

## Streamable HTTP

Přenos MCP umožňující komunikaci s vzdáleným serverem přes HTTP. Podpora musí být ověřena na klientu.

Příklad : Vzdálený server ROOTE používá https://mcp.roote.ai/mcp.

Podrobněji v průvodci : [Jak připojit IA asistenta k MCP ROOTE?](https://www.roote.ai/cs/guides/jak-pripojit-ia-pomocnika-k-mcp-roote/)

## Podložená odpověď — grounding

Vytvoření odpovědi z efektivně získaných nebo poskytnutých informací. Chybějící pole a výhrady musí být viditelné.

Příklad : Asistent převzal vrácená místa bez vymýšlení časů.

Podrobněji v průvodci : [Jak vytvořit asistenta, který najde mobilitu kolem adresy?](https://www.roote.ai/cs/guides/jak-vytvorit-asistenta-ktory-najde-mobilitu-okolo-adresy/)

## Halucinace AI asistenta

Vytvoření nepodložené informace, prezentované jako známá. V mobilitě to může být smyšlený čas nebo dostupnost.

Příklad : Asistent uvádí průjezd, zatímco nástroj vrátil pouze zastávku.

Podrobněji v průvodci : [Jak vytvořit asistenta, který najde mobilitu kolem adresy?](https://www.roote.ai/cs/guides/jak-vytvorit-asistenta-ktory-najde-mobilitu-okolo-adresy/)

## Zásah do zadání (prompt injection)

Snaha využít externí obsah k změně instrukcí pro asistenta. Popisy poskytovatelů mají zůstat daty, ne příkazy.

Příklad : Skrytý příkaz v názvu místa nesmí být vykonán.

Podrobněji v průvodci : [Jak vytvořit asistenta, který najde mobilitu kolem adresy?](https://www.roote.ai/cs/guides/jak-vytvorit-asistenta-ktory-najde-mobilitu-okolo-adresy/)

## Pouze ke čtení

Možnost prohlížet bez povolení úprav nástrojem. Čtení dostupnosti neznamená rezervaci, odemčení nebo půjčení vozidla.

Příklad : Nástroje Data ROOTE slouží k prohlížení informací.

Podrobněji v průvodci : [Co je server MCP a k čemu slouží?](https://www.roote.ai/cs/guides/co-je-to-server-mcp-a-k-cemu-slouzi/)