Accessibilità
Caratteristiche che permettono l’uso di un luogo o servizio secondo esigenze personali. Dato sconosciuto non significa né accessibile né non accessibile.
Esempio
L’accessibilità con sedia a rotelle può essere specificata o sconosciuta.
Glossario ROOTE
Il glossario della mobilità e dei dati.
Definizioni semplici per comprendere trasporti, servizi di prossimità e strumenti che li collegano alle tue app.
79 definizioni visualizzate
A
Acqua potabile
Acqua indicata come adatta al consumo umano. Punto acqua o fontana non va presentato come potabile senza info esplicite.
Esempio
Tipo di equipaggiamento e attributi vanno distinti.
Allucinazione assistente IA
Produzione di info non supportata, presentata come nota. In mobilità può essere orario o disponibilità inventati.
Esempio
Assistente annuncia passaggio mentre lo strumento ha restituito solo fermata.
API
Interfaccia che permette a programma di usare capacità di altro servizio tramite contratto definito. Specifica input e risposte attese.
Esempio
Un’app cerca fermate con API ROOTE.
API REST
Approccio interfaccia HTTP che usa risorse e meccanismi web. Contratto API indica rotte, metodi e rappresentazioni.
Esempio
Ricerca inviata a rotta GET documentata.
Applicazione host MCP
App che ospita interazione con utente e gestisce uno o più client MCP. Rimane responsabile uso risultati nella sua esperienza.
Esempio
La tua app conversazionale connette un server ROOTE.
Attribuzione
Indicazione del fornitore o fonte associata a dato. In caso obbligo, esperienza che usa risultato deve mostrarla.
Esempio
Attribuzione required=true va mantenuta in interfaccia.
B
Bagni pubblici
Toilette per uso pubblico secondo condizioni locali. La loro presenza nei dati non garantisce gratuità, apertura o accessibilità attuale.
Esempio
Verifica condizioni indicate prima di muoverti.
Banchina
Spazio o punto di imbarco in un luogo di trasporto. Diverse banchine vicine possono servire direzioni o servizi differenti.
Esempio
Due sensi di una linea possono usare banchine distinte.
Bicicletta a pedalata assistita
Bici con motore che assiste la pedalata secondo le sue caratteristiche. Nei dati di mobilità, tipo di propulsione e batteria possono essere indicati separatamente.
Esempio
Una stazione può distinguere bici meccaniche ed elettriche.
Bicicletta in libero servizio
Servizio che permette di prendere in prestito una bici per uso temporaneo secondo le condizioni dell’operatore. Può funzionare con stazioni o veicoli senza stazione.
Esempio
Individui una bici e usi il relativo servizio di noleggio.
C
Cache
Archivio temporaneo di risultati per evitare ricerche ripetute identiche. Valore in cache conserva origine e contesto temporale.
Esempio
Due richieste identiche possono riusare risposta ancora valida.
Calendario di servizio
Informazioni sui giorni in cui è previsto un servizio di trasporto, con eventuali eccezioni. Orari da interpretare con questo calendario.
Esempio
Un passaggio in settimana potrebbe non esserci la domenica.
Cambio
Passaggio da un servizio o modalità a un altro durante un viaggio. La vicinanza di due fermate non garantisce un cambio fattibile.
Esempio
Devi prevedere il tragitto tra banchine e l’attesa.
Capolinea
Estremità di un percorso di trasporto. Una linea può avere varianti con diversi capolinea.
Esempio
Un servizio breve termina prima del capolinea abituale.
Client MCP
Componente app IA che comunica con server MCP. Gestisce scambi protocollo per questa connessione.
Esempio
Client invia argomenti ricerca a ROOTE.
Colonnina di ricarica
Equipaggiamento per ricaricare veicoli compatibili. Localizzare una colonnina non garantisce disponibilità o compatibilità con connettori.
Esempio
Luogo di ricarica e stato di utilizzo sono dati diversi.
Coordinate GPS
Valori per rappresentare un punto geografico, di solito latitudine e longitudine. L’ordine va specificato nell’interfaccia usata.
Esempio
Una ricerca di prossimità riceve due coordinate distinte.
Copertura
Ambito e grado di completezza info disponibili per ricerca o fonte. Copertura parziale limita conclusioni applicabili.
Esempio
Una lista può essere utile senza rappresentare tutti i servizi esistenti.
Corsa
Esecuzione di un servizio di trasporto associato a un percorso e passaggi. In GTFS una corsa è legata a una linea e un calendario di servizio.
Esempio
Due partenze successive della stessa linea corrispondono a due corse.
D
Dati in tempo reale
Informazioni aggiornate per rappresentare situazione recente o stimare. Va valutata freschezza; tempo reale non significa istantaneo né garantito.
Esempio
Stima passaggio ricalcolata da dati recenti.
Dato scaduto — stale
Informazione considerata troppo vecchia secondo contratto o politica validità. Può essere conservata come storico senza essere fresca.
Esempio
Interfaccia indica che disponibilità va aggiornata.
Direzione
Indicazione del senso o destinazione di un servizio. Va verificata con percorso e luogo di imbarco.
Esempio
Cerchi il tram verso la tua destinazione, non in senso opposto.
Disponibilità
Stato o quantità che indica ciò che può essere usato secondo le informazioni note. Una disponibilità osservata può cambiare e non vale come prenotazione.
Esempio
Tre bici osservate in stazione non sono tre bici riservate.
Distanza geografica
Distanza calcolata tra posizioni secondo metodo del servizio. Non sempre distanza di percorso o tempo a piedi.
Esempio
Luogo vicino potrebbe richiedere percorso deviato per accesso.
Durata validità — TTL
Durata per gestire validità o rinnovo dato in cache secondo contratto. Non prova da sola ora osservazione origine.
Esempio
Cache scaduta deve seguire politica aggiornamento.
E
Embed — mappa integrata
Inserimento esperienza esterna in pagina, ad esempio mappa in iframe. Parametri e permessi determinano contesto uso.
Esempio
Iframe ROOTE mostra bici attorno a Bordeaux.
Endpoint — rotta API
Indirizzo e operazione esposti da API per capacità data. Rotte diverse possono restituire famiglie di risultati diverse.
Esempio
/v1/transit/nearby ricerca luoghi di trasporto.
F
Fermata di trasporto
Luogo dove un servizio di trasporto prende o lascia passeggeri. Una fermata scoperta non riporta necessariamente i prossimi passaggi.
Esempio
Una fermata bus è restituita senza orario di partenza.
Freschezza dati
Qualifica di attualità info secondo date e regole del contratto. Ora consultazione non prova freschezza fonte.
Esempio
Contatore ricevuto ora può derivare da osservazione vecchia.
G
GBFS
Formato standard dati pubblici di mobilità condivisa. Per versione e flussi descrive sistemi, stazioni, veicoli e stati.
Esempio
Informazioni stazione e contatori disponibilità separati.
Geocoding
Ricerca che trasforma indirizzo o espressione geografica in candidati con coordinate. Più luoghi possono corrispondere a stessa inserzione.
Esempio
Due città con strade aventi stessa denominazione.
Geocoding inverso
Ricerca di luoghi o etichette a partire da coordinate. Un risultato può rappresentare luogo vicino, non necessariamente indirizzo esatto.
Esempio
Punto GPS associato a etichetta leggibile.
Geolocalizzazione
Ottenzione di posizione geografica da dispositivo o app. Dipende da permessi e precisione disponibili.
Esempio
Il tasto localizza richiede autorizzazione browser.
GTFS Realtime — GTFS-RT
Formato standard per trasmettere aggiornamenti corse, posizioni veicoli, allerte. Categorie pubblicate dipendono da produttore.
Esempio
Flusso posizioni non implica stime per tutte fermate.
GTFS Schedule
Formato standard per descrivere offerta di trasporto pianificata: fermate, linee, corse, calendari, passaggi. Non offre aggiornamenti in tempo reale.
Esempio
Passaggi pianificati collegati a corse e giorni di servizio.
I
Iframe
Elemento HTML che carica documento in pagina. Su domini diversi, pagina padre non legge stato interno documento incorporato liberamente.
Esempio
Modifiche ricerca richiedono scambio documentato per risalire a padre.
Injection di prompt
Tentativo di usare contenuto esterno per modificare istruzioni seguite da assistente. Descrizioni fornitori devono restare dati, non comandi.
Esempio
Istruzione nascosta in nome luogo non va eseguita.
Intermodalità
Uso successivo di più modalità di spostamento nello stesso viaggio. Ogni tappa mantiene i propri orari, accessi e condizioni.
Esempio
Prendi il tram in bicicletta e prosegui a piedi.
Interruzione
Evento che interessa un servizio di trasporto, come interruzione o deviazione. I suoi effetti vanno letti in ambito e periodo indicati.
Esempio
Una segnalazione può riguardare una linea solo in certe ore.
J
JSON
Formato testuale strutturato con oggetti, array, stringhe e numeri. JSON sintatticamente valido può non rispettare schema API.
Esempio
Collezione stations deve avere tipo e campi attesi.
L
Latitudine
Coordinata che esprime posizione nord o sud dell’equatore in gradi secondo esempi ROOTE. Valori validi da −90 a 90.
Esempio
Latitudine del punto di ricerca trasmessa in lat.
Limite frequenza — rate limit
Restrizione sul ritmo delle richieste consentite da servizio. Regole e istruzioni di ripresa dipendono da contratto attivo.
Esempio
Codice 429 invita a rispettare indicazioni di ripresa.
Linea
Servizio di trasporto identificato in una rete, con uno o più percorsi o varianti. Il nome linea non basta per determinare la direzione giusta.
Esempio
Una linea può avere più terminus.
Longitudine
Coordinata che esprime posizione est-ovest rispetto al meridiano di riferimento. Esempi ROOTE usano gradi da −180 a 180.
Esempio
Longitudine trasmessa in lon o alias documentato lng.
M
MCP — Model Context Protocol
Protocollo che permette app IA di comunicare con server che espongono strumenti o contesto. Non definisce da solo qualità dati restituiti.
Esempio
Assistente scopre strumenti di ricerca ROOTE.
Mobilità condivisa
Insieme di servizi che offrono accesso a veicoli usati successivamente da più persone, non riservati a un singolo proprietario.
Esempio
Bici e monopattini disponibili a noleggio in città.
O
OpenAPI
Specificazione che descrive contratto API HTTP in documento strutturato. Aiuta a verificare rotte, parametri, risposte e schemi.
Esempio
Contratto ROOTE pubblicato in openapi.json.
Orari di apertura
Fasce orarie in cui un luogo dichiara di essere aperto. Non è conferma in tempo reale del suo funzionamento.
Esempio
Una chiusura temporanea potrebbe non riflettersi negli orari usuali.
Orario previsto
Orario pianificato nel piano di servizio per data e passaggio dato. Non descrive necessariamente la situazione attuale del veicolo.
Esempio
Una partenza è programmata alle 8:10 nel calendario.
Orario stimato
Previsione di un passaggio futuro basata sui dati disponibili, che può variare al cambiare delle informazioni.
Esempio
Un passaggio previsto 8:10 è ora stimato alle 8:14.
Origine ricerca
Punto da cui parte ricerca di prossimità e calcolo distanze. Può differire dal centro mostrato sulla mappa.
Esempio
La visuale si sposta, ricerca resta centrata su Bordeaux.
Osservazione
Stato o evento rilevato in momento identificato. Da distinguere da evento previsto o stimato.
Esempio
Passaggio effettivo bus può differire da stima.
P
Parametro di query
Valore trasmesso nella parte URL dopo punto interrogativo. Nome e formato definiti da interfaccia usata.
Esempio
modes=bus,tram seleziona modalità in URL compatibile.
Persona a mobilità ridotta — PMR
Persona con difficoltà di spostamento, temporanee o permanenti. Una menzione PMR non dettaglia da sola tutte le necessità o dispositivi coinvolti.
Esempio
La presenza di una rampa non descrive tutti gli ostacoli possibili.
Postazione di ancoraggio
Equipaggiamento di una stazione a cui una bici può essere agganciata. La presenza non garantisce che accetti una restituzione in quel momento.
Esempio
Deve essere disponibile e utilizzabile uno spazio di ritorno.
Prelievo di un veicolo
Azione di iniziare l’uso di un veicolo. Un contatore positivo non basta se il servizio segnala che il prelievo è disabilitato.
Esempio
Ci sono bici presenti, ma la stazione potrebbe non autorizzarne il noleggio.
Prossima partenza
Passaggio o partenza futura per luogo e servizio. Trovare una fermata non equivale a cercare le sue partenze prossime.
Esempio
Lista fermate e lista partenze sono risultati distinti.
Provenienza
Informazioni per identificare origine dato e come è stato prodotto secondo contratto. Aiutano a interpretarne portata.
Esempio
Un risultato mantiene fonte e contesto raccolta.
Punto d’interesse — POI
Luogo identificabile utile a ricerca come struttura o dotazione. POI distinto da semplice indirizzo postale.
Esempio
Nome di un hotel cercabile come struttura.
R
Raggio di ricerca
Distanza intorno all’origine per limitare ricerca. Unità e limiti dipendono dal contratto della rotta o strumento.
Esempio
radius=600 richiede raggio 600 metri in esempio REST.
Restituzione
Fine dell’uso di un veicolo secondo le regole del servizio. Le possibilità di restituzione possono differire da quelle di prelievo.
Esempio
Una stazione consente partenze ma non ha più posti per la restituzione.
Risposta fondata su dati — grounding
Costruzione risposta da informazioni effettivamente recuperate o fornite. Campi mancanti e riserve devono restare visibili.
Esempio
Assistente riporta luoghi ottenuti senza inventare orari.
Risposta parziale — partial
Risultato con informazioni utilizzabili ma con limiti o elementi mancanti segnalati. Deve essere accompagnato da avvisi pertinenti.
Esempio
Una fonte risponde mentre un’altra è indisponibile.
Risultato vuoto — empty
Ricerca che non restituisce entità nell’ambito consultato. Non prova assenza fisica servizi fuori dati disponibili.
Esempio
Nessuna fermata restituita con filtri richiesti.
S
Senza stazione — free-floating
Organizzazione in cui i veicoli non devono necessariamente essere presi o restituiti a una postazione fissa. Sono valide le zone e regole di sosta del servizio.
Esempio
Un monopattino deve essere restituito in un’area autorizzata.
Server MCP
Programma che espone capacità secondo protocollo MCP. Strumenti annunciati definiscono cosa client può invocare.
Esempio
tools/list permette consultare inventario disponibile.
Servizio urbano
Infrastruttura o servizio utile vicino a un luogo, ad esempio toilette, punto acqua o colonnina ricarica. Attributi possono essere incompleti.
Esempio
Un risultato di prossimità descrive un servizio e info note.
Sola lettura
Capacità di consultazione senza modifica prevista dallo strumento. Leggere disponibilità non riserva, sblocca o noleggia veicolo.
Esempio
Strumenti Data ROOTE servono a consultare informazioni.
Stato HTTP
Codice che indica risultato richiesta a livello HTTP. Deve essere completato da validazione contenuto e stato business.
Esempio
HTTP 200 può contenere stato business error.
Stazione bici
Luogo organizzato per prendere o restituire bici condivise. Coordinate, capacità e disponibilità descrivono aspetti diversi della stazione.
Esempio
Una stazione può comparire sulla mappa ed essere temporaneamente vuota.
Streamable HTTP
Trasporto MCP che permette comunicazione con server remoto via HTTP. Compatibilità da verificare nel client usato.
Esempio
Server remoto ROOTE usa https://mcp.roote.ai/mcp.
Strumento MCP
Capacità eseguibile descritta da nome, funzione e schema argomenti. Assistente deve usare input accettati dallo schema.
Esempio
geocode riceve indirizzo; transit_nearby riceve coordinate.
T
Timeout
Interruzione attesa che supera durata prevista per operazione. Indica ricerca incompleta, non assenza di risultati.
Esempio
App propone di riprovare invece di mostrare lista vuota.
Timestamp
Indicazione temporale associata a dato o evento. Significato dipende dal campo: osservazione, aggiornamento, ricezione o scadenza.
Esempio
source_updated_at e received_at descrivono fasi diverse.
Tipo di servizio
Categoria usata per selezionare o descrivere un servizio urbano. Valori accettati dipendono da interfaccia e schema.
Esempio
L’API Servizi ROOTE usa types=toilets per i bagni.
Token Bearer
Identificativo accesso trasmesso in header Authorization secondo meccanismo previsto. Deve essere conservato in configurazione sicura.
Esempio
Authorization: Bearer usato senza esporre token in URL.
V
Valore sconosciuto — null
Assenza di valore noto in contratto che usa null per questo senso. Non va sostituito con zero, falso o prova di assenza.
Esempio
Contatore bici null non indica stazione vuota.
Z
Zoom mappa
Livello ingrandimento vista mappa. Controlla visualizzazione ma non sostituisce raggio di richiesta API.
Esempio
zoom=15 avvicina la vista della mappa.
Nessuna definizione corrisponde. Prova un’altra parola o rimuovi il filtro.
Riferimenti per approfondimenti
I termini specifici ROOTE seguono i suoi contratti documentati. Standard e protocolli hanno propri riferimenti ufficiali.
Torna al centro risorse