# Глосарій мобільності та даних.

Прості визначення для розуміння транспорту, локальних сервісів та інструментів, що зв’язують їх з вашими застосунками.

Source: https://www.roote.ai/uk/mobilnist-hlosarii/
Language: uk
Author: ROOTE

## Велосипед із вільним доступом

Сервіс для тимчасового користування велосипедом за умовами оператора. Може працювати через станції або без них.

Приклад : Ви знаходите велосипед і використовуєте відповідний сервіс оренди.

Поглибити у гіді : [Як знайти велосипед вільного доступу поблизу?](https://www.roote.ai/uk/guides/yak-znayty-velosyped-vilnoservisno-poblyzy-sebe/)

## Спільна мобільність

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

Приклад : Велосипеди та самокати, доступні для оренди у місті.

Поглибити у гіді : [Як знайти велосипед вільного доступу поблизу?](https://www.roote.ai/uk/guides/yak-znayty-velosyped-vilnoservisno-poblyzy-sebe/)

## Термінал прикріплення

Обладнання станції, до якого можна закріпити велосипед. Наявність не гарантує можливості повернення в даний момент.

Приклад : Має бути вільне місце для повернення, придатне для використання.

Поглибити у гіді : [Порожня або повна станція велосипедів: що робити?](https://www.roote.ai/uk/guides/stantsiya-velosipediv-pustaya-abo-povnaya-shho-robyty/)

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

Організоване місце для взяття або повернення спільних велосипедів. Координати, ємність і доступність описують різні аспекти станції.

Приклад : Станція може бути на карті, але тимчасово порожньою.

Поглибити у гіді : [Порожня або повна станція велосипедів: що робити?](https://www.roote.ai/uk/guides/stantsiya-velosipediv-pustaya-abo-povnaya-shho-robyty/)

## Безстанційна — free-floating

Організація, де транспортні засоби можна брати чи залишати не обов’язково біля стаціонарного терміналу. Зони та правила паркування визначає сервіс.

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

Поглибити у гіді : [Велосипед зі станції чи без неї: у чому різниця?](https://www.roote.ai/uk/guides/velo-v-stantsii-chym-vidriznyaiutsia/)

## Доступність

Стан або кількість, що вказує, що можна використати за відомими даними. Спостережена доступність може змінитись і не є бронюванням.

Приклад : Три велосипеди на станції – це не три заброньовані велосипеди.

Поглибити у гіді : [Доступність велосипедів у реальному часі: як її відобразити в додатку?](https://www.roote.ai/uk/guides/disponibilnist-velosipediv-v-realnomu-chasi-yak-vidobraziti-v-dodatku/)

## Взяття транспортного засобу

Дія початку використання транспортного засобу. Позитивний лічильник недостатній, якщо сервіс повідомляє про відключення взяття.

Приклад : Велосипеди є, але станція може не дозволяти оренду.

Поглибити у гіді : [Доступність велосипедів у реальному часі: як її відобразити в додатку?](https://www.roote.ai/uk/guides/disponibilnist-velosipediv-v-realnomu-chasi-yak-vidobraziti-v-dodatku/)

## Повернення

Завершення користування транспортним засобом відповідно до правил сервісу. Можливості повернення та взяття можуть відрізнятися.

Приклад : Станція дозволяє виїздати, але немає місць для повернення.

Поглибити у гіді : [Порожня або повна станція велосипедів: що робити?](https://www.roote.ai/uk/guides/stantsiya-velosipediv-pustaya-abo-povnaya-shho-robyty/)

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

Велосипед, у якому двигун допомагає під час педалювання згідно з характеристиками. Тип приводу та акумулятор можуть бути вказані окремо в даних.

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

Поглибити у гіді : [Доступність велосипедів у реальному часі: як її відобразити в додатку?](https://www.roote.ai/uk/guides/disponibilnist-velosipediv-v-realnomu-chasi-yak-vidobraziti-v-dodatku/)

## Інтермодальність

Послідовне використання кількох видів транспорту в одному маршруті. Кожен етап має свої графіки, умови і доступ.

Приклад : Ви добираєтесь трамваєм на велосипеді, потім йдете пішки.

Поглибити у гіді : [Як поєднувати велосипед і громадський транспорт щоденно?](https://www.roote.ai/uk/guides/yak-sumishtuvati-velosiped-ta-hromadskij-transport-u-povsyakdennomu/)

## Зупинка транспорту

Місце, де транспортний сервіс бере чи висаджує пасажирів. Відкрита зупинка не гарантує інформацію про наступні рейси.

Приклад : Зупинка автобуса повернута без інформації про відправлення.

Поглибити у гіді : [Як знайти найближчу зупинку автобуса або трамвая?](https://www.roote.ai/uk/guides/yak-znayty-nayblyzhchu-zupynku-avtobusa-abo-tramu/)

## Платформа

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

Приклад : Різні напрямки лінії можуть мати окремі платформи.

Поглибити у гіді : [Як знайти правильну зупинку автобуса та напрямок?](https://www.roote.ai/uk/guides/yak-znayty-pravylnu-zupynku-avtobusa-ta-pravylnyu-napryamok/)

## Лінія

Транспортний сервіс у мережі з одним або кількома маршрутами або варіантами. Назва лінії сама не визначає напрямок руху.

Приклад : Одна лінія може мати кілька кінцевих зупинок.

Поглибити у гіді : [Як знайти правильну зупинку автобуса та напрямок?](https://www.roote.ai/uk/guides/yak-znayty-pravylnu-zupynku-avtobusa-ta-pravylnyu-napryamok/)

## Рейс

Виконання транспортного сервісу за маршрутом і зупинками. В GTFS рейс прив’язаний до лінії і календаря сервісу.

Приклад : Два послідовні відправлення однієї лінії – це два рейси.

Поглибити у гіді : [GTFS, GTFS-RT та GBFS: які відмінності?](https://www.roote.ai/uk/guides/gtfs-gtfs-rt-ta-gbfs-yaki-vidminy/)

## Напрямок

Вказівка напрямку або пункту призначення сервісу. Треба перевіряти з маршрутом і місцем посадки.

Приклад : Ви шукаєте трамвай у вашому напрямку, не навпаки.

Поглибити у гіді : [Як знайти правильну зупинку автобуса та напрямок?](https://www.roote.ai/uk/guides/yak-znayty-pravylnu-zupynku-avtobusa-ta-pravylnyu-napryamok/)

## Кінцева зупинка

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

Приклад : Скорочений сервіс завершується перед звичайною кінцевою зупинкою.

Поглибити у гіді : [Як знайти правильну зупинку автобуса та напрямок?](https://www.roote.ai/uk/guides/yak-znayty-pravylnu-zupynku-avtobusa-ta-pravylnyu-napryamok/)

## Пересадка

Перехід між сервісами або видами транспорту в маршруті. Близькість двох зупинок не гарантує можливу пересадку.

Приклад : Потрібно планувати рух між платформами і час очікування.

Поглибити у гіді : [Як читати схему автобуса, трамвая чи метро?](https://www.roote.ai/uk/guides/yak-prochitati-skhemu-avtobusa-tramuva-abo-metro/)

## Запланований час

Час за графіком для конкретної дати і рейсу. Не завжди відображає поточне положення транспорту.

Приклад : Відправлення заплановано на 8:10 у календарі.

Поглибити у гіді : [Розклад автобусів: яка різниця між теоретичним і фактичним розкладом?](https://www.roote.ai/uk/guides/rozklad-avtobusiv-yaka-riznytsya-mizh-teoretychnymy-ta-faktuchnymy-rozkladamy/)

## Оцінений час

Передбачуваний майбутній час розрахований з наявних даних, може змінюватись при оновленні інформації.

Приклад : Прохід, запланований на 8:10, оцінюється зараз як 8:14.

Поглибити у гіді : [Розклад автобусів: яка різниця між теоретичним і фактичним розкладом?](https://www.roote.ai/uk/guides/rozklad-avtobusiv-yaka-riznytsya-mizh-teoretychnymy-ta-faktuchnymy-rozkladamy/)

## Наступний відправлення

Очікуваний прохід або відправлення для місця і сервісу. Знаходження зупинки — не те саме, що пошук наступних відправлень.

Приклад : Список зупинок і список відправлень — різні результати.

Поглибити у гіді : [Як шукати найближчі зупинки транспорту за допомогою API?](https://www.roote.ai/uk/guides/yak-znajty-zupynky-transportu-poblyzy-iz-api-roote/)

## Порушення руху

Подія, що впливає на транспортний сервіс — зупинка чи зміна маршруту. Вплив описується територією і періодом.

Приклад : Сповіщення може торкатися лише однієї лінії в певні години.

Поглибити у гіді : [Як створити асистента, який знаходить мобільність навколо адреси?](https://www.roote.ai/uk/guides/yak-stvoriti-asistenta-yakij-znajde-mobilnist-navkolo-adresi/)

## Календар сервісу

Відомості про дні роботи сервісу з винятками. Графіки інтерпретуються з урахуванням цього календаря.

Приклад : Сервіс у будні може не працювати у вихідні.

Поглибити у гіді : [GTFS, GTFS-RT та GBFS: які відмінності?](https://www.roote.ai/uk/guides/gtfs-gtfs-rt-ta-gbfs-yaki-vidminy/)

## Міський сервіс

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

Приклад : Результат пошуку описує сервіс і відомі дані.

Поглибити у гіді : [Як шукати найближчі зупинки транспорту за допомогою API?](https://www.roote.ai/uk/guides/yak-znajty-zupynky-transportu-poblyzy-iz-api-roote/)

## Громадські туалети

Туалети для загального користування за місцевими умовами. Наявність у даних не гарантує безплатність, відкритість або доступність.

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

Поглибити у гіді : [Як знайти безкоштовні громадські туалети поруч?](https://www.roote.ai/uk/guides/yak-znayty-bezplatni-gromadski-vanitya-poryad/)

## Доступність

Характеристики, що дозволяють користуватися місцем або сервісом за потребами користувача. Відсутність даних не означає ні доступності, ні її відсутності.

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

Поглибити у гіді : [Доступні громадські туалети: що перевірити перед поїздкою?](https://www.roote.ai/uk/guides/dostupni-gromadski-tualeti-shho-pereviryty/)

## Особи з обмеженою мобільністю — ООМ

Особи, які мають тимчасові або постійні труднощі з пересуванням. Позначка ООМ не розкриває всі необхідні умови доступу чи обладнання.

Приклад : Наявність пандуса не позначає всі можливі бар’єри.

Поглибити у гіді : [Доступні громадські туалети: що перевірити перед поїздкою?](https://www.roote.ai/uk/guides/dostupni-gromadski-tualeti-shho-pereviryty/)

## Години роботи

Періоди, коли місце оголошено відкритим. Не є підтвердженням безпосередньої роботи в даний момент.

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

Поглибити у гіді : [Як знайти безкоштовні громадські туалети поруч?](https://www.roote.ai/uk/guides/yak-znayty-bezplatni-gromadski-vanitya-poryad/)

## Питна вода

Вода, придатна для вживання людиною. Точки води чи фонтани не слід позначати як питні без явного підтвердження.

Приклад : Тип обладнання та його функції слід розділяти.

Поглибити у гіді : [Як шукати найближчі зупинки транспорту за допомогою API?](https://www.roote.ai/uk/guides/yak-znajty-zupynky-transportu-poblyzy-iz-api-roote/)

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

Обладнання для зарядки сумісного транспортного засобу. Локація не гарантує наявність вільних точок або сумісність конекторів.

Приклад : Місце зарядки та його стан – різні відомості.

Поглибити у гіді : [Як шукати найближчі зупинки транспорту за допомогою API?](https://www.roote.ai/uk/guides/yak-znajty-zupynky-transportu-poblyzy-iz-api-roote/)

## Тип сервісу

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

Приклад : API сервісів ROOTE використовує types=toilets для туалетів.

Поглибити у гіді : [Як шукати найближчі зупинки транспорту за допомогою API?](https://www.roote.ai/uk/guides/yak-znajty-zupynky-transportu-poblyzy-iz-api-roote/)

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

Отримання географічної позиції пристроєм або додатком. Залежить від дозволів і точності.

Приклад : Кнопка місцезнаходження запитує дозвіл браузера.

Поглибити у гіді : [Як інтегрувати карту мобільності у свій сайт?](https://www.roote.ai/uk/guides/yak-integruvaty-kartu-mobilnosti-u-svij-sajt/)

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

Значення, що представляють точку на мапі, зазвичай широта та довгота. Порядок слід уточнити в інтерфейсі.

Приклад : Пошук поблизу приймає дві окремі координати.

Поглибити у гіді : [Як шукати найближчі зупинки транспорту за допомогою API?](https://www.roote.ai/uk/guides/yak-znajty-zupynky-transportu-poblyzy-iz-api-roote/)

## Широта

Координата, що вказує положення на північ або південь від екватора, градуси у прикладах ROOTE. Значення від −90 до 90.

Приклад : Широта точки пошуку передається в lat.

Поглибити у гіді : [Як шукати найближчі зупинки транспорту за допомогою API?](https://www.roote.ai/uk/guides/yak-znajty-zupynky-transportu-poblyzy-iz-api-roote/)

## Довгота

Координата положення по сходу або заходу від меридіана. У прикладах ROOTE градуси від −180 до 180.

Приклад : Довгота може передаватися в lon або в документованому псевдонімі lng.

Поглибити у гіді : [Як шукати найближчі зупинки транспорту за допомогою API?](https://www.roote.ai/uk/guides/yak-znajty-zupynky-transportu-poblyzy-iz-api-roote/)

## Геокодування

Пошук перетворює адресу чи географічний вираз у кандидати з координатами. Місць з однаковою назвою може бути кілька.

Приклад : Дві різні міські вулиці з однаковою назвою.

Поглибити у гіді : [Як створити асистента, який знаходить мобільність навколо адреси?](https://www.roote.ai/uk/guides/yak-stvoriti-asistenta-yakij-znajde-mobilnist-navkolo-adresi/)

## Зворотне геокодування

Пошук місць чи назв за координатами. Результат може відображати найближче місце, а не точну адресу.

Приклад : Точка GPS пов’язується з читабельною назвою.

Поглибити у гіді : [Що таке сервер MCP і для чого він потрібен?](https://www.roote.ai/uk/guides/chto-take-server-mcp-i-dlya-chogo-vin-potriben/)

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

Впізнаване місце, корисне для пошуку, наприклад заклад чи обладнання. Відрізняється від звичайної поштової адреси.

Приклад : Назва готелю шукається як заклад.

Поглибити у гіді : [Як створити асистента, який знаходить мобільність навколо адреси?](https://www.roote.ai/uk/guides/yak-stvoriti-asistenta-yakij-znajde-mobilnist-navkolo-adresi/)

## Точка початку пошуку

Точка, від якої виконується пошук поблизу, і від якої рахується відстань. Може відрізнятися від центру карти.

Приклад : Камера рухається, але пошук залишається на Бордо.

Поглибити у гіді : [Як інтегрувати карту мобільності у свій сайт?](https://www.roote.ai/uk/guides/yak-integruvaty-kartu-mobilnosti-u-svij-sajt/)

## Радіус пошуку

Відстань навколо початку, що обмежує пошук. Одиниці та межі залежать від контракту маршруту або інструменту.

Приклад : radius=600 в REST-запиті означає радіус 600 метрів.

Поглибити у гіді : [Як шукати найближчі зупинки транспорту за допомогою API?](https://www.roote.ai/uk/guides/yak-znajty-zupynky-transportu-poblyzy-iz-api-roote/)

## Географічна відстань

Відстань між позиціями, обчислена за методикою сервісу. Не завжди відповідає маршруту або часу пішого руху.

Приклад : Ближче місце може вимагати об’їзду для доступу.

Поглибити у гіді : [Як шукати найближчі зупинки транспорту за допомогою API?](https://www.roote.ai/uk/guides/yak-znajty-zupynky-transportu-poblyzy-iz-api-roote/)

## Зум карти

Рівень наближення карти. Контролює відображення, але не замінює радіус API-запиту.

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

Поглибити у гіді : [Як інтегрувати карту мобільності у свій сайт?](https://www.roote.ai/uk/guides/yak-integruvaty-kartu-mobilnosti-u-svij-sajt/)

## Дані в реальному часі

Оновлена інформація для відображення актуальної ситуації або оцінки. Свіжість треба оцінювати; реальний час не гарантує миттєвості.

Приклад : Оцінка проходження оновлюється з новими даними.

Поглибити у гіді : [Розклад автобусів: яка різниця між теоретичним і фактичним розкладом?](https://www.roote.ai/uk/guides/rozklad-avtobusiv-yaka-riznytsya-mizh-teoretychnymy-ta-faktuchnymy-rozkladamy/)

## Спостереження

Стан або подія в певний момент часу. Має відрізнятися від майбутньої події чи плану.

Приклад : Фактичний прохід автобуса може відрізнятись від оголошеного прогнозу.

Поглибити у гіді : [Розклад автобусів: яка різниця між теоретичним і фактичним розкладом?](https://www.roote.ai/uk/guides/rozklad-avtobusiv-yaka-riznytsya-mizh-teoretychnymy-ta-faktuchnymy-rozkladamy/)

## Свіжість даних

Оцінка актуальності інформації за датами та правилами контракту. Час запиту не доводить свіжість джерела.

Приклад : Лічильник, отриманий зараз, може відображати старе спостереження.

Поглибити у гіді : [Доступність велосипедів у реальному часі: як її відобразити в додатку?](https://www.roote.ai/uk/guides/disponibilnist-velosipediv-v-realnomu-chasi-yak-vidobraziti-v-dodatku/)

## Позначка часу

Часова інформація, пов’язана з даними або подією. Значення залежить від поля: спостереження, оновлення, прийняття або закінчення.

Приклад : source_updated_at та received_at описують різні етапи.

Поглибити у гіді : [Доступність велосипедів у реальному часі: як її відобразити в додатку?](https://www.roote.ai/uk/guides/disponibilnist-velosipediv-v-realnomu-chasi-yak-vidobraziti-v-dodatku/)

## Застарілі дані — stale

Інформація вважається надто старою згідно контракту або політики дійсності. Може зберігатись як історична, без презентування як актуальна.

Приклад : Інтерфейс показує, що доступність потрібно оновити.

Поглибити у гіді : [Доступність велосипедів у реальному часі: як її відобразити в додатку?](https://www.roote.ai/uk/guides/disponibilnist-velosipediv-v-realnomu-chasi-yak-vidobraziti-v-dodatku/)

## Термін дійсності — TTL

Тривалість, що використовується для керування дійсністю або оновленням кешованих даних за контрактом. Не доказує час спостереження джерела.

Приклад : Закінчений кеш оновлюють за політикою оновлення.

Поглибити у гіді : [Доступність велосипедів у реальному часі: як її відобразити в додатку?](https://www.roote.ai/uk/guides/disponibilnist-velosipediv-v-realnomu-chasi-yak-vidobraziti-v-dodatku/)

## Кеш

Тимчасове зберігання результатів для уникнення повторних ідентичних пошуків. Значення в кеші зберігає походження та час контексту.

Приклад : Дві однакові запити можуть повторно використати один валідний відповідь.

Поглибити у гіді : [Доступність велосипедів у реальному часі: як її відобразити в додатку?](https://www.roote.ai/uk/guides/disponibilnist-velosipediv-v-realnomu-chasi-yak-vidobraziti-v-dodatku/)

## Покриття

Область та ступінь повноти інформації для пошуку чи джерела. Часткове покриття обмежує висновки.

Приклад : Список може бути корисним, не охоплюючи всі сервіси.

Поглибити у гіді : [Порожній результат чи помилка API: як розрізнити?](https://www.roote.ai/uk/guides/vidchynyj-rezultat-chy-pomylka-api-yak-rozyznyty/)

## Походження

Інформація, що дозволяє ідентифікувати джерело даних та, згідно контракту, метод їх отримання. Допомагає інтерпретувати значення.

Приклад : Результат містить джерело та контекст збору.

Поглибити у гіді : [Як створити асистента, який знаходить мобільність навколо адреси?](https://www.roote.ai/uk/guides/yak-stvoriti-asistenta-yakij-znajde-mobilnist-navkolo-adresi/)

## Атрибуція

Вказівка постачальника або джерела даних. Якщо потрібна, інтерфейс має відображати цю інформацію.

Приклад : Атрибуція required=true повинна зберігатись у інтерфейсі.

Поглибити у гіді : [Як шукати найближчі зупинки транспорту за допомогою API?](https://www.roote.ai/uk/guides/yak-znajty-zupynky-transportu-poblyzy-iz-api-roote/)

## GTFS Schedule

Стандартний формат опису планованої транспортної пропозиції: зупинки, лінії, рейси, календарі та проходи. Не включає реального часу автоматично.

Приклад : Заплановані проходи пов’язані з рейсами та днями сервісу.

Поглибити у гіді : [GTFS, GTFS-RT та GBFS: які відмінності?](https://www.roote.ai/uk/guides/gtfs-gtfs-rt-ta-gbfs-yaki-vidminy/)

## GTFS Realtime — GTFS-RT

Стандартний формат для передачі оновлень рейсів, позицій транспортних засобів та сповіщень. Реальні типи публікованих даних залежать від виробника.

Приклад : Потік позицій не гарантує оцінки для всіх зупинок.

Поглибити у гіді : [GTFS, GTFS-RT та GBFS: які відмінності?](https://www.roote.ai/uk/guides/gtfs-gtfs-rt-ta-gbfs-yaki-vidminy/)

## GBFS

Стандарт публічних даних спільної мобільності. За версією та потоками описує системи, станції, транспортні засоби та їх статуси.

Приклад : Інформація про станції та лічильники доступності подані окремо.

Поглибити у гіді : [GTFS, GTFS-RT та GBFS: які відмінності?](https://www.roote.ai/uk/guides/gtfs-gtfs-rt-ta-gbfs-yaki-vidminy/)

## Невідоме значення — null

Відсутність відомого значення у контракті, що використовує null. Не треба замінювати нулем, false чи ознакою відсутності.

Приклад : Лічильник велосипедів null не означає порожню станцію.

Поглибити у гіді : [Порожній результат чи помилка API: як розрізнити?](https://www.roote.ai/uk/guides/vidchynyj-rezultat-chy-pomylka-api-yak-rozyznyty/)

## API

Інтерфейс, що дозволяє програмі використовувати можливості іншого сервісу через визначений контракт. Визначає вхідні дані та очікувані відповіді.

Приклад : Додаток шукає зупинки через API ROOTE.

Поглибити у гіді : [API чи MCP: який обрати для інтеграції даних мобільності?](https://www.roote.ai/uk/guides/api-chi-mcp-vybir-integratsiyi-mobilnosti/)

## API REST

HTTP-інтерфейс, що використовує ресурси та веб-механізми. Контракт API визначає маршрути, методи та формати.

Приклад : Пошук надсилається до задокументованої GET-маршруту.

Поглибити у гіді : [Як шукати найближчі зупинки транспорту за допомогою API?](https://www.roote.ai/uk/guides/yak-znajty-zupynky-transportu-poblyzy-iz-api-roote/)

## Ендпоінт — маршрут API

Адреса та операція API для певної функції. Різні маршрути можуть повертати різні набори результатів.

Приклад : /v1/transit/nearby шукає місця транспорту.

Поглибити у гіді : [Як шукати найближчі зупинки транспорту за допомогою API?](https://www.roote.ai/uk/guides/yak-znajty-zupynky-transportu-poblyzy-iz-api-roote/)

## Параметр запиту

Значення після знака питання в URL. Ім’я та формат встановлені інтерфейсом.

Приклад : modes=bus,tram вибирає режими в сумісному URL.

Поглибити у гіді : [Як інтегрувати карту мобільності у свій сайт?](https://www.roote.ai/uk/guides/yak-integruvaty-kartu-mobilnosti-u-svij-sajt/)

## HTTP статус

Код, що показує результат запиту на HTTP рівні. Потрібна додаткова перевірка вмісту й бізнес-статусу.

Приклад : HTTP 200 може мати бізнес-статус error.

Поглибити у гіді : [Порожній результат чи помилка API: як розрізнити?](https://www.roote.ai/uk/guides/vidchynyj-rezultat-chy-pomylka-api-yak-rozyznyty/)

## Порожній результат — empty

Пошук без жодної знайденої сутності у межах пошуку. Не означає фізичної відсутності сервісів поза даними.

Приклад : Жодна зупинка не знайдена з заданими фільтрами.

Поглибити у гіді : [Порожній результат чи помилка API: як розрізнити?](https://www.roote.ai/uk/guides/vidchynyj-rezultat-chy-pomylka-api-yak-rozyznyty/)

## Частковий результат — partial

Результат містить частково доступні дані з обмеженнями або відсутніми елементами, про що повідомляється. Має супроводжуватись попередженнями.

Приклад : Джерело відповідає при недоступності іншого.

Поглибити у гіді : [Порожній результат чи помилка API: як розрізнити?](https://www.roote.ai/uk/guides/vidchynyj-rezultat-chy-pomylka-api-yak-rozyznyty/)

## Таймаут — timeout

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

Приклад : Додаток пропонує спробувати знову замість показу пустого списку.

Поглибити у гіді : [Порожній результат чи помилка API: як розрізнити?](https://www.roote.ai/uk/guides/vidchynyj-rezultat-chy-pomylka-api-yak-rozyznyty/)

## Обмеження частоти — rate limit

Ліміти на кількість запитів до сервісу. Правила поновлення залежать від активного контракту.

Приклад : Код 429 вказує на дотримання рекомендацій поновлення.

Поглибити у гіді : [Порожній результат чи помилка API: як розрізнити?](https://www.roote.ai/uk/guides/vidchynyj-rezultat-chy-pomylka-api-yak-rozyznyty/)

## Токен Bearer

Ідентифікатор доступу в заголовку Authorization за встановленим механізмом. Має зберігатись у безпечній конфігурації.

Приклад : Authorization: Bearer використовується без публікації токена в URL.

Поглибити у гіді : [Як підключити ІІ асистента до MCP ROOTE?](https://www.roote.ai/uk/guides/yak-pidklyuchyty-asystenta-shchuk-i-shch-to-rozibratysia-u-mcp-roote/)

## JSON

Структурований текстовий формат з об’єктами, масивами, рядками та числами. Валідний синтаксично JSON може не відповідати схемі API.

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

Поглибити у гіді : [Як шукати найближчі зупинки транспорту за допомогою API?](https://www.roote.ai/uk/guides/yak-znajty-zupynky-transportu-poblyzy-iz-api-roote/)

## OpenAPI

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

Приклад : Контракт ROOTE опубліковано у openapi.json.

Поглибити у гіді : [Як шукати найближчі зупинки транспорту за допомогою API?](https://www.roote.ai/uk/guides/yak-znajty-zupynky-transportu-poblyzy-iz-api-roote/)

## Embed — інтегрована карта

Вставка зовнішнього досвіду на сторінку, наприклад карта в iframe. Параметри та дозволи визначають контекст використання.

Приклад : Iframe ROOTE показує велосипеди навколо Бордо.

Поглибити у гіді : [Як інтегрувати карту мобільності у свій сайт?](https://www.roote.ai/uk/guides/yak-integruvaty-kartu-mobilnosti-u-svij-sajt/)

## Iframe

HTML-елемент для завантаження документу на сторінку. На інших доменах батьківська сторінка не має вільного доступу до внутрішнього стану.

Приклад : Зміни пошуку вимагають документованої взаємодії з батьком.

Поглибити у гіді : [Як інтегрувати карту мобільності у свій сайт?](https://www.roote.ai/uk/guides/yak-integruvaty-kartu-mobilnosti-u-svij-sajt/)

## MCP — Model Context Protocol

Протокол для зв’язку додатка ШІ з серверами, що надають інструменти або контекст. Сам по собі не визначає якість даних.

Приклад : Асистент знаходить інструменти пошуку ROOTE.

Поглибити у гіді : [Що таке сервер MCP і для чого він потрібен?](https://www.roote.ai/uk/guides/chto-take-server-mcp-i-dlya-chogo-vin-potriben/)

## Сервер MCP

Програма, що надає можливості за протоколом MCP. Реальні інструменти сервера визначають доступний клієнту функціонал.

Приклад : tools/list показує доступний інвентар.

Поглибити у гіді : [Що таке сервер MCP і для чого він потрібен?](https://www.roote.ai/uk/guides/chto-take-server-mcp-i-dlya-chogo-vin-potriben/)

## Клієнт MCP

Компонент додатка ШІ для спілкування з сервером MCP. Керує протоколом для цього з’єднання.

Приклад : Клієнт передає аргументи пошуку ROOTE.

Поглибити у гіді : [Що таке сервер MCP і для чого він потрібен?](https://www.roote.ai/uk/guides/chto-take-server-mcp-i-dlya-chogo-vin-potriben/)

## Хост-додаток MCP

Додаток, що веде взаємодію з користувачем та керує одним або більше клієнтами MCP. Відповідає за використання результатів у своїй експертизі.

Приклад : Ваш чат-додаток підключається до сервера ROOTE.

Поглибити у гіді : [Що таке сервер MCP і для чого він потрібен?](https://www.roote.ai/uk/guides/chto-take-server-mcp-i-dlya-chogo-vin-potriben/)

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

Вузол, описаний ім’ям, функцією та схемою аргументів. Асистент має використовувати схему для вводу.

Приклад : geocode приймає адресу; transit_nearby — координати.

Поглибити у гіді : [Як підключити ІІ асистента до MCP ROOTE?](https://www.roote.ai/uk/guides/yak-pidklyuchyty-asystenta-shchuk-i-shch-to-rozibratysia-u-mcp-roote/)

## Streamable HTTP

Транспорт MCP для спілкування з далеким сервером по HTTP. Підтримка має бути перевірена у клієнті.

Приклад : Дистанційний сервер ROOTE використовує https://mcp.roote.ai/mcp.

Поглибити у гіді : [Як підключити ІІ асистента до MCP ROOTE?](https://www.roote.ai/uk/guides/yak-pidklyuchyty-asystenta-shchuk-i-shch-to-rozibratysia-u-mcp-roote/)

## Відповідь на основі даних — grounding

Формування відповіді з фактично отриманої або наданої інформації. Відсутні поля та застереження мають бути помітні.

Приклад : Асистент повторює повернуті локації без вигадок про часи.

Поглибити у гіді : [Як створити асистента, який знаходить мобільність навколо адреси?](https://www.roote.ai/uk/guides/yak-stvoriti-asistenta-yakij-znajde-mobilnist-navkolo-adresi/)

## Галюцинація асистента ШІ

Створення інформації без підтверджень, поданої як відома. У мобільності — це вигадані часи або доступність.

Приклад : Асистент анонсує прохід, хоча інструмент надав тільки зупинку.

Поглибити у гіді : [Як створити асистента, який знаходить мобільність навколо адреси?](https://www.roote.ai/uk/guides/yak-stvoriti-asistenta-yakij-znajde-mobilnist-navkolo-adresi/)

## Ін’єкція підказок

Спроба змінити інструкції асистента через зовнішній контент. Опис постачальників повинен залишатись даними, не командами.

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

Поглибити у гіді : [Як створити асистента, який знаходить мобільність навколо адреси?](https://www.roote.ai/uk/guides/yak-stvoriti-asistenta-yakij-znajde-mobilnist-navkolo-adresi/)

## Тільки для читання

Можливість перегляду без дій з модифікації за допомогою інструмента. Перегляд доступності не резервує, не розблокує і не орендує транспорт.

Приклад : Інструменти Data ROOTE призначені для ознайомлення з інформацією.

Поглибити у гіді : [Що таке сервер MCP і для чого він потрібен?](https://www.roote.ai/uk/guides/chto-take-server-mcp-i-dlya-chogo-vin-potriben/)