# Глосар на мобилността и данните.

Прости дефиниции за разбиране на транспорта, близките услуги и инструментите, свързващи ги с вашите приложения.

Source: https://www.roote.ai/bg/glosar-mobilnost/
Language: bg
Author: ROOTE

## Велосипеди под наем

Услуга, позволяваща временно ползване на велосипед според условията на оператора. Може да работи с станции или без тях (безстанционна).

Пример : Отивате до велосипед и използвате съответната услуга за наем.

Вижте в наръчника : [Как да намерите велосипед за свободна употреба наблизо?](https://www.roote.ai/bg/guides/kak-da-namera-velosiped-v-zona-svobodna-polzvane-blizo-do-men/)

## Споделена мобилност

Комплект услуги за достъп до превозни средства, използвани последователно от няколко души, вместо частна собственост.

Пример : Велосипеди и тротинетки за отдаване под наем в град.

Вижте в наръчника : [Как да намерите велосипед за свободна употреба наблизо?](https://www.roote.ai/bg/guides/kak-da-namera-velosiped-v-zona-svobodna-polzvane-blizo-do-men/)

## Прикачна станция

Елемент от станция, където велосипед може да се закрепи. Наличието му не гарантира приемане на връщане в момента.

Пример : Място за връщане трябва да е свободно и използваемо.

Вижте в наръчника : [Празна или пълна велостанция: какво да правим?](https://www.roote.ai/bg/guides/prazna-ili-pashtna-velostantsiya-kakvo-da-pravia/)

## Велосипедна станция

Организирано място за вземане или връщане на споделени велосипеди. Координати, капацитет и наличие описват различни аспекти.

Пример : Станция може да е на картата, но временно празна.

Вижте в наръчника : [Празна или пълна велостанция: какво да правим?](https://www.roote.ai/bg/guides/prazna-ili-pashtna-velostantsiya-kakvo-da-pravia/)

## Безстанционна — свободно плаваща

Организация, при която превозните средства не се вземат и връщат на фиксирани станции. Зоните и правилата остават валидни.

Пример : Тротинетка трябва да се върне в позволена зона.

Вижте в наръчника : [Велосипед на станция или без станция: какви са разликите?](https://www.roote.ai/bg/guides/velo-v-stantsiya-ili-bez-stantsiya-kakvi-sa-razlikite/)

## Наличност

Статус или количество, показващо какво може да бъде използвано според наличната информация. Наблюдаваната наличност може да се промени и не означава резервация.

Пример : Три велосипеда на станция не означават, че са резервирани три.

Вижте в наръчника : [Наличност на колелета в реално време: как да се показва в приложение?](https://www.roote.ai/bg/guides/nalichnost-na-kolichkite-v-realno-vreme-kak-da-se-pokaje-v-prilozhenie/)

## Вземане на превозно средство

Действие за започване използване на превозно средство. Положителен брояч не е достатъчен ако услугата сигнализира, че вземането е забранено.

Пример : Велосипеди има, но станцията може да блокира наемането им.

Вижте в наръчника : [Наличност на колелета в реално време: как да се показва в приложение?](https://www.roote.ai/bg/guides/nalichnost-na-kolichkite-v-realno-vreme-kak-da-se-pokaje-v-prilozhenie/)

## Връщане

Край на използване на превозно средство според правилата на услугата. Възможностите за връщане могат да се различават от вземането.

Пример : Станцията позволява излизане, но няма място за връщане.

Вижте в наръчника : [Празна или пълна велостанция: какво да правим?](https://www.roote.ai/bg/guides/prazna-ili-pashtna-velostantsiya-kakvo-da-pravia/)

## Електрически велосипед

Велосипед подкрепян от мотор според характеристиките си. В данни за мобилност типът на задвижване и батерията могат да бъдат отделени.

Пример : Станцията различава механични от електрически велосипеди.

Вижте в наръчника : [Наличност на колелета в реално време: как да се показва в приложение?](https://www.roote.ai/bg/guides/nalichnost-na-kolichkite-v-realno-vreme-kak-da-se-pokaje-v-prilozhenie/)

## Интермодалност

Последователно използване на няколко транспортни средства в рамките на едно пътуване. Всяка част пази свои графици и условия.

Пример : Отивате с велосипед до трамвай и после пеша.

Вижте в наръчника : [Как да съчетаете колело и обществен транспорт всеки ден?](https://www.roote.ai/bg/guides/kak-da-suvmetite-kola-s-obshtestveniya-transport-vseki-den/)

## Транспортна спирка

Място, където се качват или слизат пътници от транспортна услуга. Откритата спирка не винаги съдържа информация за следващи тръгвания.

Пример : Автобусна спирка с липса на график на тръгванията.

Вижте в наръчника : [Как да намерите най-близката спирка на автобус или трамвай?](https://www.roote.ai/bg/guides/kak-da-namerya-nay-blijkata-spirka-na-avtobus-ili-tramvay/)

## Влак

Място за качване/слизане в транспортна точка. Няколко близки влакове обслужват различни посоки или линии.

Пример : Двата края на линия могат да ползват различни влакове.

Вижте в наръчника : [Как да намерите правилната автобусна спирка и посоката?](https://www.roote.ai/bg/guides/kak-da-namerite-praviya-avtobusna-spirka-i-praviya-posoka/)

## Линия

Транспортна услуга с определено име в мрежата, с един или повече маршрути или варианти. Името не е достатъчно за посока.

Пример : Една линия може да има няколко крайни спирки.

Вижте в наръчника : [Как да намерите правилната автобусна спирка и посоката?](https://www.roote.ai/bg/guides/kak-da-namerite-praviya-avtobusna-spirka-i-praviya-posoka/)

## Курс

Изпълнение на транспортна услуга с маршрут и преминавания. В GTFS курсът е свързан с линия и календар на услугата.

Пример : Два последователни тръгвания на една линия са два курса.

Вижте в наръчника : [GTFS, GTFS-RT и GBFS: какви са разликите?](https://www.roote.ai/bg/guides/gtfs-gtfs-rt-i-gbfs-kakvi-sa-razlikite/)

## Посока

Данни за посоката или крайната точка на услуга. Трябва да бъде проверена с маршрута и мястото за качване.

Пример : Търсите трамвай към точната дестинация, а не обратната посока.

Вижте в наръчника : [Как да намерите правилната автобусна спирка и посоката?](https://www.roote.ai/bg/guides/kak-da-namerite-praviya-avtobusna-spirka-i-praviya-posoka/)

## Крайна спирка

Край на транспортен маршрут. Линията може да има варианти с различни крайни спирки.

Пример : Кратък курс спира преди обичайната крайна спирка.

Вижте в наръчника : [Как да намерите правилната автобусна спирка и посоката?](https://www.roote.ai/bg/guides/kak-da-namerite-praviya-avtobusna-spirka-i-praviya-posoka/)

## Превключване

Преминаване от една услуга или транспорт към друга в пътуването. Близостта не гарантира, че превключването е възможно.

Пример : Трябва време за преминаване и изчакване между влакове.

Вижте в наръчника : [Как да четем план на автобус, трамвай или метро?](https://www.roote.ai/bg/guides/kak-da-chetem-plan-na-avtobus-tramvay-ili-metro/)

## Теоретично време

Планирано време по разписанието за определена дата и преминаване. Не описва непременно текущото разположение на превозното средство.

Пример : Тръгване по разписание в 8:10 ч.

Вижте в наръчника : [Разписание на автобусите: каква е разликата между теоретични и реално време?](https://www.roote.ai/bg/guides/razpisanie-na-avtobusite-kakva-e-razlikata-mezhdu-teoretichni-i-realno-vreme/)

## Оценено време

Прогнозирано бъдещо преминаване, изчислено по текущата информация, която може да се променя.

Пример : Оценено преминаване от 8:10 ч. сега е 8:14 ч.

Вижте в наръчника : [Разписание на автобусите: каква е разликата между теоретични и реално време?](https://www.roote.ai/bg/guides/razpisanie-na-avtobusite-kakva-e-razlikata-mezhdu-teoretichni-i-realno-vreme/)

## Следващо тръгване

Близко идващо преминаване или тръгване за място и услуга. Намиране на спирка не е търсене на тръгвания.

Пример : Две отделни търсения за спирки и тръгвания връщат различни резултати.

Вижте в наръчника : [Как да търсим транспортни спирки наблизо с API?](https://www.roote.ai/bg/guides/kak-da-tarsim-blizkite-prestani-s-api-roote/)

## Нарушение

Събитие, повлияващо транспортна услуга, като спиране или отклонение. Ефектите са валидни в посоченото време и място.

Пример : Предупреждение важи за линия само през някои часове.

Вижте в наръчника : [Как да създадем асистент, който намира мобилност около даден адрес?](https://www.roote.ai/bg/guides/kak-da-sazdaem-asistent-za-mobilnost-okolo-adres/)

## Календар на услугата

Информация кои дни е планирана услугата с възможни изключения. Графиците се тълкуват с този календар.

Пример : Курс през делнични дни може да липсва в неделя.

Вижте в наръчника : [GTFS, GTFS-RT и GBFS: какви са разликите?](https://www.roote.ai/bg/guides/gtfs-gtfs-rt-i-gbfs-kakvi-sa-razlikite/)

## Градска услуга

Оборудване или услуга близо до място, напр. тоалетна, водаче или зарядна станция. Атрибутите може да са непълни.

Пример : Близка услуга с известна информация за нея.

Вижте в наръчника : [Как да търсим транспортни спирки наблизо с API?](https://www.roote.ai/bg/guides/kak-da-tarsim-blizkite-prestani-s-api-roote/)

## Обществени тоалетни

Тоалетни за публична употреба според условията на мястото. Присъствието им не гарантира безплатност, отвореност или достъпност.

Пример : Проверете условията преди да отидете.

Вижте в наръчника : [Как да намерите безплатни обществени тоалетни наблизо?](https://www.roote.ai/bg/guides/kak-da-namerya-bezplatni-publichni-toaleti-nyama---osi/)

## Достъпност

Характеристики, позволяващи ползване на място или услуга съобразно нуждите на потребителя. Липсата на данни не означава достъпно или недостъпно.

Пример : Достъпността за инвалидни колички може да е известна или непозната.

Вижте в наръчника : [Обществени тоалетни с достъпност: какво да проверите преди да тръгнете?](https://www.roote.ai/bg/guides/ostanovi-za-higiena-s-dostap-za-vasheto-bytie-kakvo-da-proverite-predi-da-potraite/)

## Лица с намалена мобилност — ЛНМ

Лице с временни или трайни затруднения в придвижването. Маркировката ЛНМ не описва всички необходими достъпи или оборудване.

Пример : Наличието на рампа не показва всички бариери.

Вижте в наръчника : [Обществени тоалетни с достъпност: какво да проверите преди да тръгнете?](https://www.roote.ai/bg/guides/ostanovi-za-higiena-s-dostap-za-vasheto-bytie-kakvo-da-proverite-predi-da-potraite/)

## Работно време

Часове, в които мястото твърди, че е отворено. Не е гаранция за текущ статус.

Пример : Временно затваряне може да не е отразено в нормалното работно време.

Вижте в наръчника : [Как да намерите безплатни обществени тоалетни наблизо?](https://www.roote.ai/bg/guides/kak-da-namerya-bezplatni-publichni-toaleti-nyama---osi/)

## Питейна вода

Вода, подходяща за консумация. Точка за вода или фонтан не трябва да се смята за питейна без ясни данни.

Пример : Типът на оборудването и атрибутите му трябва да са разграничени.

Вижте в наръчника : [Как да търсим транспортни спирки наблизо с API?](https://www.roote.ai/bg/guides/kak-da-tarsim-blizkite-prestani-s-api-roote/)

## Зарядна станция

Оборудване за зареждане на съвместимо превозно средство. Намирането й не гарантира наличност или съвместимост на конектора.

Пример : Местоположението и състоянието са отделни данни.

Вижте в наръчника : [Как да търсим транспортни спирки наблизо с API?](https://www.roote.ai/bg/guides/kak-da-tarsim-blizkite-prestani-s-api-roote/)

## Тип услуга

Категория за избор или описание на градска услуга. Допустимите стойности зависят от интерфейса и схемата.

Пример : API Services на ROOTE използва types=toilets за тоалетни.

Вижте в наръчника : [Как да търсим транспортни спирки наблизо с API?](https://www.roote.ai/bg/guides/kak-da-tarsim-blizkite-prestani-s-api-roote/)

## Геолокация

Получаване на географски координати чрез устройство или приложение. Зависи от разрешения и точност.

Пример : Бутон за локация иска разрешение от браузъра.

Вижте в наръчника : [Как да интегрирате карта за мобилност в своя сайт?](https://www.roote.ai/bg/guides/kak-da-integrirate-karta-za-mobilnost-vashiya-sait/)

## GPS координати

Стойности, представящи точка на земята, обикновено с ширина и дължина. Порядъкът се уточнява от интерфейса.

Пример : Търсене близо получава две отделни координати.

Вижте в наръчника : [Как да търсим транспортни спирки наблизо с API?](https://www.roote.ai/bg/guides/kak-da-tarsim-blizkite-prestani-s-api-roote/)

## Ширина

Координата за север или юг от екватора, измерена в градуси. Валидни стойности −90 до 90.

Пример : Ширината на търсената точката се подава като lat.

Вижте в наръчника : [Как да търсим транспортни спирки наблизо с API?](https://www.roote.ai/bg/guides/kak-da-tarsim-blizkite-prestani-s-api-roote/)

## Дължина

Координата за изток или запад от главния меридиан, измерена между −180 и 180 градуса.

Пример : Дължината може да се подава като lon или lng (алиас).

Вижте в наръчника : [Как да търсим транспортни спирки наблизо с API?](https://www.roote.ai/bg/guides/kak-da-tarsim-blizkite-prestani-s-api-roote/)

## Геокодиране

Превръщане на адрес или географско изражение в кандидати с координати. Могат да се върнат няколко места за една заявка.

Пример : Два града имат улица със същото име.

Вижте в наръчника : [Как да създадем асистент, който намира мобилност около даден адрес?](https://www.roote.ai/bg/guides/kak-da-sazdaem-asistent-za-mobilnost-okolo-adres/)

## Обратно геокодиране

Търсене на места или имена по координати. Резултатът може да е близо до локацията, а не точен адрес.

Пример : GPS точка се свързва с четимо име.

Вижте в наръчника : [Какво е MCP сървър и за какво служи?](https://www.roote.ai/bg/guides/kakvo-e-mcp-server-i-za-kakvo-sluzhi/)

## Точка на интерес — POI

Определено място от полза при търсене, напр. заведение или съоръжение. POI е различно от обикновен адрес.

Пример : Името на хотел може да се търси като заведение.

Вижте в наръчника : [Как да създадем асистент, който намира мобилност около даден адрес?](https://www.roote.ai/bg/guides/kak-da-sazdaem-asistent-za-mobilnost-okolo-adres/)

## Начална точка на търсене

Точка, от която се извършва търсене по близост и се изчисляват разстоянията. Може да се различава от центъра показан на картата.

Пример : Камерата се движи, но търсенето е фиксирано на Бордо.

Вижте в наръчника : [Как да интегрирате карта за мобилност в своя сайт?](https://www.roote.ai/bg/guides/kak-da-integrirate-karta-za-mobilnost-vashiya-sait/)

## Радиус на търсене

Разстояние около началната точка, което ограничава търсенето. Единици и граници варират спрямо договора или инструмент.

Пример : radius=600 задава радиус 600 метра в REST пример.

Вижте в наръчника : [Как да търсим транспортни спирки наблизо с API?](https://www.roote.ai/bg/guides/kak-da-tarsim-blizkite-prestani-s-api-roote/)

## Географско разстояние

Разстояние изчислено между позиции според метода на услугата. Не е непременно маршрутен километраж или време за ходене.

Пример : Близко място може да изисква заобиколка за достигане.

Вижте в наръчника : [Как да търсим транспортни спирки наблизо с API?](https://www.roote.ai/bg/guides/kak-da-tarsim-blizkite-prestani-s-api-roote/)

## Ниво на приближение на карта

Степен на увеличение на картата. Управлява показването, но не замества радиуса на API заявка.

Пример : zoom=15 наближава картата.

Вижте в наръчника : [Как да интегрирате карта за мобилност в своя сайт?](https://www.roote.ai/bg/guides/kak-da-integrirate-karta-za-mobilnost-vashiya-sait/)

## Данни в реално време

Актуализирана информация за показване на текущо състояние или за прогнозиране. Точността и закъснението варират; не е гаранция за моментална точност.

Пример : Оценка за преминаване се пресмята с нови данни.

Вижте в наръчника : [Разписание на автобусите: каква е разликата между теоретични и реално време?](https://www.roote.ai/bg/guides/razpisanie-na-avtobusite-kakva-e-razlikata-mezhdu-teoretichni-i-realno-vreme/)

## Наблюдение

Статус или събитие, установено в конкретен момент. Различава се от планирано или изчислено събитие.

Пример : Реалното преминаване на автобус може да се различава от прогнозата.

Вижте в наръчника : [Разписание на автобусите: каква е разликата между теоретични и реално време?](https://www.roote.ai/bg/guides/razpisanie-na-avtobusite-kakva-e-razlikata-mezhdu-teoretichni-i-realno-vreme/)

## Свежест на данните

Оценка за актуалност според дати и правила на договора. Времето на заявка не гарантира свежест на източника.

Пример : Брояч получен сега може да е от стара наблюдателна точка.

Вижте в наръчника : [Наличност на колелета в реално време: как да се показва в приложение?](https://www.roote.ai/bg/guides/nalichnost-na-kolichkite-v-realno-vreme-kak-da-se-pokaje-v-prilozhenie/)

## Отбелязано време (таймстамп)

Времева маркировка, свързана с данни или събитие. Значението зависи от полето: наблюдение, обновление, приемане или изтичане.

Пример : source_updated_at и received_at описват различни етапи.

Вижте в наръчника : [Наличност на колелета в реално време: как да се показва в приложение?](https://www.roote.ai/bg/guides/nalichnost-na-kolichkite-v-realno-vreme-kak-da-se-pokaje-v-prilozhenie/)

## Остарели данни — stale

Информация, смятана за прекалено стара спрямо договор или политика. Може да се съхранява като скорошна история, но не като свежа.

Пример : Интерфейсът показва, че наличността трябва да се обнови.

Вижте в наръчника : [Наличност на колелета в реално време: как да се показва в приложение?](https://www.roote.ai/bg/guides/nalichnost-na-kolichkite-v-realno-vreme-kak-da-se-pokaje-v-prilozhenie/)

## Време на живот — TTL

Период, използван за валидност или обновяване на кеширани данни според договора. Не доказва директно времето на наблюдение.

Пример : Изтекъл кеш следва политика за обновяване.

Вижте в наръчника : [Наличност на колелета в реално време: как да се показва в приложение?](https://www.roote.ai/bg/guides/nalichnost-na-kolichkite-v-realno-vreme-kak-da-se-pokaje-v-prilozhenie/)

## Кеш

Временен сторидж на резултати за избягване на повторни идентични търсения. Кеш значението запазва изхода и времевия контекст.

Пример : Две еднакви заявки могат да ползват валиден кеш отговор.

Вижте в наръчника : [Наличност на колелета в реално време: как да се показва в приложение?](https://www.roote.ai/bg/guides/nalichnost-na-kolichkite-v-realno-vreme-kak-da-se-pokaje-v-prilozhenie/)

## Покритие

Обхват и степен на пълнота на наличните данни за търсене или източник. Частичното покритие ограничава заключенията.

Пример : Списък може да е полезен, без да включва всички услуги.

Вижте в наръчника : [Празен резултат или API грешка: как да направим разлика?](https://www.roote.ai/bg/guides/prazni-rezultati-ili-greshka-api-kak-da-otlichim/)

## Произход

Информация за произхода на данните и как са генерирани според договора. Помага за тълкуване на обхвата.

Пример : Резултатът пази източника и контекста на събиране.

Вижте в наръчника : [Как да създадем асистент, който намира мобилност около даден адрес?](https://www.roote.ai/bg/guides/kak-da-sazdaem-asistent-za-mobilnost-okolo-adres/)

## Атрибуция

Споменаване на доставчика или източника на данните. Когато е необходимо, приложението трябва да я изведе.

Пример : Ако е required=true, трябва да се показва на интерфейса.

Вижте в наръчника : [Как да търсим транспортни спирки наблизо с API?](https://www.roote.ai/bg/guides/kak-da-tarsim-blizkite-prestani-s-api-roote/)

## GTFS Schedule

Стандартен формат за описание на транспортното разписание: спирки, линии, курсове, календари и преминавания. Не предлага реалновременни обновления по подразбиране.

Пример : Планираните преминавания са свързани с курсове и дни на услуги.

Вижте в наръчника : [GTFS, GTFS-RT и GBFS: какви са разликите?](https://www.roote.ai/bg/guides/gtfs-gtfs-rt-i-gbfs-kakvi-sa-razlikite/)

## GTFS Realtime — GTFS-RT

Стандартен формат за предаване на обновления за курсове, позиции на превозни средства и предупреждения. Публикуваните категории зависят от производителя.

Пример : Потоци с позиции не означават оценка за всички спирки.

Вижте в наръчника : [GTFS, GTFS-RT и GBFS: какви са разликите?](https://www.roote.ai/bg/guides/gtfs-gtfs-rt-i-gbfs-kakvi-sa-razlikite/)

## GBFS

Стандартен формат за публични данни за споделена мобилност. В зависимост от версията описва системи, станции, превозни средства и статуси.

Пример : Информация за станции и наличност са разделени в отделни потоци.

Вижте в наръчника : [GTFS, GTFS-RT и GBFS: какви са разликите?](https://www.roote.ai/bg/guides/gtfs-gtfs-rt-i-gbfs-kakvi-sa-razlikite/)

## Непозната стойност — null

Липса на известна стойност според договор, използващ null за тази цел. Не трябва да се замества с нула, лъжливо или доказателство за отсъствие.

Пример : Брояч на велосипеди стойност null не означава празна станция.

Вижте в наръчника : [Празен резултат или API грешка: как да направим разлика?](https://www.roote.ai/bg/guides/prazni-rezultati-ili-greshka-api-kak-da-otlichim/)

## API

Интерфейс, позволяващ на програма да използва възможностите на друг сервис чрез дефиниран договор. Описва входове и изходи.

Пример : Приложение търси спирки чрез API на ROOTE.

Вижте в наръчника : [API или MCP: кой да изберете за интегриране на данни за мобилност?](https://www.roote.ai/bg/guides/api-ili-mcp-izbor-za-integraciya-na-danni-za-mobilnost/)

## API REST

HTTP интерфейсна концепция, използваща ресурси и уеб механизми. Договорът на API описва маршрутите, методите и представянията.

Пример : Търсенето се изпраща на документирана GET заявка.

Вижте в наръчника : [Как да търсим транспортни спирки наблизо с API?](https://www.roote.ai/bg/guides/kak-da-tarsim-blizkite-prestani-s-api-roote/)

## Endpoint — API маршрут

Адрес и операция от API за дадена възможност. Различни маршрути връщат различни резултатни групи.

Пример : /v1/transit/nearby търси транспортни места.

Вижте в наръчника : [Как да търсим транспортни спирки наблизо с API?](https://www.roote.ai/bg/guides/kak-da-tarsim-blizkite-prestani-s-api-roote/)

## Параметър на заявка

Стойност, подадена в URL след въпросителен знак. Име и формат са описани от интерфейса.

Пример : modes=bus,tram избира режими в съвместим URL.

Вижте в наръчника : [Как да интегрирате карта за мобилност в своя сайт?](https://www.roote.ai/bg/guides/kak-da-integrirate-karta-za-mobilnost-vashiya-sait/)

## HTTP статус

Код, показващ резултат на HTTP заявка. Трябва да се комбинира с валидирането на съдържанието и бизнес статуса.

Пример : HTTP 200 може да съдържа бизнес грешка.

Вижте в наръчника : [Празен резултат или API грешка: как да направим разлика?](https://www.roote.ai/bg/guides/prazni-rezultati-ili-greshka-api-kak-da-otlichim/)

## Празен резултат — empty

Търсене, което не връща обекти в разглеждания обхват. Не доказва физическо отсътствие на услуги извън данните.

Пример : Няма върнати спирки с приложените филтри.

Вижте в наръчника : [Празен резултат или API грешка: как да направим разлика?](https://www.roote.ai/bg/guides/prazni-rezultati-ili-greshka-api-kak-da-otlichim/)

## Частичен отговор — partial

Резултат с ограничени или липсващи данни, придружен с предупреждения. Трябва да предоставя релевантни индикатори.

Пример : Един източник отговаря, друг е недостъпен.

Вижте в наръчника : [Празен резултат или API грешка: как да направим разлика?](https://www.roote.ai/bg/guides/prazni-rezultati-ili-greshka-api-kak-da-otlichim/)

## Време изтекло — timeout

Прекъсване на чакане за операция, превишаващо определено време. Показва неуспешно търсене, не липса на резултати.

Пример : Приложението предлага повторен опит вместо празен списък.

Вижте в наръчника : [Празен резултат или API грешка: как да направим разлика?](https://www.roote.ai/bg/guides/prazni-rezultati-ili-greshka-api-kak-da-otlichim/)

## Лимит на честота — rate limit

Ограничение за брой запитвания към услуга. Правила и рестарт зависят от активния договор.

Пример : Код 429 указва да се спазват указанията за рестарт.

Вижте в наръчника : [Празен резултат или API грешка: как да направим разлика?](https://www.roote.ai/bg/guides/prazni-rezultati-ili-greshka-api-kak-da-otlichim/)

## Bearer токен

Идентификатор за достъп в Authorization заглавка по зададен механизъм. Трябва да се пази в защитена среда.

Пример : Authorization: Bearer се ползва без публикуване в URL.

Вижте в наръчника : [Как да свържете ИИ асистент към MCP ROOTE?](https://www.roote.ai/bg/guides/kak-da-svyazhem-ia-asistent-s-mcp-roote/)

## JSON

Структуриран текстов формат с обекти, масиви, низове и числа. Синтактично валиден JSON може да не следва API схема.

Пример : Колекцията stations трябва да има очаквания тип и полета.

Вижте в наръчника : [Как да търсим транспортни спирки наблизо с API?](https://www.roote.ai/bg/guides/kak-da-tarsim-blizkite-prestani-s-api-roote/)

## OpenAPI

Спецификация, описваща HTTP API договор в структуриран документ. Помага да се валидират маршрути, параметри, отговори и схеми.

Пример : Договорът на ROOTE е публикуван в openapi.json.

Вижте в наръчника : [Как да търсим транспортни спирки наблизо с API?](https://www.roote.ai/bg/guides/kak-da-tarsim-blizkite-prestani-s-api-roote/)

## Embed — вградена карта

Вграждане на външен интерфейс в страница, напр. карта в iframe. Параметри и разрешения контролират контекста на ползване.

Пример : ROOTE iframe показва велосипеди около Бордо.

Вижте в наръчника : [Как да интегрирате карта за мобилност в своя сайт?](https://www.roote.ai/bg/guides/kak-da-integrirate-karta-za-mobilnost-vashiya-sait/)

## Iframe

HTML елемент за зареждане на документ в страница. При различни домейни родителят не може свободно да чете състоянието на въпросния документ.

Пример : Промените в търсенето изискват документиран обмен към родителя.

Вижте в наръчника : [Как да интегрирате карта за мобилност в своя сайт?](https://www.roote.ai/bg/guides/kak-da-integrirate-karta-za-mobilnost-vashiya-sait/)

## MCP — Model Context Protocol

Протокол за комуникация между IA приложение и сервери с инструменти или контекст. Не задава качеството на върнатите данни само по себе си.

Пример : Асистент открива инструментите за търсене на ROOTE.

Вижте в наръчника : [Какво е MCP сървър и за какво служи?](https://www.roote.ai/bg/guides/kakvo-e-mcp-server-i-za-kakvo-sluzhi/)

## MCP сървър

Софтуер, предоставящ възможности според MCP протокол. Декларираните инструменти определят какво клиентът може да ползва.

Пример : tools/list позволява да видите наличния инвентар.

Вижте в наръчника : [Какво е MCP сървър и за какво служи?](https://www.roote.ai/bg/guides/kakvo-e-mcp-server-i-za-kakvo-sluzhi/)

## MCP клиент

Компонент на IA приложение, който комуникира със MCP сървър. Управлява протоколните обмени за тази връзка.

Пример : Клиентът подава параметри за търсене към ROOTE.

Вижте в наръчника : [Какво е MCP сървър и за какво служи?](https://www.roote.ai/bg/guides/kakvo-e-mcp-server-i-za-kakvo-sluzhi/)

## MCP хост приложение

Приложение, приемащо потребителско взаимодействие и управляващо един или повече MCP клиенти. Отговаря за използването на резултатите.

Пример : Вашето чат приложение се свързва със сървър ROOTE.

Вижте в наръчника : [Какво е MCP сървър и за какво служи?](https://www.roote.ai/bg/guides/kakvo-e-mcp-server-i-za-kakvo-sluzhi/)

## MCP инструмент

Изпълним капацитет, описан с име, функция и схема на аргументи. Асистентът трябва да ползва позволените входни параметри.

Пример : geocode приема адрес; transit_nearby – координати.

Вижте в наръчника : [Как да свържете ИИ асистент към MCP ROOTE?](https://www.roote.ai/bg/guides/kak-da-svyazhem-ia-asistent-s-mcp-roote/)

## Streamable HTTP

MCP транспорт, позволяващ комуникация с отдалечен сървър по HTTP. Трябва да е поддържан от използвания клиент.

Пример : ROOTE отдалечен сървър използва https://mcp.roote.ai/mcp.

Вижте в наръчника : [Как да свържете ИИ асистент към MCP ROOTE?](https://www.roote.ai/bg/guides/kak-da-svyazhem-ia-asistent-s-mcp-roote/)

## Отговор, основан на данни — grounding

Отговор, конструиран от фактически получена или предоставена информация. Липсващи полета и условности трябва да са видими.

Пример : Асистентът използва върнатите локации без да измисля графици.

Вижте в наръчника : [Как да създадем асистент, който намира мобилност около даден адрес?](https://www.roote.ai/bg/guides/kak-da-sazdaem-asistent-za-mobilnost-okolo-adres/)

## Халюцинация на IA асистент

Създаване на неподдържана информация, представена като известна. В мобилността може да е измислено време или наличност.

Пример : Асистентът обявява преминаване, което инструментът не е върнал.

Вижте в наръчника : [Как да създадем асистент, който намира мобилност около даден адрес?](https://www.roote.ai/bg/guides/kak-da-sazdaem-asistent-za-mobilnost-okolo-adres/)

## Инжектиране на подканващи инструкции

Опит да се внесе външно съдържание, променящо поведението на асистент. Описанията на доставчици са данни, не команди.

Пример : Скрито във име на място указание не бива да се изпълнява.

Вижте в наръчника : [Как да създадем асистент, който намира мобилност около даден адрес?](https://www.roote.ai/bg/guides/kak-da-sazdaem-asistent-za-mobilnost-okolo-adres/)

## Само четене

Възможност за преглед без промяна чрез инструмента. Преглед на наличност не резервира, отключва или наема превозно средство.

Пример : ROOTE Data инструменти служат за преглед на информация.

Вижте в наръчника : [Какво е MCP сървър и за какво служи?](https://www.roote.ai/bg/guides/kakvo-e-mcp-server-i-za-kakvo-sluzhi/)