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í.
Glosář ROOTE
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.
79 zobrazených definic
A
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.
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.
B
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.
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.
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í.
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í.
C
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ěď.
Č
Č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.
Čá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.
D
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.
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.
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.
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.
E
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.
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.
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í.
G
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é.
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.
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.
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.
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.
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.
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.
H
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.
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.
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.
I
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.
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.
J
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.
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.
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.
K
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.
L
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.
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.
M
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í.
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.
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.
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ář.
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.
N
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.
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ě.
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.
O
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.
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.
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.
P
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.
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.
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ů.
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.
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.
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í.
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.
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.
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.
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.
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í.
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.
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.
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.
R
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.
S
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.
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.
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.
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á.
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.
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é.
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.
T
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.
U
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í.
V
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.
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í.
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.
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.
Z
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.
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.
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ů.
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.
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.
Žádná definice neodpovídá. Zkuste jiné slovo nebo odeberte filtr.
Reference pro podrobnosti
Termíny přizpůsobené ROOTE odpovídají jeho dokumentovaným smlouvám. Standardy a protokoly mají své vlastní oficiální zdroje.
Zpět do centra zdrojů