# Le glossaire de la mobilité et des données. Des définitions simples pour comprendre les transports, les services de proximité et les outils qui les relient à vos applications. Source: https://www.roote.ai/fr/glossaire/ Language: fr Author: ROOTE ## Vélo en libre-service Service permettant d’emprunter un vélo pour un usage temporaire, selon les conditions de l’opérateur. Il peut fonctionner avec des stations ou des véhicules sans station. Exemple : Vous repérez un vélo puis utilisez le service de location concerné. Approfondir dans le guide : [Comment trouver un vélo en libre-service près de soi ?](https://www.roote.ai/fr/guides/trouver-velo-libre-service/) ## Mobilité partagée Ensemble de services donnant accès à des véhicules utilisés successivement par plusieurs personnes, plutôt qu’à un véhicule réservé à un seul propriétaire. Exemple : Des vélos et des trottinettes proposés à la location dans une ville. Approfondir dans le guide : [Comment trouver un vélo en libre-service près de soi ?](https://www.roote.ai/fr/guides/trouver-velo-libre-service/) ## Borne d’attache Équipement d’une station auquel un vélo peut être attaché. Sa présence ne garantit pas qu’il accepte un retour à l’instant consulté. Exemple : Une place de retour doit être disponible et utilisable. Approfondir dans le guide : [Station de vélos vide ou pleine : que faire ?](https://www.roote.ai/fr/guides/station-velo-vide-pleine/) ## Station de vélos Lieu organisé pour prendre ou restituer des vélos partagés. Les coordonnées, les capacités et les disponibilités décrivent des aspects différents de la station. Exemple : Une station peut être présente sur la carte et momentanément vide. Approfondir dans le guide : [Station de vélos vide ou pleine : que faire ?](https://www.roote.ai/fr/guides/station-velo-vide-pleine/) ## Sans station — free-floating Organisation dans laquelle les véhicules ne sont pas obligatoirement pris et rendus à une borne fixe. Les zones et règles de stationnement restent celles du service. Exemple : Une trottinette doit être rendue dans une zone autorisée. Approfondir dans le guide : [Vélo en station ou sans station : quelles différences ?](https://www.roote.ai/fr/guides/velo-station-sans-station/) ## Disponibilité État ou quantité indiquant ce qui peut être utilisé selon les informations connues. Une disponibilité observée peut changer et ne vaut pas réservation. Exemple : Trois vélos observés à une station ne sont pas trois vélos réservés. Approfondir dans le guide : [Disponibilité des vélos en temps réel : comment l’afficher dans une application ?](https://www.roote.ai/fr/guides/disponibilite-velos-application/) ## Prise d’un véhicule Action consistant à commencer l’utilisation d’un véhicule. Un compteur positif ne suffit pas si le service signale que la prise est désactivée. Exemple : Des vélos sont présents, mais la station peut ne pas autoriser leur location. Approfondir dans le guide : [Disponibilité des vélos en temps réel : comment l’afficher dans une application ?](https://www.roote.ai/fr/guides/disponibilite-velos-application/) ## Restitution Fin de l’utilisation d’un véhicule selon les règles du service. Les possibilités de retour peuvent différer des possibilités de prise. Exemple : Une station permet un départ mais n’a plus de place de retour. Approfondir dans le guide : [Station de vélos vide ou pleine : que faire ?](https://www.roote.ai/fr/guides/station-velo-vide-pleine/) ## Vélo à assistance électrique Vélo dont un moteur assiste le pédalage selon ses caractéristiques. Dans des données de mobilité, le type de propulsion et la batterie peuvent être indiqués séparément. Exemple : Une station peut distinguer vélos mécaniques et vélos électriques. Approfondir dans le guide : [Disponibilité des vélos en temps réel : comment l’afficher dans une application ?](https://www.roote.ai/fr/guides/disponibilite-velos-application/) ## Intermodalité Utilisation successive de plusieurs modes de déplacement pendant un même trajet. Chaque étape conserve ses horaires, accès et conditions. Exemple : Vous rejoignez le tram à vélo puis poursuivez à pied. Approfondir dans le guide : [Comment combiner vélo et transports en commun au quotidien ?](https://www.roote.ai/fr/guides/velo-transports-commun/) ## Arrêt de transport Lieu où un service de transport prend ou dépose des voyageurs. Un arrêt découvert ne renseigne pas automatiquement les prochains passages. Exemple : Un arrêt de bus est retourné sans horaire de départ. Approfondir dans le guide : [Comment trouver l’arrêt de bus ou de tram le plus proche ?](https://www.roote.ai/fr/guides/trouver-arret-bus-tram/) ## Quai Espace ou point d’embarquement d’un lieu de transport. Plusieurs quais proches peuvent desservir des directions ou services différents. Exemple : Les deux sens d’une ligne peuvent utiliser des quais distincts. Approfondir dans le guide : [Comment trouver le bon arrêt de bus et la bonne direction ?](https://www.roote.ai/fr/guides/arret-bus-bonne-direction/) ## Ligne Service de transport identifié dans un réseau, avec un ou plusieurs parcours ou variantes. Le nom de la ligne ne suffit pas à déterminer le bon sens. Exemple : La même ligne peut proposer plusieurs terminus. Approfondir dans le guide : [Comment trouver le bon arrêt de bus et la bonne direction ?](https://www.roote.ai/fr/guides/arret-bus-bonne-direction/) ## Course Exécution d’un service de transport associée à un parcours et à des passages. Dans GTFS, une course est reliée à une ligne et à un service calendaire. Exemple : Deux départs successifs d’une même ligne correspondent à deux courses. Approfondir dans le guide : [GTFS, GTFS-RT et GBFS : quelles différences ?](https://www.roote.ai/fr/guides/gtfs-gtfs-rt-gbfs-differences/) ## Direction Indication du sens ou de la destination d’un service. Elle doit être vérifiée avec le parcours et le lieu d’embarquement. Exemple : Vous cherchez le tram vers votre destination, pas le sens inverse. Approfondir dans le guide : [Comment trouver le bon arrêt de bus et la bonne direction ?](https://www.roote.ai/fr/guides/arret-bus-bonne-direction/) ## Terminus Extrémité d’un parcours de transport. Une ligne peut avoir des variantes dont les terminus diffèrent. Exemple : Un service court termine avant le terminus habituel. Approfondir dans le guide : [Comment trouver le bon arrêt de bus et la bonne direction ?](https://www.roote.ai/fr/guides/arret-bus-bonne-direction/) ## Correspondance Passage d’un service ou d’un mode à un autre pendant un trajet. La proximité de deux arrêts ne garantit pas une correspondance réalisable. Exemple : Il faut prévoir le déplacement entre les quais et l’attente. Approfondir dans le guide : [Comment lire un plan de bus, de tram ou de métro ?](https://www.roote.ai/fr/guides/lire-plan-transports/) ## Horaire théorique Horaire prévu dans le plan de service pour une date et un passage donnés. Il ne décrit pas nécessairement la situation actuelle du véhicule. Exemple : Un départ est programmé à 8 h 10 dans le calendrier. Approfondir dans le guide : [Horaires de bus : quelle différence entre horaires théoriques et temps réel ?](https://www.roote.ai/fr/guides/horaires-theoriques-temps-reel/) ## Horaire estimé Prévision d’un passage futur calculée à partir des informations disponibles. Elle peut évoluer lorsque de nouvelles données arrivent. Exemple : Un passage prévu à 8 h 10 est maintenant estimé à 8 h 14. Approfondir dans le guide : [Horaires de bus : quelle différence entre horaires théoriques et temps réel ?](https://www.roote.ai/fr/guides/horaires-theoriques-temps-reel/) ## Prochain départ Passage ou départ à venir retourné pour un lieu et un service. Trouver un arrêt ne constitue pas une recherche de ses prochains départs. Exemple : La liste des arrêts et la liste des départs sont deux résultats distincts. Approfondir dans le guide : [Comment rechercher les arrêts de transport à proximité avec une API ?](https://www.roote.ai/fr/guides/api-arrets-transport-proximite/) ## Perturbation Événement affectant un service de transport, comme une interruption ou un changement de parcours. Ses effets doivent être lus dans le périmètre et la période indiqués. Exemple : Une alerte peut concerner une ligne seulement pendant certaines heures. Approfondir dans le guide : [Comment créer un assistant qui trouve les mobilités autour d’une adresse ?](https://www.roote.ai/fr/guides/creer-assistant-mobilite-adresse/) ## Calendrier de service Informations décrivant les jours où un service de transport est prévu, avec d’éventuelles exceptions. Les horaires doivent être interprétés avec ce calendrier. Exemple : Un passage prévu en semaine peut ne pas exister le dimanche. Approfondir dans le guide : [GTFS, GTFS-RT et GBFS : quelles différences ?](https://www.roote.ai/fr/guides/gtfs-gtfs-rt-gbfs-differences/) ## Service urbain Équipement ou service utile à proximité d’un lieu, par exemple des toilettes, un point d’eau ou une borne de recharge. Ses attributs peuvent être incomplets. Exemple : Un résultat de proximité décrit un service et les informations connues. Approfondir dans le guide : [Comment rechercher les arrêts de transport à proximité avec une API ?](https://www.roote.ai/fr/guides/api-arrets-transport-proximite/) ## Toilettes publiques Toilettes destinées à un usage public dans les conditions du lieu. Leur présence dans des données ne garantit ni gratuité, ni ouverture, ni accessibilité actuelle. Exemple : Vérifiez les conditions indiquées avant de vous déplacer. Approfondir dans le guide : [Comment trouver des toilettes publiques gratuites autour de soi ?](https://www.roote.ai/fr/guides/toilettes-publiques-gratuites-autour-de-moi/) ## Accessibilité Caractéristiques permettant l’usage d’un lieu ou service selon les besoins de la personne. Une donnée inconnue ne signifie ni accessible ni inaccessible. Exemple : L’accessibilité en fauteuil peut être renseignée ou rester inconnue. Approfondir dans le guide : [Toilettes publiques accessibles : que vérifier avant de se déplacer ?](https://www.roote.ai/fr/guides/toilettes-publiques-accessibles/) ## Personne à mobilité réduite — PMR Personne rencontrant des difficultés de déplacement, permanentes ou temporaires. Une mention PMR ne détaille pas à elle seule tous les accès ou équipements nécessaires. Exemple : La présence d’une rampe ne décrit pas tous les obstacles possibles. Approfondir dans le guide : [Toilettes publiques accessibles : que vérifier avant de se déplacer ?](https://www.roote.ai/fr/guides/toilettes-publiques-accessibles/) ## Horaires d’ouverture Plages pendant lesquelles un lieu annonce être ouvert. Elles ne constituent pas une confirmation en direct de son fonctionnement. Exemple : Une fermeture temporaire peut ne pas être reflétée dans les horaires habituels. Approfondir dans le guide : [Comment trouver des toilettes publiques gratuites autour de soi ?](https://www.roote.ai/fr/guides/toilettes-publiques-gratuites-autour-de-moi/) ## Eau potable Eau indiquée comme adaptée à la consommation humaine. Un point d’eau ou une fontaine ne doit pas être présenté comme potable sans information explicite. Exemple : Le type d’un équipement et ses attributs doivent être distingués. Approfondir dans le guide : [Comment rechercher les arrêts de transport à proximité avec une API ?](https://www.roote.ai/fr/guides/api-arrets-transport-proximite/) ## Borne de recharge Équipement permettant de recharger un véhicule compatible. Localiser une borne ne garantit pas sa disponibilité ou la compatibilité d’un connecteur. Exemple : Le lieu de recharge et son état d’usage sont deux informations différentes. Approfondir dans le guide : [Comment rechercher les arrêts de transport à proximité avec une API ?](https://www.roote.ai/fr/guides/api-arrets-transport-proximite/) ## Type de service Catégorie utilisée pour sélectionner ou décrire un service urbain. Les valeurs acceptées dépendent de l’interface et de son schéma. Exemple : L’API Services ROOTE utilise types=toilets pour les toilettes. Approfondir dans le guide : [Comment rechercher les arrêts de transport à proximité avec une API ?](https://www.roote.ai/fr/guides/api-arrets-transport-proximite/) ## Géolocalisation Obtention d’une position géographique par un appareil ou une application. Elle dépend notamment des permissions et de la précision disponibles. Exemple : Le bouton de localisation demande l’accord du navigateur. Approfondir dans le guide : [Comment intégrer une carte de mobilité dans son site ?](https://www.roote.ai/fr/guides/integrer-carte-mobilite-site/) ## Coordonnées GPS Valeurs permettant de représenter un point géographique, généralement par latitude et longitude. Leur ordre doit être précisé dans l’interface utilisée. Exemple : Une recherche de proximité reçoit deux coordonnées distinctes. Approfondir dans le guide : [Comment rechercher les arrêts de transport à proximité avec une API ?](https://www.roote.ai/fr/guides/api-arrets-transport-proximite/) ## Latitude Coordonnée exprimant la position au nord ou au sud de l’équateur, en degrés dans les exemples ROOTE. Les valeurs valides vont de −90 à 90. Exemple : La latitude du point de recherche est transmise dans lat. Approfondir dans le guide : [Comment rechercher les arrêts de transport à proximité avec une API ?](https://www.roote.ai/fr/guides/api-arrets-transport-proximite/) ## Longitude Coordonnée exprimant la position est-ouest par rapport au méridien de référence. Les exemples ROOTE utilisent des degrés entre −180 et 180. Exemple : La longitude peut être transmise dans lon ou dans l’alias documenté lng. Approfondir dans le guide : [Comment rechercher les arrêts de transport à proximité avec une API ?](https://www.roote.ai/fr/guides/api-arrets-transport-proximite/) ## Géocodage Recherche transformant une adresse ou expression géographique en candidats avec coordonnées. Plusieurs lieux peuvent correspondre à la même saisie. Exemple : Deux villes possèdent une rue portant le même nom. Approfondir dans le guide : [Comment créer un assistant qui trouve les mobilités autour d’une adresse ?](https://www.roote.ai/fr/guides/creer-assistant-mobilite-adresse/) ## Géocodage inverse Recherche de lieux ou libellés à partir de coordonnées. Un résultat peut représenter un lieu proche plutôt qu’une adresse exacte garantie. Exemple : Un point GPS est associé à un libellé lisible. Approfondir dans le guide : [Qu’est-ce qu’un serveur MCP et à quoi sert-il ?](https://www.roote.ai/fr/guides/serveur-mcp-definition/) ## Point d’intérêt — POI Lieu identifiable utile à une recherche, comme un établissement ou un équipement. Un POI se distingue d’une simple adresse postale. Exemple : Le nom d’un hôtel peut être recherché comme établissement. Approfondir dans le guide : [Comment créer un assistant qui trouve les mobilités autour d’une adresse ?](https://www.roote.ai/fr/guides/creer-assistant-mobilite-adresse/) ## Origine de recherche Point à partir duquel une recherche de proximité est effectuée et les distances calculées. Il peut différer du centre affiché par la carte. Exemple : La caméra se déplace tandis que la recherche reste centrée sur Bordeaux. Approfondir dans le guide : [Comment intégrer une carte de mobilité dans son site ?](https://www.roote.ai/fr/guides/integrer-carte-mobilite-site/) ## Rayon de recherche Distance autour du point d’origine utilisée pour délimiter une recherche. L’unité et les bornes dépendent du contrat de la route ou de l’outil. Exemple : radius=600 demande un rayon de 600 mètres dans l’exemple REST. Approfondir dans le guide : [Comment rechercher les arrêts de transport à proximité avec une API ?](https://www.roote.ai/fr/guides/api-arrets-transport-proximite/) ## Distance géographique Distance calculée entre positions selon la méthode du service. Elle n’est pas automatiquement une distance d’itinéraire ni un temps de marche. Exemple : Un lieu proche peut demander un détour pour être accessible. Approfondir dans le guide : [Comment rechercher les arrêts de transport à proximité avec une API ?](https://www.roote.ai/fr/guides/api-arrets-transport-proximite/) ## Zoom de carte Niveau d’agrandissement de la vue cartographique. Il contrôle l’affichage et ne remplace pas le rayon d’une requête API. Exemple : zoom=15 rapproche la vue de la carte. Approfondir dans le guide : [Comment intégrer une carte de mobilité dans son site ?](https://www.roote.ai/fr/guides/integrer-carte-mobilite-site/) ## Données en temps réel Informations actualisées pour représenter une situation récente ou alimenter une estimation. Leur fraîcheur doit être évaluée ; temps réel ne signifie pas instantané ni garanti. Exemple : Une estimation de passage est recalculée à partir de données récentes. Approfondir dans le guide : [Horaires de bus : quelle différence entre horaires théoriques et temps réel ?](https://www.roote.ai/fr/guides/horaires-theoriques-temps-reel/) ## Observation État ou événement constaté à un instant identifié. Il doit être distingué d’un événement prévu ou estimé. Exemple : Le passage effectif d’un bus peut différer de l’estimation annoncée. Approfondir dans le guide : [Horaires de bus : quelle différence entre horaires théoriques et temps réel ?](https://www.roote.ai/fr/guides/horaires-theoriques-temps-reel/) ## Fraîcheur des données Qualification de l’actualité d’une information, selon ses dates et les règles du contrat. L’heure de consultation ne suffit pas à prouver la fraîcheur de la source. Exemple : Un compteur reçu maintenant peut provenir d’une ancienne observation. Approfondir dans le guide : [Disponibilité des vélos en temps réel : comment l’afficher dans une application ?](https://www.roote.ai/fr/guides/disponibilite-velos-application/) ## Horodatage Indication temporelle associée à une donnée ou un événement. Son sens dépend du champ : observation, mise à jour, réception ou expiration. Exemple : source_updated_at et received_at ne décrivent pas la même étape. Approfondir dans le guide : [Disponibilité des vélos en temps réel : comment l’afficher dans une application ?](https://www.roote.ai/fr/guides/disponibilite-velos-application/) ## Donnée périmée — stale Information considérée trop ancienne selon le contrat ou la politique de validité. Elle peut être conservée comme historique récent, sans être présentée comme fraîche. Exemple : L’interface indique qu’une disponibilité doit être actualisée. Approfondir dans le guide : [Disponibilité des vélos en temps réel : comment l’afficher dans une application ?](https://www.roote.ai/fr/guides/disponibilite-velos-application/) ## Durée de validité — TTL Durée utilisée pour gérer la validité ou le renouvellement d’une donnée en cache, selon le contrat. Elle ne prouve pas à elle seule l’heure de l’observation source. Exemple : Un cache expiré doit suivre la politique de rafraîchissement prévue. Approfondir dans le guide : [Disponibilité des vélos en temps réel : comment l’afficher dans une application ?](https://www.roote.ai/fr/guides/disponibilite-velos-application/) ## Cache Stockage temporaire de résultats pour éviter des recherches identiques répétées. Une valeur en cache conserve son origine et son contexte temporel. Exemple : Deux demandes identiques peuvent réutiliser une réponse encore valide. Approfondir dans le guide : [Disponibilité des vélos en temps réel : comment l’afficher dans une application ?](https://www.roote.ai/fr/guides/disponibilite-velos-application/) ## Couverture Périmètre et degré de complétude des informations disponibles pour une recherche ou une source. Une couverture partielle limite les conclusions possibles. Exemple : Une liste peut être utile sans représenter tous les services existants. Approfondir dans le guide : [Aucun résultat ou erreur API : comment faire la différence ?](https://www.roote.ai/fr/guides/aucun-resultat-erreur-api/) ## Provenance Informations permettant d’identifier d’où vient une donnée et, selon le contrat, comment elle a été produite. Elles aident à interpréter sa portée. Exemple : Un résultat conserve sa source et son contexte de collecte. Approfondir dans le guide : [Comment créer un assistant qui trouve les mobilités autour d’une adresse ?](https://www.roote.ai/fr/guides/creer-assistant-mobilite-adresse/) ## Attribution Mention du fournisseur ou de la source associée à une donnée. Lorsqu’elle est requise, l’expérience qui utilise le résultat doit l’afficher. Exemple : Une attribution required=true doit être conservée dans l’interface. Approfondir dans le guide : [Comment rechercher les arrêts de transport à proximité avec une API ?](https://www.roote.ai/fr/guides/api-arrets-transport-proximite/) ## GTFS Schedule Format standard de description de l’offre de transport planifiée : arrêts, lignes, courses, calendriers et passages. Il ne fournit pas automatiquement des mises à jour en temps réel. Exemple : Les passages planifiés sont reliés aux courses et aux jours de service. Approfondir dans le guide : [GTFS, GTFS-RT et GBFS : quelles différences ?](https://www.roote.ai/fr/guides/gtfs-gtfs-rt-gbfs-differences/) ## GTFS Realtime — GTFS-RT Format standard permettant de transmettre notamment des mises à jour de courses, positions de véhicules et alertes. Les catégories effectivement publiées dépendent du producteur. Exemple : Un flux de positions n’implique pas des estimations pour tous les arrêts. Approfondir dans le guide : [GTFS, GTFS-RT et GBFS : quelles différences ?](https://www.roote.ai/fr/guides/gtfs-gtfs-rt-gbfs-differences/) ## GBFS Format standard de données publiques de mobilité partagée. Selon la version et les flux, il décrit les systèmes, les stations, les véhicules et leurs états. Exemple : Les informations de station et les compteurs de disponibilité sont séparés. Approfondir dans le guide : [GTFS, GTFS-RT et GBFS : quelles différences ?](https://www.roote.ai/fr/guides/gtfs-gtfs-rt-gbfs-differences/) ## Valeur inconnue — null Absence d’une valeur connue dans un contrat qui utilise null pour ce sens. Elle ne doit pas être remplacée par zéro, faux ou une preuve d’absence. Exemple : Un compteur de vélos null n’indique pas une station vide. Approfondir dans le guide : [Aucun résultat ou erreur API : comment faire la différence ?](https://www.roote.ai/fr/guides/aucun-resultat-erreur-api/) ## API Interface permettant à un programme d’utiliser les capacités d’un autre service à travers un contrat défini. Elle précise notamment les entrées et les réponses attendues. Exemple : Une application recherche des arrêts avec l’API ROOTE. Approfondir dans le guide : [API ou MCP : lequel choisir pour intégrer des données de mobilité ?](https://www.roote.ai/fr/guides/api-ou-mcp-mobilite/) ## API REST Approche d’interface HTTP utilisant des ressources et les mécanismes du web. Le contrat d’une API précise ses routes, méthodes et représentations. Exemple : Une recherche est envoyée à une route GET documentée. Approfondir dans le guide : [Comment rechercher les arrêts de transport à proximité avec une API ?](https://www.roote.ai/fr/guides/api-arrets-transport-proximite/) ## Endpoint — route API Adresse et opération exposées par une API pour une capacité donnée. Des routes différentes peuvent renvoyer des familles de résultats différentes. Exemple : /v1/transit/nearby recherche des lieux de transport. Approfondir dans le guide : [Comment rechercher les arrêts de transport à proximité avec une API ?](https://www.roote.ai/fr/guides/api-arrets-transport-proximite/) ## Paramètre de requête Valeur transmise dans la partie de l’URL située après le point d’interrogation. Son nom et son format sont définis par l’interface utilisée. Exemple : modes=bus,tram sélectionne des modes dans une URL compatible. Approfondir dans le guide : [Comment intégrer une carte de mobilité dans son site ?](https://www.roote.ai/fr/guides/integrer-carte-mobilite-site/) ## Statut HTTP Code indiquant le résultat de la requête au niveau HTTP. Il doit être complété par la validation du contenu et de son statut métier. Exemple : Un HTTP 200 peut contenir un statut métier error. Approfondir dans le guide : [Aucun résultat ou erreur API : comment faire la différence ?](https://www.roote.ai/fr/guides/aucun-resultat-erreur-api/) ## Résultat vide — empty Recherche ne retournant aucune entité dans le périmètre consulté. Elle ne prouve pas l’absence physique de services en dehors des informations disponibles. Exemple : Aucun arrêt n’a été retourné avec les filtres demandés. Approfondir dans le guide : [Aucun résultat ou erreur API : comment faire la différence ?](https://www.roote.ai/fr/guides/aucun-resultat-erreur-api/) ## Réponse partielle — partial Résultat contenant des informations utilisables avec des limites ou des éléments manquants signalés. Il doit être accompagné de ses avertissements pertinents. Exemple : Une source répond alors qu’une autre est indisponible. Approfondir dans le guide : [Aucun résultat ou erreur API : comment faire la différence ?](https://www.roote.ai/fr/guides/aucun-resultat-erreur-api/) ## Délai dépassé — timeout Interruption d’une attente qui dépasse la durée prévue pour une opération. Elle indique une recherche non aboutie, pas une absence de résultats. Exemple : L’application propose de réessayer au lieu d’afficher une liste vide. Approfondir dans le guide : [Aucun résultat ou erreur API : comment faire la différence ?](https://www.roote.ai/fr/guides/aucun-resultat-erreur-api/) ## Limite de fréquence — rate limit Restriction sur le rythme des requêtes autorisées par un service. Les règles et consignes de reprise dépendent du contrat actif. Exemple : Un code 429 demande de respecter les indications de reprise. Approfondir dans le guide : [Aucun résultat ou erreur API : comment faire la différence ?](https://www.roote.ai/fr/guides/aucun-resultat-erreur-api/) ## Jeton Bearer Identifiant d’accès transmis dans un en-tête Authorization selon le mécanisme prévu. Il doit être conservé dans une configuration sécurisée. Exemple : Authorization: Bearer est utilisé sans publier le jeton dans une URL. Approfondir dans le guide : [Comment connecter un assistant IA au MCP ROOTE ?](https://www.roote.ai/fr/guides/connecter-assistant-mcp-roote/) ## JSON Format textuel structuré utilisant notamment des objets, tableaux, chaînes et nombres. Un JSON syntaxiquement valide peut ne pas respecter le schéma d’une API. Exemple : Une collection stations doit avoir le type et les champs attendus. Approfondir dans le guide : [Comment rechercher les arrêts de transport à proximité avec une API ?](https://www.roote.ai/fr/guides/api-arrets-transport-proximite/) ## OpenAPI Spécification décrivant le contrat d’une API HTTP dans un document structuré. Elle aide à vérifier routes, paramètres, réponses et schémas. Exemple : Le contrat ROOTE est publié dans openapi.json. Approfondir dans le guide : [Comment rechercher les arrêts de transport à proximité avec une API ?](https://www.roote.ai/fr/guides/api-arrets-transport-proximite/) ## Embed — carte intégrée Insertion d’une expérience externe dans une page, par exemple une carte dans une iframe. Les paramètres et permissions déterminent son contexte d’utilisation. Exemple : Une iframe ROOTE affiche les vélos autour de Bordeaux. Approfondir dans le guide : [Comment intégrer une carte de mobilité dans son site ?](https://www.roote.ai/fr/guides/integrer-carte-mobilite-site/) ## Iframe Élément HTML chargeant un document dans une page. Sur des domaines différents, la page parente ne peut pas lire librement l’état interne du document intégré. Exemple : Les changements de recherche nécessitent un échange documenté pour remonter au parent. Approfondir dans le guide : [Comment intégrer une carte de mobilité dans son site ?](https://www.roote.ai/fr/guides/integrer-carte-mobilite-site/) ## MCP — Model Context Protocol Protocole permettant à une application IA de communiquer avec des serveurs exposant des outils ou du contexte. Il ne définit pas à lui seul la qualité des données retournées. Exemple : Un assistant découvre les outils de recherche de ROOTE. Approfondir dans le guide : [Qu’est-ce qu’un serveur MCP et à quoi sert-il ?](https://www.roote.ai/fr/guides/serveur-mcp-definition/) ## Serveur MCP Programme exposant des capacités selon le protocole MCP. Les outils réellement annoncés par le serveur déterminent ce que le client peut appeler. Exemple : tools/list permet de consulter l’inventaire disponible. Approfondir dans le guide : [Qu’est-ce qu’un serveur MCP et à quoi sert-il ?](https://www.roote.ai/fr/guides/serveur-mcp-definition/) ## Client MCP Composant de l’application IA qui communique avec un serveur MCP. Il gère les échanges du protocole pour cette connexion. Exemple : Le client transmet les arguments d’une recherche à ROOTE. Approfondir dans le guide : [Qu’est-ce qu’un serveur MCP et à quoi sert-il ?](https://www.roote.ai/fr/guides/serveur-mcp-definition/) ## Application hôte MCP Application qui accueille l’interaction avec l’utilisateur et gère un ou plusieurs clients MCP. Elle reste responsable de l’utilisation des résultats dans son expérience. Exemple : Votre application conversationnelle connecte un serveur ROOTE. Approfondir dans le guide : [Qu’est-ce qu’un serveur MCP et à quoi sert-il ?](https://www.roote.ai/fr/guides/serveur-mcp-definition/) ## Outil MCP Capacité exécutable décrite par un nom, une fonction et un schéma d’arguments. L’assistant doit utiliser les entrées acceptées par ce schéma. Exemple : geocode reçoit une adresse ; transit_nearby reçoit des coordonnées. Approfondir dans le guide : [Comment connecter un assistant IA au MCP ROOTE ?](https://www.roote.ai/fr/guides/connecter-assistant-mcp-roote/) ## Streamable HTTP Transport MCP permettant la communication avec un serveur distant par HTTP. Sa prise en charge doit être vérifiée dans le client utilisé. Exemple : Le serveur distant ROOTE utilise https://mcp.roote.ai/mcp. Approfondir dans le guide : [Comment connecter un assistant IA au MCP ROOTE ?](https://www.roote.ai/fr/guides/connecter-assistant-mcp-roote/) ## Réponse fondée sur les données — grounding Construction d’une réponse à partir d’informations effectivement récupérées ou fournies. Les champs manquants et les réserves doivent rester visibles. Exemple : L’assistant reprend les lieux retournés sans inventer leurs horaires. Approfondir dans le guide : [Comment créer un assistant qui trouve les mobilités autour d’une adresse ?](https://www.roote.ai/fr/guides/creer-assistant-mobilite-adresse/) ## Hallucination d’un assistant IA Production d’une information non étayée, présentée comme si elle était connue. Dans la mobilité, cela peut être un horaire ou une disponibilité inventés. Exemple : L’assistant annonce un passage alors que l’outil n’a retourné qu’un arrêt. Approfondir dans le guide : [Comment créer un assistant qui trouve les mobilités autour d’une adresse ?](https://www.roote.ai/fr/guides/creer-assistant-mobilite-adresse/) ## Injection de prompt Tentative d’utiliser un contenu externe pour modifier les instructions suivies par un assistant. Les descriptions de fournisseurs doivent rester des données, pas des ordres. Exemple : Une instruction cachée dans le nom d’un lieu ne doit pas être exécutée. Approfondir dans le guide : [Comment créer un assistant qui trouve les mobilités autour d’une adresse ?](https://www.roote.ai/fr/guides/creer-assistant-mobilite-adresse/) ## Lecture seule Capacité de consultation sans action de modification prévue par l’outil. Lire une disponibilité ne réserve, ne déverrouille ni ne loue un véhicule. Exemple : Les outils Data ROOTE servent à consulter des informations. Approfondir dans le guide : [Qu’est-ce qu’un serveur MCP et à quoi sert-il ?](https://www.roote.ai/fr/guides/serveur-mcp-definition/)