Глоссарий ROOTE

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

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

79 отображено определений

А

Данные и форматы

Атрибуция

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

Пример

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

Б

Велосипеды и совместная мобильность

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

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

Пример

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

В

Велосипеды и совместная мобильность

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

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

Пример

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

Велосипеды и совместная мобильность

Велостанция

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

Пример

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

Велосипеды и совместная мобильность

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

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

Пример

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

ИИ и MCP

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

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

Пример

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

Велосипеды и совместная мобильность

Возврат

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

Пример

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

Данные и форматы

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

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

Пример

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

Г

ИИ и MCP

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

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

Пример

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

Локализация и поиск

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

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

Пример

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

Локализация и поиск

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

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

Пример

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

Сервисы и доступность

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

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

Пример

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

Д

Данные и форматы

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

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

Пример

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

Локализация и поиск

Долгота

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

Пример

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

Велосипеды и совместная мобильность

Доступность

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

Пример

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

Сервисы и доступность

Доступность

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

Пример

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

З

Сервисы и доступность

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

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

Пример

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

И

Велосипеды и совместная мобильность

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

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

Пример

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

К

Общественный транспорт

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

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

Пример

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

Общественный транспорт

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

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

Пример

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

Данные и форматы

Кэш

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

Пример

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

Л

Общественный транспорт

Линия

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

Пример

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

М

Данные и форматы

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

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

Пример

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

Н

Данные и форматы

Наблюдение

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

Пример

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

Общественный транспорт

Направление

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

Пример

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

Общественный транспорт

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

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

Пример

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

Данные и форматы

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

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

Пример

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

О

Сервисы и доступность

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

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

Пример

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

ИИ и MCP

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

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

Пример

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

Общественный транспорт

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

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

Пример

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

Общественный транспорт

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

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

Пример

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

П

Общественный транспорт

Пересадка

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

Пример

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

Общественный транспорт

Платформа

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

Пример

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

Общественный транспорт

Поездка

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

Пример

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

Данные и форматы

Покрытие

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

Пример

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

Данные и форматы

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

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

Пример

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

API и интеграция

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

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

Пример

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

Р

Локализация и поиск

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

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

Пример

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

С

Данные и форматы

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

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

Пример

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

ИИ и MCP

Сервер MCP

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

Пример

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

Общественный транспорт

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

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

Пример

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

Велосипеды и совместная мобильность

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

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

Пример

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

Велосипеды и совместная мобильность

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

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

Пример

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

Т

API и интеграция

Таймаут — timeout

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

Пример

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

Общественный транспорт

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

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

Пример

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

API и интеграция

Токен Bearer

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

Пример

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

ИИ и MCP

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

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

Пример

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

Локализация и поиск

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

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

Пример

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

Локализация и поиск

Точка поиска

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

Пример

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

У

Данные и форматы

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

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

Пример

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

Х

ИИ и MCP

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

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

Пример

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

Ч

API и интеграция

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

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

Пример

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

Сервисы и доступность

Часы работы

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

Пример

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

Сервисы и доступность

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

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

Пример

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

Ш

Э

Велосипеды и совместная мобильность

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

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

Пример

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

A

API и интеграция

API REST

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

Пример

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

E

API и интеграция

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

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

Пример

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

G

Данные и форматы

GBFS

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

Пример

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

Локализация и поиск

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

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

Пример

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

Данные и форматы

GTFS Realtime — GTFS-RT

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

Пример

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

Данные и форматы

GTFS Schedule

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

Пример

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

H

I

API и интеграция

Iframe

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

Пример

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

J

API и интеграция

JSON

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

Пример

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

M

ИИ и MCP

MCP — Model Context Protocol

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

Пример

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

O

S

ИИ и MCP

Streamable HTTP

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

Пример

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

Ссылки для углубления

Термины ROOTE следуют документированным контрактам. Стандарты и протоколы имеют собственные официальные источники.

Вернуться в центр ресурсов