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

Простые определения для понимания транспорта, местных сервисов и инструментов, связывающих их с вашими приложениями.

Source: https://www.roote.ai/ru/slovar-mobilnosti/
Language: ru
Author: ROOTE

## Велосипед в общем доступе

Сервис, позволяющий взять велосипед на временное использование согласно условиям оператора. Может работать со станциями или без них.

Пример : Вы находите велосипед и используете соответствующую услугу аренды.

Подробнее в руководстве : [Как найти велосипед в сервисе свободного доступа рядом с вами?](https://www.roote.ai/ru/guides/kak-najti-velosiped-v-svobodnom-dostupe-po-blizosti/)

## Совместная мобильность

Набор сервисов, предоставляющих доступ к транспортным средствам, которые последовательно используют разные люди, а не принадлежат одному владельцу.

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

Подробнее в руководстве : [Как найти велосипед в сервисе свободного доступа рядом с вами?](https://www.roote.ai/ru/guides/kak-najti-velosiped-v-svobodnom-dostupe-po-blizosti/)

## Стоянка для крепления

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

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

Подробнее в руководстве : [Пустая или заполненная велостанция: что делать?](https://www.roote.ai/ru/guides/pustaya-ili-zapolnennaya-velostantsiya-chto-delat-roote/)

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

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

Пример : Станция может отображаться на карте и быть временно пустой.

Подробнее в руководстве : [Пустая или заполненная велостанция: что делать?](https://www.roote.ai/ru/guides/pustaya-ili-zapolnennaya-velostantsiya-chto-delat-roote/)

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

Концепция, при которой транспорт не обязательно берётся и возвращается к фиксированной станции. Зоны и правила парковки остаются согласно сервису.

Пример : Электросамокат должен быть возвращён в разрешённую зону.

Подробнее в руководстве : [Велосипеды на станциях и без станций: в чем разница?](https://www.roote.ai/ru/guides/velos-v-stantsii-ili-bez-stantsii-kakie-razlichiya/)

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

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

Пример : Три велосипеда на станции не означают три забронированных велосипеда.

Подробнее в руководстве : [Доступность велосипедов в реальном времени: как отобразить в приложении?](https://www.roote.ai/ru/guides/dostupnost-velosipedov-v-realnom-vremeni-kak-otobrazhat-v-prilozhenii/)

## Взятие транспортного средства

Начало использования транспортного средства. Положительный счётчик не гарантирует, что сервис разрешает взять велосипед.

Пример : Велосипеды есть, но станция может запрещать аренду.

Подробнее в руководстве : [Доступность велосипедов в реальном времени: как отобразить в приложении?](https://www.roote.ai/ru/guides/dostupnost-velosipedov-v-realnom-vremeni-kak-otobrazhat-v-prilozhenii/)

## Возврат

Завершение использования транспортного средства по правилам сервиса. Возможности вернуть могут отличаться от возможностей взять.

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

Подробнее в руководстве : [Пустая или заполненная велостанция: что делать?](https://www.roote.ai/ru/guides/pustaya-ili-zapolnennaya-velostantsiya-chto-delat-roote/)

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

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

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

Подробнее в руководстве : [Доступность велосипедов в реальном времени: как отобразить в приложении?](https://www.roote.ai/ru/guides/dostupnost-velosipedov-v-realnom-vremeni-kak-otobrazhat-v-prilozhenii/)

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

Последовательное использование разных видов транспорта в одной поездке. Каждый этап сохраняет расписание, доступ и условия.

Пример : Вы едете на велосипеде до трамвая, затем идёте пешком.

Подробнее в руководстве : [Как совмещать велосипед и общественный транспорт ежедневно?](https://www.roote.ai/ru/guides/kak-sovmestit-velosiped-i-obshhestvennyj-transport-v-povsednevnoj-zhizni/)

## Остановка транспорта

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

Пример : Остановка автобуса возвращается без расписания отправлений.

Подробнее в руководстве : [Как найти ближайшую остановку автобуса или трамвая?](https://www.roote.ai/ru/guides/kak-nayti-blizhayshuyu-ostanovku-avtobusa-ili-tramvaya/)

## Платформа

Место или точка посадки в транспортном узле. Разные платформы рядом обслуживают разные направления или маршруты.

Пример : Два направления маршрута могут использовать разные платформы.

Подробнее в руководстве : [Как найти правильную остановку автобуса и нужное направление?](https://www.roote.ai/ru/guides/kak-najti-pravilnuyu-ostanovku-avtobusa-i-nuzhnoye-napravlenie/)

## Линия

Транспортный сервис с идентификатором в сети, с одним или несколькими маршрутами или вариантами. Названия линии не всегда определяет направление.

Пример : Одна линия может иметь несколько конечных остановок.

Подробнее в руководстве : [Как найти правильную остановку автобуса и нужное направление?](https://www.roote.ai/ru/guides/kak-najti-pravilnuyu-ostanovku-avtobusa-i-nuzhnoye-napravlenie/)

## Поездка

Выполнение транспортного сервиса с маршрутом и остановками. В GTFS поездка связана с линией и календарём обслуживания.

Пример : Два последовательных отправления одной линии — две поездки.

Подробнее в руководстве : [GTFS, GTFS-RT и GBFS: в чем различия?](https://www.roote.ai/ru/guides/gtfs-gtfs-rt-i-gbfs-v-chem-raznica/)

## Направление

Указание направления или пункта назначения сервиса. Должно проверяться с маршрутом и местом посадки.

Пример : Ищете трамвай в нужном направлении, а не обратно.

Подробнее в руководстве : [Как найти правильную остановку автобуса и нужное направление?](https://www.roote.ai/ru/guides/kak-najti-pravilnuyu-ostanovku-avtobusa-i-nuzhnoye-napravlenie/)

## Конечная остановка

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

Пример : Сокращённый маршрут заканчивается до обычного терминала.

Подробнее в руководстве : [Как найти правильную остановку автобуса и нужное направление?](https://www.roote.ai/ru/guides/kak-najti-pravilnuyu-ostanovku-avtobusa-i-nuzhnoye-napravlenie/)

## Пересадка

Переход с одного сервиса или вида транспорта на другой во время поездки. Близость двух остановок не гарантирует удобную пересадку.

Пример : Нужно учесть переходы между платформами и ожидания.

Подробнее в руководстве : [Как читать план автобуса, трамвая или метро?](https://www.roote.ai/ru/guides/kak-chitat-plan-avtobusa-trama-ili-metro/)

## Теоретическое время

Плановое время в расписании для данной даты и прохода. Не обязательно отражает текущее положение транспортного средства.

Пример : Отправление запланировано на 8:10 по расписанию.

Подробнее в руководстве : [Расписание автобусов: в чем разница между теоретическим расписанием и расписанием в реальном времени?](https://www.roote.ai/ru/guides/raspisanie-avtobusov-kakaya-raznica-mezhdu-teoreticheskim-i-realnym-vremenem/)

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

Прогноз будущего прохода, вычисленный исходя из доступных данных. Может обновляться с приходом новой информации.

Пример : Проход, запланированный на 8:10, теперь оценивается в 8:14.

Подробнее в руководстве : [Расписание автобусов: в чем разница между теоретическим расписанием и расписанием в реальном времени?](https://www.roote.ai/ru/guides/raspisanie-avtobusov-kakaya-raznica-mezhdu-teoreticheskim-i-realnym-vremenem/)

## Следующее отправление

Ближайшее ожидаемое отправление для места и сервиса. Поиск остановки не равнозначен поиску её ближайших отправлений.

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

Подробнее в руководстве : [Как искать транспортные остановки рядом с помощью API?](https://www.roote.ai/ru/guides/kak-najti-ostanovki-transporta-ryadom-s-pomoshhyu-api/)

## Нарушение движения

Событие, влияющее на транспортный сервис, как прерывание или изменение маршрута. Эффекты смотрите в указанном периоде и зоне.

Пример : Тревога может касаться линии только в определённые часы.

Подробнее в руководстве : [Как создать помощника, который находит варианты мобильности вокруг адреса?](https://www.roote.ai/ru/guides/kak-sozdat-pomoshhnika-dlya-poiska-mobilnosti-vokrug-adresa/)

## Календарь обслуживания

Информация о днях работы транспортного сервиса с возможными исключениями. Расписания нужно интерпретировать вместе с календарём.

Пример : Проход по будням может не быть в воскресенье.

Подробнее в руководстве : [GTFS, GTFS-RT и GBFS: в чем различия?](https://www.roote.ai/ru/guides/gtfs-gtfs-rt-i-gbfs-v-chem-raznica/)

## Городской сервис

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

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

Подробнее в руководстве : [Как искать транспортные остановки рядом с помощью API?](https://www.roote.ai/ru/guides/kak-najti-ostanovki-transporta-ryadom-s-pomoshhyu-api/)

## Общественные туалеты

Туалеты для публичного пользования по условиям места. Присутствие в данных не гарантирует бесплатность, открытость или доступность сейчас.

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

Подробнее в руководстве : [Как найти бесплатные общественные туалеты рядом с собой?](https://www.roote.ai/ru/guides/kak-najti-besplatnye-obshhestvennye-tualety-vokrug-sebya/)

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

Характеристики, позволяющие использовать место или сервис согласно нуждам человека. Неизвестное значение не означает доступность или её отсутствие.

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

Подробнее в руководстве : [Общественные туалеты с доступом: что проверить перед поездкой?](https://www.roote.ai/ru/guides/obshhestvennye-tualety-dostupnye-proverka-pered-poezdkoj/)

## Человек с ограниченной подвижностью — ОПП

Лицо с трудностями передвижения, временными или постоянными. Метка ОПП не описывает все необходимые доступы или оборудование.

Пример : Наличие пандуса не исключает других препятствий.

Подробнее в руководстве : [Общественные туалеты с доступом: что проверить перед поездкой?](https://www.roote.ai/ru/guides/obshhestvennye-tualety-dostupnye-proverka-pered-poezdkoj/)

## Часы работы

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

Пример : Временное закрытие может не отразиться в обычном графике.

Подробнее в руководстве : [Как найти бесплатные общественные туалеты рядом с собой?](https://www.roote.ai/ru/guides/kak-najti-besplatnye-obshhestvennye-tualety-vokrug-sebya/)

## Питьевая вода

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

Пример : Тип оборудования и атрибуты необходимо различать.

Подробнее в руководстве : [Как искать транспортные остановки рядом с помощью API?](https://www.roote.ai/ru/guides/kak-najti-ostanovki-transporta-ryadom-s-pomoshhyu-api/)

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

Устройство для зарядки совместимых транспортных средств. Локализация не гарантирует наличие свободного места или совместимость разъёма.

Пример : Место зарядки и состояние использования — разные данные.

Подробнее в руководстве : [Как искать транспортные остановки рядом с помощью API?](https://www.roote.ai/ru/guides/kak-najti-ostanovki-transporta-ryadom-s-pomoshhyu-api/)

## Тип сервиса

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

Пример : API Services ROOTE использует types=toilets для туалетов.

Подробнее в руководстве : [Как искать транспортные остановки рядом с помощью API?](https://www.roote.ai/ru/guides/kak-najti-ostanovki-transporta-ryadom-s-pomoshhyu-api/)

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

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

Пример : Кнопка локации запрашивает разрешение браузера.

Подробнее в руководстве : [Как интегрировать карту мобильности на свой сайт?](https://www.roote.ai/ru/guides/kak-vstavit-kartu-mobilnosti-na-sayt/)

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

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

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

Подробнее в руководстве : [Как искать транспортные остановки рядом с помощью API?](https://www.roote.ai/ru/guides/kak-najti-ostanovki-transporta-ryadom-s-pomoshhyu-api/)

## Широта

Координата, выражающая север или юг от экватора, в градусах по стандартам ROOTE. Допустимо от −90 до 90.

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

Подробнее в руководстве : [Как искать транспортные остановки рядом с помощью API?](https://www.roote.ai/ru/guides/kak-najti-ostanovki-transporta-ryadom-s-pomoshhyu-api/)

## Долгота

Координата, выражающая восток или запад относительно меридиана. В примерах ROOTE градусы от −180 до 180.

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

Подробнее в руководстве : [Как искать транспортные остановки рядом с помощью API?](https://www.roote.ai/ru/guides/kak-najti-ostanovki-transporta-ryadom-s-pomoshhyu-api/)

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

Поиск, преобразующий адрес или географическое выражение в кандидаты с координатами. Несколько мест могут совпадать по запросу.

Пример : Два города могут иметь улицу с одинаковым названием.

Подробнее в руководстве : [Как создать помощника, который находит варианты мобильности вокруг адреса?](https://www.roote.ai/ru/guides/kak-sozdat-pomoshhnika-dlya-poiska-mobilnosti-vokrug-adresa/)

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

Поиск мест или названий по координатам. Результат может показывать близлежащий объект, а не точный адрес.

Пример : GPS-точка связана с читаемым названием.

Подробнее в руководстве : [Что такое сервер MCP и для чего он нужен?](https://www.roote.ai/ru/guides/chto-takoe-server-mcp-i-dlya-chego-on-nuzhen/)

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

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

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

Подробнее в руководстве : [Как создать помощника, который находит варианты мобильности вокруг адреса?](https://www.roote.ai/ru/guides/kak-sozdat-pomoshhnika-dlya-poiska-mobilnosti-vokrug-adresa/)

## Точка поиска

Точка, от которой ведётся поиск поблизости и рассчитываются расстояния. Может отличаться от центра карты.

Пример : Камера карты двигается, а поиск остаётся сосредоточенным на Бордо.

Подробнее в руководстве : [Как интегрировать карту мобильности на свой сайт?](https://www.roote.ai/ru/guides/kak-vstavit-kartu-mobilnosti-na-sayt/)

## Радиус поиска

Расстояние вокруг исходной точки для ограничения области поиска. Единицы и границы зависят от контракта API или инструмента.

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

Подробнее в руководстве : [Как искать транспортные остановки рядом с помощью API?](https://www.roote.ai/ru/guides/kak-najti-ostanovki-transporta-ryadom-s-pomoshhyu-api/)

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

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

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

Подробнее в руководстве : [Как искать транспортные остановки рядом с помощью API?](https://www.roote.ai/ru/guides/kak-najti-ostanovki-transporta-ryadom-s-pomoshhyu-api/)

## Масштаб карты

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

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

Подробнее в руководстве : [Как интегрировать карту мобильности на свой сайт?](https://www.roote.ai/ru/guides/kak-vstavit-kartu-mobilnosti-na-sayt/)

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

Обновлённая информация для отображения текущей ситуации или поддержки оценок. Свежесть нужно оценивать; реальное время не значит мгновенное или гарантированное.

Пример : Оценка прохождения обновлена на основе свежих данных.

Подробнее в руководстве : [Расписание автобусов: в чем разница между теоретическим расписанием и расписанием в реальном времени?](https://www.roote.ai/ru/guides/raspisanie-avtobusov-kakaya-raznica-mezhdu-teoreticheskim-i-realnym-vremenem/)

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

Зафиксированное состояние или событие в определённое время. Отличается от запланированного или оценённого события.

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

Подробнее в руководстве : [Расписание автобусов: в чем разница между теоретическим расписанием и расписанием в реальном времени?](https://www.roote.ai/ru/guides/raspisanie-avtobusov-kakaya-raznica-mezhdu-teoreticheskim-i-realnym-vremenem/)

## Свежесть данных

Характеристика актуальности информации по датам и правилам контракта. Время запроса не доказывает свежесть источника.

Пример : Счётчик сейчас может отражать старое наблюдение.

Подробнее в руководстве : [Доступность велосипедов в реальном времени: как отобразить в приложении?](https://www.roote.ai/ru/guides/dostupnost-velosipedov-v-realnom-vremeni-kak-otobrazhat-v-prilozhenii/)

## Метка времени

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

Пример : source_updated_at и received_at описывают разные этапы.

Подробнее в руководстве : [Доступность велосипедов в реальном времени: как отобразить в приложении?](https://www.roote.ai/ru/guides/dostupnost-velosipedov-v-realnom-vremeni-kak-otobrazhat-v-prilozhenii/)

## Устаревшие данные — stale

Информация считается слишком старой по контракту или политике валидности. Может храниться как недавняя история, не представляясь свежей.

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

Подробнее в руководстве : [Доступность велосипедов в реальном времени: как отобразить в приложении?](https://www.roote.ai/ru/guides/dostupnost-velosipedov-v-realnom-vremeni-kak-otobrazhat-v-prilozhenii/)

## Время жизни — TTL

Период, управляемый для валидности или обновления данных в кеше по контракту. Не гарантирует время исходного наблюдения отдельно.

Пример : Истёкший кэш должен соответствовать политике обновления.

Подробнее в руководстве : [Доступность велосипедов в реальном времени: как отобразить в приложении?](https://www.roote.ai/ru/guides/dostupnost-velosipedov-v-realnom-vremeni-kak-otobrazhat-v-prilozhenii/)

## Кэш

Временное хранение результатов для предотвращения повторных одинаковых запросов. Значение сохраняет источник и временной контекст.

Пример : Два одинаковых запроса могут использовать один действительный ответ.

Подробнее в руководстве : [Доступность велосипедов в реальном времени: как отобразить в приложении?](https://www.roote.ai/ru/guides/dostupnost-velosipedov-v-realnom-vremeni-kak-otobrazhat-v-prilozhenii/)

## Покрытие

Область и полнота информации для поиска или источника. Частичное покрытие ограничивает выводы.

Пример : Список может быть полезен, не показывая всех существующих сервисов.

Подробнее в руководстве : [Нет результатов или ошибка API: как отличить?](https://www.roote.ai/ru/guides/net-resultat-ou-erreur-api-comment-faire-la-difference/)

## Происхождение

Данные, позволяющие определить источник и способ получения информации. Помогает понять её применение.

Пример : Результат сохраняет источник и контекст сбора.

Подробнее в руководстве : [Как создать помощника, который находит варианты мобильности вокруг адреса?](https://www.roote.ai/ru/guides/kak-sozdat-pomoshhnika-dlya-poiska-mobilnosti-vokrug-adresa/)

## Атрибуция

Указание поставщика или источника данных. При необходимости интерфейс, использующий данные, должен показывать это.

Пример : Требуемая атрибуция (required=true) сохраняется в интерфейсе.

Подробнее в руководстве : [Как искать транспортные остановки рядом с помощью API?](https://www.roote.ai/ru/guides/kak-najti-ostanovki-transporta-ryadom-s-pomoshhyu-api/)

## GTFS Schedule

Стандартный формат описания запланированного транспортного предложения: остановки, линии, поездки, календари и проходы. Не обеспечивает автоматических обновлений в реальном времени.

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

Подробнее в руководстве : [GTFS, GTFS-RT и GBFS: в чем различия?](https://www.roote.ai/ru/guides/gtfs-gtfs-rt-i-gbfs-v-chem-raznica/)

## GTFS Realtime — GTFS-RT

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

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

Подробнее в руководстве : [GTFS, GTFS-RT и GBFS: в чем различия?](https://www.roote.ai/ru/guides/gtfs-gtfs-rt-i-gbfs-v-chem-raznica/)

## GBFS

Стандарт открытых данных совместной мобильности. По версии и потокам описывает системы, станции, транспортные средства и их статус.

Пример : Информация о станциях и показатели доступности разделены.

Подробнее в руководстве : [GTFS, GTFS-RT и GBFS: в чем различия?](https://www.roote.ai/ru/guides/gtfs-gtfs-rt-i-gbfs-v-chem-raznica/)

## Неизвестное значение — null

Отсутствие известного значения в контракте, использующем null. Не должно заменяться нулём, false или доказательством отсутствия.

Пример : Счётчик велосипедов null не означает пустую станцию.

Подробнее в руководстве : [Нет результатов или ошибка API: как отличить?](https://www.roote.ai/ru/guides/net-resultat-ou-erreur-api-comment-faire-la-difference/)

## API

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

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

Подробнее в руководстве : [API или MCP: какой выбрать для интеграции данных по мобильности?](https://www.roote.ai/ru/guides/api-ili-mcp-kak-vybrat-dlya-integrazii-dannyh-po-mobilnosti/)

## API REST

HTTP-интерфейс с использованием ресурсов и веб-механизмов. Контракт описывает маршруты, методы и представления.

Пример : Запрос поиска отправляется на документированный маршрут GET.

Подробнее в руководстве : [Как искать транспортные остановки рядом с помощью API?](https://www.roote.ai/ru/guides/kak-najti-ostanovki-transporta-ryadom-s-pomoshhyu-api/)

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

Адрес и операция для определённой возможности API. Разные маршруты возвращают разные виды результатов.

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

Подробнее в руководстве : [Как искать транспортные остановки рядом с помощью API?](https://www.roote.ai/ru/guides/kak-najti-ostanovki-transporta-ryadom-s-pomoshhyu-api/)

## Параметр запроса

Значение в URL после знака вопроса. Имя и формат определены используемым интерфейсом.

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

Подробнее в руководстве : [Как интегрировать карту мобильности на свой сайт?](https://www.roote.ai/ru/guides/kak-vstavit-kartu-mobilnosti-na-sayt/)

## HTTP-статус

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

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

Подробнее в руководстве : [Нет результатов или ошибка API: как отличить?](https://www.roote.ai/ru/guides/net-resultat-ou-erreur-api-comment-faire-la-difference/)

## Пустой результат — empty

Поиск без возвращённых объектов в выбранной области. Не доказывает отсутствия сервисов вне доступных данных.

Пример : По остановкам с выбранными фильтрами результатов нет.

Подробнее в руководстве : [Нет результатов или ошибка API: как отличить?](https://www.roote.ai/ru/guides/net-resultat-ou-erreur-api-comment-faire-la-difference/)

## Частичный результат — partial

Результат с полезной информацией, но с ограничениями или отсутствующими элементами, отмеченными предупреждениями.

Пример : Один источник отвечает, другой недоступен.

Подробнее в руководстве : [Нет результатов или ошибка API: как отличить?](https://www.roote.ai/ru/guides/net-resultat-ou-erreur-api-comment-faire-la-difference/)

## Таймаут — timeout

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

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

Подробнее в руководстве : [Нет результатов или ошибка API: как отличить?](https://www.roote.ai/ru/guides/net-resultat-ou-erreur-api-comment-faire-la-difference/)

## Ограничение частоты — rate limit

Лимит запросов, разрешённых сервисом за время. Правила возобновления зависят от активного контракта.

Пример : Код 429 требует соблюдать интервал повторных попыток.

Подробнее в руководстве : [Нет результатов или ошибка API: как отличить?](https://www.roote.ai/ru/guides/net-resultat-ou-erreur-api-comment-faire-la-difference/)

## Токен Bearer

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

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

Подробнее в руководстве : [Как подключить ИИ-ассистента к MCP ROOTE?](https://www.roote.ai/ru/guides/kak-podklyuchit-ia-assistenta-k-mcp-roote/)

## JSON

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

Пример : Сборка станций должна содержать ожидаемые типы и поля.

Подробнее в руководстве : [Как искать транспортные остановки рядом с помощью API?](https://www.roote.ai/ru/guides/kak-najti-ostanovki-transporta-ryadom-s-pomoshhyu-api/)

## OpenAPI

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

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

Подробнее в руководстве : [Как искать транспортные остановки рядом с помощью API?](https://www.roote.ai/ru/guides/kak-najti-ostanovki-transporta-ryadom-s-pomoshhyu-api/)

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

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

Пример : Iframe ROOTE показывает велосипеды вокруг Бордо.

Подробнее в руководстве : [Как интегрировать карту мобильности на свой сайт?](https://www.roote.ai/ru/guides/kak-vstavit-kartu-mobilnosti-na-sayt/)

## Iframe

HTML-элемент, загружающий документ на страницу. На разных доменах родитель не может свободно читать содержимое встроенного.

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

Подробнее в руководстве : [Как интегрировать карту мобильности на свой сайт?](https://www.roote.ai/ru/guides/kak-vstavit-kartu-mobilnosti-na-sayt/)

## MCP — Model Context Protocol

Протокол для общения ИИ-приложения с серверами, предоставляющими инструменты или контекст. Сам по себе не определяет качество возвращаемых данных.

Пример : Ассистент обнаруживает инструменты поиска ROOTE.

Подробнее в руководстве : [Что такое сервер MCP и для чего он нужен?](https://www.roote.ai/ru/guides/chto-takoe-server-mcp-i-dlya-chego-on-nuzhen/)

## Сервер MCP

Программа, предоставляющая возможности согласно протоколу MCP. Набор объявленных инструментов определяет доступные вызовы клиента.

Пример : tools/list показывает доступный инвентарь.

Подробнее в руководстве : [Что такое сервер MCP и для чего он нужен?](https://www.roote.ai/ru/guides/chto-takoe-server-mcp-i-dlya-chego-on-nuzhen/)

## Клиент MCP

Компонент ИИ-приложения, общающийся с MCP-сервером. Управляет протокольным обменом для этого соединения.

Пример : Клиент передаёт аргументы поиска ROOTE.

Подробнее в руководстве : [Что такое сервер MCP и для чего он нужен?](https://www.roote.ai/ru/guides/chto-takoe-server-mcp-i-dlya-chego-on-nuzhen/)

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

Приложение, предоставляющее взаимодействие с пользователем и управляющее клиентами MCP. Ответственно за использование результатов в своём опыте.

Пример : Ваш разговорный бот подключает ROOTE-сервер.

Подробнее в руководстве : [Что такое сервер MCP и для чего он нужен?](https://www.roote.ai/ru/guides/chto-takoe-server-mcp-i-dlya-chego-on-nuzhen/)

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

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

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

Подробнее в руководстве : [Как подключить ИИ-ассистента к MCP ROOTE?](https://www.roote.ai/ru/guides/kak-podklyuchit-ia-assistenta-k-mcp-roote/)

## Streamable HTTP

Транспорт MCP для общения с удалённым сервером по HTTP. Поддержка должна проверяться в используемом клиенте.

Пример : Удалённый сервер ROOTE — https://mcp.roote.ai/mcp.

Подробнее в руководстве : [Как подключить ИИ-ассистента к MCP ROOTE?](https://www.roote.ai/ru/guides/kak-podklyuchit-ia-assistenta-k-mcp-roote/)

## Основанный на данных ответ — grounding

Построение ответа из реально полученной или предоставленной информации. Отсутствующие поля и замечания остаются видимыми.

Пример : Ассистент использует возвращённые места, не фантазируя их расписание.

Подробнее в руководстве : [Как создать помощника, который находит варианты мобильности вокруг адреса?](https://www.roote.ai/ru/guides/kak-sozdat-pomoshhnika-dlya-poiska-mobilnosti-vokrug-adresa/)

## Галлюцинация ИИ-ассистента

Создание необоснованной информации, поданной как известная. В мобильности — выдуманные расписания или доступность.

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

Подробнее в руководстве : [Как создать помощника, который находит варианты мобильности вокруг адреса?](https://www.roote.ai/ru/guides/kak-sozdat-pomoshhnika-dlya-poiska-mobilnosti-vokrug-adresa/)

## Внедрение подсказки

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

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

Подробнее в руководстве : [Как создать помощника, который находит варианты мобильности вокруг адреса?](https://www.roote.ai/ru/guides/kak-sozdat-pomoshhnika-dlya-poiska-mobilnosti-vokrug-adresa/)

## Только чтение

Возможность просмотра без действий изменения со стороны инструмента. Просмотр доступности не резервирует и не арендует транспорт.

Пример : Инструменты данных ROOTE служат только для просмотра информации.

Подробнее в руководстве : [Что такое сервер MCP и для чего он нужен?](https://www.roote.ai/ru/guides/chto-takoe-server-mcp-i-dlya-chego-on-nuzhen/)