# El glosario de movilidad y datos. Definiciones sencillas para comprender transportes, servicios de proximidad y las herramientas que los conectan con tus aplicaciones. Source: https://www.roote.ai/es/glosario/ Language: es Author: ROOTE ## Bicicleta en libre servicio Servicio que permite tomar una bicicleta para uso temporal, según condiciones del operador. Puede funcionar con estaciones o vehículos sin estación. Ejemplo : Localizas una bicicleta y usas el servicio de alquiler correspondiente. Profundizar en la guía : [¿Cómo encontrar una bicicleta compartida cerca de ti?](https://www.roote.ai/es/guias/encontrar-bicicleta-compartida/) ## Movilidad compartida Conjunto de servicios que dan acceso a vehículos usados sucesivamente por varias personas, en lugar de un vehículo de propietario único. Ejemplo : Bicicletas y patinetes disponibles en alquiler en una ciudad. Profundizar en la guía : [¿Cómo encontrar una bicicleta compartida cerca de ti?](https://www.roote.ai/es/guias/encontrar-bicicleta-compartida/) ## Anclaje Equipo en una estación donde se puede atar una bicicleta. Su existencia no garantiza que acepte una devolución en ese momento. Ejemplo : Debe haber un lugar de devolución disponible y utilizable. Profundizar en la guía : [Estación de bicicletas vacía o llena : que hacer ?](https://www.roote.ai/es/guias/station-velo-vide-pleine/) ## Estación de bicicletas Lugar organizado para tomar o devolver bicicletas compartidas. Coordinadas, capacidades y disponibilidades describen diferentes aspectos de la estación. Ejemplo : Una estación puede estar en el mapa y momentáneamente vacía. Profundizar en la guía : [Estación de bicicletas vacía o llena : que hacer ?](https://www.roote.ai/es/guias/station-velo-vide-pleine/) ## Sin estación — free-floating Organización donde los vehículos no se toman ni entregan en un anclaje fijo. Las zonas y reglas de estacionamiento son las del servicio. Ejemplo : Un patinete debe devolverse en zona autorizada. Profundizar en la guía : [Bicicleta con estación o sin estación: ¿qué diferencias?](https://www.roote.ai/es/guias/velo-station-sans-station/) ## Disponibilidad Estado o cantidad de lo que puede ser utilizado según la información conocida. Una disponibilidad observada puede cambiar y no equivale a reserva. Ejemplo : Tres bicicletas observadas en una estación no son tres bicicletas reservadas. Profundizar en la guía : [Disponibilidad de bicicletas en tiempo real: ¿cómo mostrarla en una aplicación?](https://www.roote.ai/es/guias/disponibilidad-bicicletas-tiempo-real-como-mostrar-en-app/) ## Toma de vehículo Acción de comenzar a usar un vehículo. Un contador positivo no es suficiente si el servicio indica que la toma está desactivada. Ejemplo : Hay bicicletas, pero la estación puede no permitir su alquiler. Profundizar en la guía : [Disponibilidad de bicicletas en tiempo real: ¿cómo mostrarla en una aplicación?](https://www.roote.ai/es/guias/disponibilidad-bicicletas-tiempo-real-como-mostrar-en-app/) ## Devolución Fin del uso de un vehículo según reglas del servicio. Las opciones de devolución pueden diferir de las de toma. Ejemplo : Una estación permite salida pero no tiene espacio para devolución. Profundizar en la guía : [Estación de bicicletas vacía o llena : que hacer ?](https://www.roote.ai/es/guias/station-velo-vide-pleine/) ## Bicicleta con asistencia eléctrica Bicicleta que cuenta con un motor que asiste al pedaleo según sus características. En datos de movilidad, tipo de propulsión y batería pueden indicarse por separado. Ejemplo : Una estación puede distinguir bicicletas mecánicas de eléctricas. Profundizar en la guía : [Disponibilidad de bicicletas en tiempo real: ¿cómo mostrarla en una aplicación?](https://www.roote.ai/es/guias/disponibilidad-bicicletas-tiempo-real-como-mostrar-en-app/) ## Intermodalidad Uso sucesivo de varios modos de desplazamiento en un mismo trayecto. Cada etapa conserva horarios, accesos y condiciones. Ejemplo : Llegas en bici al tranvía y luego continúas caminando. Profundizar en la guía : [¿Cómo combinar la bicicleta y los transportes públicos a diario?](https://www.roote.ai/es/guias/velo-transports-commun/) ## Parada de transporte Lugar donde un servicio de transporte recoge o deja viajeros. Una parada abierta no informa automáticamente próximos pasos. Ejemplo : Una parada de autobús se devuelve sin horario de salida. Profundizar en la guía : [¿Cómo encontrar la parada de bus o tranvía más cercana?](https://www.roote.ai/es/guias/trouver-arret-bus-tram/) ## Andén Espacio o punto de embarque en un lugar de transporte. Varios andenes cercanos pueden servir a distintas direcciones o servicios. Ejemplo : Ambos sentidos de una línea pueden usar andenes distintos. Profundizar en la guía : [¿Cómo encontrar la parada de autobús y la dirección correctas?](https://www.roote.ai/es/guias/arret-bus-bonne-direction/) ## Línea Servicio de transporte identificado en una red, con uno o más recorridos o variantes. Solo el nombre no indica el sentido correcto. Ejemplo : La misma línea puede tener varios terminales. Profundizar en la guía : [¿Cómo encontrar la parada de autobús y la dirección correctas?](https://www.roote.ai/es/guias/arret-bus-bonne-direction/) ## Trayecto Ejecución de un servicio de transporte vinculada a recorrido y paradas. En GTFS, un trayecto está asociado a una línea y un calendario de servicio. Ejemplo : Dos salidas sucesivas de la misma línea son dos trayectos. Profundizar en la guía : [GTFS, GTFS-RT et GBFS : quelles différences ?](https://www.roote.ai/es/guias/gtfs-gtfs-rt-gbfs-differences/) ## Dirección Indicativo del sentido o destino de un servicio. Debe verificarse con recorrido y lugar de embarque. Ejemplo : Buscas el tranvía hacia tu destino, no en sentido contrario. Profundizar en la guía : [¿Cómo encontrar la parada de autobús y la dirección correctas?](https://www.roote.ai/es/guias/arret-bus-bonne-direction/) ## Terminal Extremo de un recorrido. Una línea puede tener variantes con terminales diferentes. Ejemplo : Un servicio corto termina antes del terminal usual. Profundizar en la guía : [¿Cómo encontrar la parada de autobús y la dirección correctas?](https://www.roote.ai/es/guias/arret-bus-bonne-direction/) ## Trasbordo Cambio de servicio o modo durante un trayecto. La cercanía de dos paradas no garantiza trasbordo realizable. Ejemplo : Se debe prever desplazamiento entre andenes y espera. Profundizar en la guía : [¿Cómo leer un plano de autobús, tranvía o metro?](https://www.roote.ai/es/guias/leer-plano-transporte/) ## Horario programado Hora prevista en el plan de servicio para fecha y paso dados. No describe necesariamente situación actual del vehículo. Ejemplo : Una salida está programada a las 8:10 según calendario. Profundizar en la guía : [Horarios de bus: ¿qué diferencia hay entre horarios teóricos y tiempo real?](https://www.roote.ai/es/guias/horarios-teoricos-tiempo-real/) ## Horario estimado Predicción de un paso futuro calculada con datos disponibles. Puede cambiar conforme llegan nuevos datos. Ejemplo : Paso previsto a las 8:10 ahora estimado a las 8:14. Profundizar en la guía : [Horarios de bus: ¿qué diferencia hay entre horarios teóricos y tiempo real?](https://www.roote.ai/es/guias/horarios-teoricos-tiempo-real/) ## Próxima salida Paso o salida próxima para un lugar y servicio. Encontrar una parada no equivale a buscar sus próximas salidas. Ejemplo : Listar paradas y listar salidas son dos resultados distintos. Profundizar en la guía : [Cómo buscar paradas de transporte cercanas con una API](https://www.roote.ai/es/guias/api-paradas-transporte-proximidad/) ## Incidencia Evento que afecta un servicio, como interrupción o cambio de ruta. Sus efectos deben leerse en tiempo y lugar indicados. Ejemplo : Una alerta puede afectar sólo una línea en ciertas horas. Profundizar en la guía : [¿Cómo crear un asistente que encuentre la movilidad alrededor de una dirección?](https://www.roote.ai/es/guias/como-crear-un-asistente-que-encuentre-movilidad-cerca-de-una-direccion/) ## Calendario de servicio Información de días con servicio previsto, con posibles excepciones. Horarios se interpretan con este calendario. Ejemplo : Un paso previsto en días laborables puede no existir en domingo. Profundizar en la guía : [GTFS, GTFS-RT et GBFS : quelles différences ?](https://www.roote.ai/es/guias/gtfs-gtfs-rt-gbfs-differences/) ## Servicio urbano Equipamiento o servicio útil cerca de un lugar, como baños, fuente o estación de recarga. Sus atributos pueden estar incompletos. Ejemplo : Resultado de proximidad describe un servicio y la información conocida. Profundizar en la guía : [Cómo buscar paradas de transporte cercanas con una API](https://www.roote.ai/es/guias/api-paradas-transporte-proximidad/) ## Baños públicos Baños para uso público bajo condiciones del lugar. Su presencia no garantiza gratuidad, apertura ni accesibilidad actual. Ejemplo : Verifica las condiciones antes de desplazarte. Profundizar en la guía : [¿Cómo encontrar toilettes publiques gratuitas cerca de mí?](https://www.roote.ai/es/guias/toilettes-publiques-gratuites-autour-de-moi/) ## Accesibilidad Características que permiten uso de un lugar o servicio según necesidades. Dato desconocido no significa ni accesible ni inaccesible. Ejemplo : Accesibilidad para silla de ruedas puede estar informada o desconocida. Profundizar en la guía : [Baños públicos accesibles: ¿qué comprobar antes de desplazarte?](https://www.roote.ai/es/guias/toilettes-publiques-accessibles/) ## Persona con movilidad reducida — PMR Persona con dificultades para desplazarse, permanentes o temporales. Mención PMR no detalla por sí sola accesos o equipamientos necesarios. Ejemplo : Presencia de rampa no describe todos los obstáculos posibles. Profundizar en la guía : [Baños públicos accesibles: ¿qué comprobar antes de desplazarte?](https://www.roote.ai/es/guias/toilettes-publiques-accessibles/) ## Horario de apertura Intervalos en que un lugar indica estar abierto. No confirman funcionamiento en tiempo real. Ejemplo : Un cierre temporal puede no reflejarse en horarios habituales. Profundizar en la guía : [¿Cómo encontrar toilettes publiques gratuitas cerca de mí?](https://www.roote.ai/es/guias/toilettes-publiques-gratuites-autour-de-moi/) ## Agua potable Agua indicada como apta para consumo humano. Una fuente no debe presentarse como potable sin información explícita. Ejemplo : Tipo de equipamiento y atributos deben distinguirse. Profundizar en la guía : [Cómo buscar paradas de transporte cercanas con una API](https://www.roote.ai/es/guias/api-paradas-transporte-proximidad/) ## Punto de carga Equipo para recargar vehículo compatible. Localizar punto no garantiza disponibilidad ni compatibilidad del conector. Ejemplo : Lugar de carga y estado de uso son info distinta. Profundizar en la guía : [Cómo buscar paradas de transporte cercanas con una API](https://www.roote.ai/es/guias/api-paradas-transporte-proximidad/) ## Tipo de servicio Categoría usada para seleccionar o describir un servicio urbano. Valores aceptados dependen de interfaz y esquema. Ejemplo : API Servicios ROOTE usa types=toilets para baños. Profundizar en la guía : [Cómo buscar paradas de transporte cercanas con una API](https://www.roote.ai/es/guias/api-paradas-transporte-proximidad/) ## Geolocalización Obtención de posición geográfica por dispositivo o app. Depende de permisos y precisión disponibles. Ejemplo : Botón de localización pide permiso al navegador. Profundizar en la guía : [¿Cómo integrar un mapa de movilidad en tu sitio?](https://www.roote.ai/es/guias/como-integrar-un-mapa-de-movilidad-en-tu-sitio/) ## Coordenadas GPS Valores que representan un punto geográfico, usualmente latitud y longitud. Su orden debe precisarse en la interfaz usada. Ejemplo : Búsqueda de proximidad usa dos coordenadas distintas. Profundizar en la guía : [Cómo buscar paradas de transporte cercanas con una API](https://www.roote.ai/es/guias/api-paradas-transporte-proximidad/) ## Latitud Coordenada que expresa posición norte o sur del ecuador en grados. Valores válidos entre -90 y 90. Ejemplo : Latitud del punto de búsqueda se pasa en lat. Profundizar en la guía : [Cómo buscar paradas de transporte cercanas con una API](https://www.roote.ai/es/guias/api-paradas-transporte-proximidad/) ## Longitud Coordenada que indica posición este-oeste respecto al meridiano de referencia, en grados entre -180 y 180. Ejemplo : Longitud puede pasarse en lon o en alias documentado lng. Profundizar en la guía : [Cómo buscar paradas de transporte cercanas con una API](https://www.roote.ai/es/guias/api-paradas-transporte-proximidad/) ## Geocodificación Búsqueda que convierte dirección o expresión geográfica en candidatos con coordenadas. Pueden corresponder varios sitios a la misma entrada. Ejemplo : Dos ciudades tienen calles con mismo nombre. Profundizar en la guía : [¿Cómo crear un asistente que encuentre la movilidad alrededor de una dirección?](https://www.roote.ai/es/guias/como-crear-un-asistente-que-encuentre-movilidad-cerca-de-una-direccion/) ## Geocodificación inversa Búsqueda de lugares o etiquetas a partir de coordenadas. Resultado puede representar lugar cercano, no dirección exacta garantizada. Ejemplo : Un punto GPS asociado a etiqueta legible. Profundizar en la guía : [¿Qué es un servidor MCP y para qué sirve?](https://www.roote.ai/es/guias/que-es-un-servidor-mcp-y-para-que-sirve/) ## Punto de interés — POI Lugar identificable útil para búsqueda, como establecimiento o equipamiento. Un POI se distingue de una dirección postal simple. Ejemplo : Nombre de hotel puede buscarse como establecimiento. Profundizar en la guía : [¿Cómo crear un asistente que encuentre la movilidad alrededor de una dirección?](https://www.roote.ai/es/guias/como-crear-un-asistente-que-encuentre-movilidad-cerca-de-una-direccion/) ## Origen de búsqueda Punto desde el cual se hace búsqueda de proximidad y se calculan distancias. Puede diferir del centro mostrado en mapa. Ejemplo : La cámara se mueve pero la búsqueda se centra en Burdeos. Profundizar en la guía : [¿Cómo integrar un mapa de movilidad en tu sitio?](https://www.roote.ai/es/guias/como-integrar-un-mapa-de-movilidad-en-tu-sitio/) ## Radio de búsqueda Distancia alrededor del origen usada para delimitar búsqueda. Unidad y límites dependen del contrato de ruta o herramienta. Ejemplo : radius=600 solicita radio de 600 metros en ejemplo REST. Profundizar en la guía : [Cómo buscar paradas de transporte cercanas con una API](https://www.roote.ai/es/guias/api-paradas-transporte-proximidad/) ## Distancia geográfica Distancia calculada entre posiciones según método del servicio. No es automáticamente distancia de ruta ni tiempo de caminata. Ejemplo : Lugar cercano puede requerir desvío para acceder. Profundizar en la guía : [Cómo buscar paradas de transporte cercanas con una API](https://www.roote.ai/es/guias/api-paradas-transporte-proximidad/) ## Zoom del mapa Nivel de ampliación de la vista cartográfica. Controla visualización, no sustituye radio de consulta API. Ejemplo : zoom=15 acerca la vista del mapa. Profundizar en la guía : [¿Cómo integrar un mapa de movilidad en tu sitio?](https://www.roote.ai/es/guias/como-integrar-un-mapa-de-movilidad-en-tu-sitio/) ## Datos en tiempo real Información actualizada que representa situación reciente o alimenta estimación. Su frescura debe evaluarse; tiempo real no es instantáneo ni garantizado. Ejemplo : Estimación de paso recalculada con datos recientes. Profundizar en la guía : [Horarios de bus: ¿qué diferencia hay entre horarios teóricos y tiempo real?](https://www.roote.ai/es/guias/horarios-teoricos-tiempo-real/) ## Observación Estado o evento constatado en momento identificado. Se distingue de evento previsto o estimado. Ejemplo : Pasaje efectivo de bus puede diferir de estimado anunciado. Profundizar en la guía : [Horarios de bus: ¿qué diferencia hay entre horarios teóricos y tiempo real?](https://www.roote.ai/es/guias/horarios-teoricos-tiempo-real/) ## Frescura de datos Calificación de novedad de información según fechas y reglas de contrato. Hora de consulta no prueba frescura de fuente. Ejemplo : Contador recibido ahora puede provenir de observación antigua. Profundizar en la guía : [Disponibilidad de bicicletas en tiempo real: ¿cómo mostrarla en una aplicación?](https://www.roote.ai/es/guias/disponibilidad-bicicletas-tiempo-real-como-mostrar-en-app/) ## Marca temporal Indicación temporal asociada a dato o evento. Su sentido depende del campo: observación, actualización, recepción o expiración. Ejemplo : source_updated_at y received_at describen etapas distintas. Profundizar en la guía : [Disponibilidad de bicicletas en tiempo real: ¿cómo mostrarla en una aplicación?](https://www.roote.ai/es/guias/disponibilidad-bicicletas-tiempo-real-como-mostrar-en-app/) ## Dato obsoleto — stale Información considerada demasiado antigua según contrato o política de validez. Puede conservarse como histórico reciente, sin presentarse como fresco. Ejemplo : Interfaz indica que disponibilidad debe actualizarse. Profundizar en la guía : [Disponibilidad de bicicletas en tiempo real: ¿cómo mostrarla en una aplicación?](https://www.roote.ai/es/guias/disponibilidad-bicicletas-tiempo-real-como-mostrar-en-app/) ## Tiempo de vida — TTL Duración para gestionar validez o renovación de dato cacheado según contrato. No prueba por sí sola hora de observación original. Ejemplo : Cache expirado debe seguir política de actualización prevista. Profundizar en la guía : [Disponibilidad de bicicletas en tiempo real: ¿cómo mostrarla en una aplicación?](https://www.roote.ai/es/guias/disponibilidad-bicicletas-tiempo-real-como-mostrar-en-app/) ## Cache Almacenamiento temporal de resultados para evitar búsquedas idénticas repetidas. Valor cacheado conserva origen y contexto temporal. Ejemplo : Dos solicitudes iguales pueden reutilizar respuesta válida. Profundizar en la guía : [Disponibilidad de bicicletas en tiempo real: ¿cómo mostrarla en una aplicación?](https://www.roote.ai/es/guias/disponibilidad-bicicletas-tiempo-real-como-mostrar-en-app/) ## Cobertura Ámbito y grado de completitud de información disponible para búsqueda o fuente. Cobertura parcial limita conclusiones posibles. Ejemplo : Lista puede ser útil sin representar todos servicios existentes. Profundizar en la guía : [¿Resultado vacío o error API: cómo diferenciarlos?](https://www.roote.ai/es/guias/resultado-vacio-o-error-api-como-diferenciar/) ## Proveniencia Información que ayuda a identificar origen de dato y, según contrato, cómo fue producido. Contribuye a interpretar su alcance. Ejemplo : Resultado conserva fuente y contexto de recopilación. Profundizar en la guía : [¿Cómo crear un asistente que encuentre la movilidad alrededor de una dirección?](https://www.roote.ai/es/guias/como-crear-un-asistente-que-encuentre-movilidad-cerca-de-una-direccion/) ## Atribución Mención al proveedor o fuente asociada a dato. Cuando se requiere, experiencia que usa resultado debe mostrarla. Ejemplo : Atribución required=true debe conservarse en interfaz. Profundizar en la guía : [Cómo buscar paradas de transporte cercanas con una API](https://www.roote.ai/es/guias/api-paradas-transporte-proximidad/) ## GTFS Schedule Formato estándar para describir oferta de transporte planificado: paradas, líneas, trayectos, calendarios y horarios. No provee actualizaciones en tiempo real automáticamente. Ejemplo : Horarios planeados vinculados a trayectos y días de servicio. Profundizar en la guía : [GTFS, GTFS-RT et GBFS : quelles différences ?](https://www.roote.ai/es/guias/gtfs-gtfs-rt-gbfs-differences/) ## GTFS Realtime — GTFS-RT Formato estándar para transmitir actualizaciones de trayectos, posición de vehículos y alertas. Categorías publicadas dependen del productor. Ejemplo : Flujo de posiciones no implica estimaciones para todas paradas. Profundizar en la guía : [GTFS, GTFS-RT et GBFS : quelles différences ?](https://www.roote.ai/es/guias/gtfs-gtfs-rt-gbfs-differences/) ## GBFS Formato estándar de datos públicos de movilidad compartida. Según versión y flujos, describe sistemas, estaciones, vehículos y estados. Ejemplo : Información de estaciones y contadores de disponibilidad separados. Profundizar en la guía : [GTFS, GTFS-RT et GBFS : quelles différences ?](https://www.roote.ai/es/guias/gtfs-gtfs-rt-gbfs-differences/) ## Valor desconocido — null Ausencia de valor conocida en contrato que usa null con este sentido. No debe reemplazarse por cero, falso o prueba de ausencia. Ejemplo : Contador de bicicletas null no indica estación vacía. Profundizar en la guía : [¿Resultado vacío o error API: cómo diferenciarlos?](https://www.roote.ai/es/guias/resultado-vacio-o-error-api-como-diferenciar/) ## API Interfaz que permite a un programa usar capacidades de otro servicio mediante contrato definido. Especifica entradas y respuestas esperadas. Ejemplo : App busca paradas con API ROOTE. Profundizar en la guía : [API o MCP: ¿cuál elegir para integrar datos de movilidad?](https://www.roote.ai/es/guias/api-o-mcp-que-elegir-para-integrar-datos-de-movilidad/) ## API REST Enfoque HTTP usando recursos y mecanismos web. Contrato API define rutas, métodos y representaciones. Ejemplo : Búsqueda enviada a ruta GET documentada. Profundizar en la guía : [Cómo buscar paradas de transporte cercanas con una API](https://www.roote.ai/es/guias/api-paradas-transporte-proximidad/) ## Endpoint — ruta API Dirección y operación expuestas por API para capacidad dada. Rutas distintas pueden devolver familias de resultados distintas. Ejemplo : /v1/transit/nearby busca lugares de transporte. Profundizar en la guía : [Cómo buscar paradas de transporte cercanas con una API](https://www.roote.ai/es/guias/api-paradas-transporte-proximidad/) ## Parámetro de consulta Valor transmitido en parte de URL tras signo de interrogación. Nombre y formato definidos por interfaz usada. Ejemplo : modes=bus,tram selecciona modos en URL compatible. Profundizar en la guía : [¿Cómo integrar un mapa de movilidad en tu sitio?](https://www.roote.ai/es/guias/como-integrar-un-mapa-de-movilidad-en-tu-sitio/) ## Estado HTTP Código que indica resultado de consulta a nivel HTTP. Debe completarse con validación de contenido y estado de negocio. Ejemplo : HTTP 200 puede contener estado de error de negocio. Profundizar en la guía : [¿Resultado vacío o error API: cómo diferenciarlos?](https://www.roote.ai/es/guias/resultado-vacio-o-error-api-como-diferenciar/) ## Resultado vacío — empty Búsqueda que no devuelve entidades en ámbito consultado. No prueba ausencia física de servicios fuera de información disponible. Ejemplo : No se devolvió ninguna parada con filtros solicitados. Profundizar en la guía : [¿Resultado vacío o error API: cómo diferenciarlos?](https://www.roote.ai/es/guias/resultado-vacio-o-error-api-como-diferenciar/) ## Respuesta parcial — partial Resultado con información usable pero con límites o elementos faltantes señalados. Debe acompañarse de advertencias pertinentes. Ejemplo : Una fuente responde mientras otra está indisponible. Profundizar en la guía : [¿Resultado vacío o error API: cómo diferenciarlos?](https://www.roote.ai/es/guias/resultado-vacio-o-error-api-como-diferenciar/) ## Tiempo agotado — timeout Interrupción de espera que excede duración prevista para operación. Indica búsqueda no completada, no ausencia de resultados. Ejemplo : App propone reintentar en vez de mostrar lista vacía. Profundizar en la guía : [¿Resultado vacío o error API: cómo diferenciarlos?](https://www.roote.ai/es/guias/resultado-vacio-o-error-api-como-diferenciar/) ## Límite de frecuencia — rate limit Restricción en ritmo de consultas permitidas por servicio. Reglas y recomendaciones dependen del contrato activo. Ejemplo : Código 429 pide respetar indicaciones para reintento. Profundizar en la guía : [¿Resultado vacío o error API: cómo diferenciarlos?](https://www.roote.ai/es/guias/resultado-vacio-o-error-api-como-diferenciar/) ## Token Bearer Identificador de acceso transmitido en encabezado Authorization según mecanismo previsto. Debe mantenerse en configuración segura. Ejemplo : Authorization: Bearer se usa sin publicar token en URL. Profundizar en la guía : [¿Cómo conectar un asistente IA al MCP ROOTE?](https://www.roote.ai/es/guias/como-conectar-un-asistente-ia-al-mcp-roote/) ## JSON Formato textual estructurado con objetos, arrays, cadenas y números. JSON válido puede no respetar esquema API. Ejemplo : Colección de estaciones debe tener tipo y campos esperados. Profundizar en la guía : [Cómo buscar paradas de transporte cercanas con una API](https://www.roote.ai/es/guias/api-paradas-transporte-proximidad/) ## OpenAPI Especificación que describe contrato de API HTTP en documento estructurado. Ayuda a verificar rutas, parámetros, respuestas y esquemas. Ejemplo : Contrato ROOTE publicado en openapi.json. Profundizar en la guía : [Cómo buscar paradas de transporte cercanas con una API](https://www.roote.ai/es/guias/api-paradas-transporte-proximidad/) ## Embed — mapa incrustado Inserción de experiencia externa en página, como mapa en iframe. Parámetros y permisos determinan contexto de uso. Ejemplo : Iframe ROOTE muestra bicicletas alrededor de Burdeos. Profundizar en la guía : [¿Cómo integrar un mapa de movilidad en tu sitio?](https://www.roote.ai/es/guias/como-integrar-un-mapa-de-movilidad-en-tu-sitio/) ## Iframe Elemento HTML que carga documento en página. En dominios distintos, página padre no puede leer estado interno de documento incluido libremente. Ejemplo : Cambios en búsqueda requieren intercambio documentado para comunicar padre. Profundizar en la guía : [¿Cómo integrar un mapa de movilidad en tu sitio?](https://www.roote.ai/es/guias/como-integrar-un-mapa-de-movilidad-en-tu-sitio/) ## MCP — Model Context Protocol Protocolo que permite a app IA comunicar con servidores que exponen herramientas o contexto. No define por sí solo calidad de datos devueltos. Ejemplo : Asistente descubre herramientas de búsqueda ROOTE. Profundizar en la guía : [¿Qué es un servidor MCP y para qué sirve?](https://www.roote.ai/es/guias/que-es-un-servidor-mcp-y-para-que-sirve/) ## Servidor MCP Programa que expone capacidades según protocolo MCP. Herramientas anunciadas definen lo que cliente puede usar. Ejemplo : tools/list permite consultar inventario disponible. Profundizar en la guía : [¿Qué es un servidor MCP y para qué sirve?](https://www.roote.ai/es/guias/que-es-un-servidor-mcp-y-para-que-sirve/) ## Cliente MCP Componente de app IA que comunica con servidor MCP. Gestiona intercambio del protocolo para conexión. Ejemplo : Cliente envía argumentos de búsqueda a ROOTE. Profundizar en la guía : [¿Qué es un servidor MCP y para qué sirve?](https://www.roote.ai/es/guias/que-es-un-servidor-mcp-y-para-que-sirve/) ## Aplicación anfitriona MCP App que recibe interacción con usuario y maneja uno o varios clientes MCP. Responsable del uso de resultados en su experiencia. Ejemplo : Tu app conversacional conecta servidor ROOTE. Profundizar en la guía : [¿Qué es un servidor MCP y para qué sirve?](https://www.roote.ai/es/guias/que-es-un-servidor-mcp-y-para-que-sirve/) ## Herramienta MCP Capacidad ejecutable descrita por nombre, función y esquema de argumentos. Asistente debe usar entradas aceptadas por esquema. Ejemplo : geocode recibe dirección; transit_nearby recibe coordenadas. Profundizar en la guía : [¿Cómo conectar un asistente IA al MCP ROOTE?](https://www.roote.ai/es/guias/como-conectar-un-asistente-ia-al-mcp-roote/) ## Streamable HTTP Transporte MCP que permite comunicación con servidor remoto vía HTTP. Su soporte debe verificarse en cliente usado. Ejemplo : Servidor remoto ROOTE usa https://mcp.roote.ai/mcp. Profundizar en la guía : [¿Cómo conectar un asistente IA al MCP ROOTE?](https://www.roote.ai/es/guias/como-conectar-un-asistente-ia-al-mcp-roote/) ## Respuesta basada en datos — grounding Construcción de respuesta a partir de información efectivamente recuperada o proporcionada. Campos faltantes y reservas deben mantenerse visibles. Ejemplo : Asistente repite lugares devueltos sin inventar horarios. Profundizar en la guía : [¿Cómo crear un asistente que encuentre la movilidad alrededor de una dirección?](https://www.roote.ai/es/guias/como-crear-un-asistente-que-encuentre-movilidad-cerca-de-una-direccion/) ## Alucinación de asistente IA Producción de información no fundamentada, presentada como si se conociera. En movilidad puede ser un horario o disponibilidad inventados. Ejemplo : Asistente anuncia paso mientras herramienta sólo devolvió una parada. Profundizar en la guía : [¿Cómo crear un asistente que encuentre la movilidad alrededor de una dirección?](https://www.roote.ai/es/guias/como-crear-un-asistente-que-encuentre-movilidad-cerca-de-una-direccion/) ## Inyección de prompt Intento de usar contenido externo para modificar instrucciones seguidas por asistente. Descripciones de proveedores deben ser datos, no órdenes. Ejemplo : Instrucción oculta en nombre de lugar no debe ejecutarse. Profundizar en la guía : [¿Cómo crear un asistente que encuentre la movilidad alrededor de una dirección?](https://www.roote.ai/es/guias/como-crear-un-asistente-que-encuentre-movilidad-cerca-de-una-direccion/) ## Solo lectura Capacidad de consulta sin modificar prevista por herramienta. Consultar disponibilidad no reserva, desbloquea ni alquila vehículo. Ejemplo : Herramientas Datos ROOTE sirven para consultar información. Profundizar en la guía : [¿Qué es un servidor MCP y para qué sirve?](https://www.roote.ai/es/guias/que-es-un-servidor-mcp-y-para-que-sirve/)