# Il glossario della mobilità e dei dati. Definizioni semplici per comprendere trasporti, servizi di prossimità e strumenti che li collegano alle tue app. Source: https://www.roote.ai/it/glossario-mobilita/ Language: it Author: ROOTE ## 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. Approfondisci nella guida : [Come trovare una bici in libero servizio vicino a te?](https://www.roote.ai/it/guides/come-trovare-una-bicicletta-in-libero-servizio-vicino-a-te/) ## 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à. Approfondisci nella guida : [Come trovare una bici in libero servizio vicino a te?](https://www.roote.ai/it/guides/come-trovare-una-bicicletta-in-libero-servizio-vicino-a-te/) ## 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. Approfondisci nella guida : [Stazione bici vuota o piena: cosa fare?](https://www.roote.ai/it/guides/stazione-bici-vuota-o-piena-cosa-fare/) ## 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. Approfondisci nella guida : [Stazione bici vuota o piena: cosa fare?](https://www.roote.ai/it/guides/stazione-bici-vuota-o-piena-cosa-fare/) ## 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. Approfondisci nella guida : [Bici con stazione o senza stazione: quali differenze?](https://www.roote.ai/it/guides/bici-con-stazione-o-senza-quali-differenze/) ## 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. Approfondisci nella guida : [Disponibilità delle bici in tempo reale: come visualizzarla in un'app?](https://www.roote.ai/it/guides/disponibilita-bici-tempo-reale-app/) ## 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. Approfondisci nella guida : [Disponibilità delle bici in tempo reale: come visualizzarla in un'app?](https://www.roote.ai/it/guides/disponibilita-bici-tempo-reale-app/) ## 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. Approfondisci nella guida : [Stazione bici vuota o piena: cosa fare?](https://www.roote.ai/it/guides/stazione-bici-vuota-o-piena-cosa-fare/) ## 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. Approfondisci nella guida : [Disponibilità delle bici in tempo reale: come visualizzarla in un'app?](https://www.roote.ai/it/guides/disponibilita-bici-tempo-reale-app/) ## 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. Approfondisci nella guida : [Come combinare bicicletta e trasporti pubblici nella vita quotidiana?](https://www.roote.ai/it/guides/come-combinare-bicicletta-e-trasporti-pubblici-quotidianamente/) ## 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. Approfondisci nella guida : [Come trovare la fermata di bus o tram più vicina?](https://www.roote.ai/it/guides/come-trovare-la-fermata-piu-vicina-di-bus-o-tram/) ## 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. Approfondisci nella guida : [Come trovare la giusta fermata di autobus e la giusta direzione?](https://www.roote.ai/it/guides/come-trovare-la-giusta-fermata-di-autobus-e-la-giusta-direzione/) ## 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. Approfondisci nella guida : [Come trovare la giusta fermata di autobus e la giusta direzione?](https://www.roote.ai/it/guides/come-trovare-la-giusta-fermata-di-autobus-e-la-giusta-direzione/) ## 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. Approfondisci nella guida : [GTFS, GTFS-RT e GBFS: quali differenze?](https://www.roote.ai/it/guides/gtfs-gtfs-rt-e-gbfs-quali-differenze/) ## 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. Approfondisci nella guida : [Come trovare la giusta fermata di autobus e la giusta direzione?](https://www.roote.ai/it/guides/come-trovare-la-giusta-fermata-di-autobus-e-la-giusta-direzione/) ## Capolinea Estremità di un percorso di trasporto. Una linea può avere varianti con diversi capolinea. Esempio : Un servizio breve termina prima del capolinea abituale. Approfondisci nella guida : [Come trovare la giusta fermata di autobus e la giusta direzione?](https://www.roote.ai/it/guides/come-trovare-la-giusta-fermata-di-autobus-e-la-giusta-direzione/) ## 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. Approfondisci nella guida : [Come leggere una mappa di bus, tram o metro?](https://www.roote.ai/it/guides/come-leggere-una-mappa-dei-bus-tram-o-metro/) ## 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. Approfondisci nella guida : [Orari autobus: quale differenza tra orari teorici e tempo reale?](https://www.roote.ai/it/guides/orari-autobus-quale-differenza-tra-orari-teorici-e-tempo-reale/) ## 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. Approfondisci nella guida : [Orari autobus: quale differenza tra orari teorici e tempo reale?](https://www.roote.ai/it/guides/orari-autobus-quale-differenza-tra-orari-teorici-e-tempo-reale/) ## 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. Approfondisci nella guida : [Come ricercare le fermate di trasporto nelle vicinanze con un API?](https://www.roote.ai/it/guides/come-ricercare-le-fermate-di-trasporto-vicino-con-una-api/) ## 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. Approfondisci nella guida : [Come creare un assistente che trova le mobilità intorno a un indirizzo?](https://www.roote.ai/it/guides/come-creare-un-assistente-che-trova-le-mobilita-intorno-a-un-indirizzo/) ## 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. Approfondisci nella guida : [GTFS, GTFS-RT e GBFS: quali differenze?](https://www.roote.ai/it/guides/gtfs-gtfs-rt-e-gbfs-quali-differenze/) ## 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. Approfondisci nella guida : [Come ricercare le fermate di trasporto nelle vicinanze con un API?](https://www.roote.ai/it/guides/come-ricercare-le-fermate-di-trasporto-vicino-con-una-api/) ## 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. Approfondisci nella guida : [Come trovare bagni pubblici gratuiti intorno a sé?](https://www.roote.ai/it/guides/come-trovare-bagni-pubblici-gratuiti-intorno-a-te/) ## 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. Approfondisci nella guida : [Bagni pubblici accessibili: cosa verificare prima di spostarsi?](https://www.roote.ai/it/guides/bagni-pubblici-accessibili-cosa-verificare-prima-di-spostarsi/) ## 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. Approfondisci nella guida : [Bagni pubblici accessibili: cosa verificare prima di spostarsi?](https://www.roote.ai/it/guides/bagni-pubblici-accessibili-cosa-verificare-prima-di-spostarsi/) ## 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. Approfondisci nella guida : [Come trovare bagni pubblici gratuiti intorno a sé?](https://www.roote.ai/it/guides/come-trovare-bagni-pubblici-gratuiti-intorno-a-te/) ## 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. Approfondisci nella guida : [Come ricercare le fermate di trasporto nelle vicinanze con un API?](https://www.roote.ai/it/guides/come-ricercare-le-fermate-di-trasporto-vicino-con-una-api/) ## 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. Approfondisci nella guida : [Come ricercare le fermate di trasporto nelle vicinanze con un API?](https://www.roote.ai/it/guides/come-ricercare-le-fermate-di-trasporto-vicino-con-una-api/) ## 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. Approfondisci nella guida : [Come ricercare le fermate di trasporto nelle vicinanze con un API?](https://www.roote.ai/it/guides/come-ricercare-le-fermate-di-trasporto-vicino-con-una-api/) ## Geolocalizzazione Ottenzione di posizione geografica da dispositivo o app. Dipende da permessi e precisione disponibili. Esempio : Il tasto localizza richiede autorizzazione browser. Approfondisci nella guida : [Come integrare una mappa di mobilità nel proprio sito?](https://www.roote.ai/it/guides/integrare-una-mappa-di-mobilita-nel-suo-sito/) ## 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. Approfondisci nella guida : [Come ricercare le fermate di trasporto nelle vicinanze con un API?](https://www.roote.ai/it/guides/come-ricercare-le-fermate-di-trasporto-vicino-con-una-api/) ## 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. Approfondisci nella guida : [Come ricercare le fermate di trasporto nelle vicinanze con un API?](https://www.roote.ai/it/guides/come-ricercare-le-fermate-di-trasporto-vicino-con-una-api/) ## 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. Approfondisci nella guida : [Come ricercare le fermate di trasporto nelle vicinanze con un API?](https://www.roote.ai/it/guides/come-ricercare-le-fermate-di-trasporto-vicino-con-una-api/) ## 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. Approfondisci nella guida : [Come creare un assistente che trova le mobilità intorno a un indirizzo?](https://www.roote.ai/it/guides/come-creare-un-assistente-che-trova-le-mobilita-intorno-a-un-indirizzo/) ## 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. Approfondisci nella guida : [Cos’è un server MCP e a cosa serve?](https://www.roote.ai/it/guides/cos-e-un-server-mcp-e-a-cosa-serve/) ## 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. Approfondisci nella guida : [Come creare un assistente che trova le mobilità intorno a un indirizzo?](https://www.roote.ai/it/guides/come-creare-un-assistente-che-trova-le-mobilita-intorno-a-un-indirizzo/) ## 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. Approfondisci nella guida : [Come integrare una mappa di mobilità nel proprio sito?](https://www.roote.ai/it/guides/integrare-una-mappa-di-mobilita-nel-suo-sito/) ## 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. Approfondisci nella guida : [Come ricercare le fermate di trasporto nelle vicinanze con un API?](https://www.roote.ai/it/guides/come-ricercare-le-fermate-di-trasporto-vicino-con-una-api/) ## 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. Approfondisci nella guida : [Come ricercare le fermate di trasporto nelle vicinanze con un API?](https://www.roote.ai/it/guides/come-ricercare-le-fermate-di-trasporto-vicino-con-una-api/) ## Zoom mappa Livello ingrandimento vista mappa. Controlla visualizzazione ma non sostituisce raggio di richiesta API. Esempio : zoom=15 avvicina la vista della mappa. Approfondisci nella guida : [Come integrare una mappa di mobilità nel proprio sito?](https://www.roote.ai/it/guides/integrare-una-mappa-di-mobilita-nel-suo-sito/) ## 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. Approfondisci nella guida : [Orari autobus: quale differenza tra orari teorici e tempo reale?](https://www.roote.ai/it/guides/orari-autobus-quale-differenza-tra-orari-teorici-e-tempo-reale/) ## Osservazione Stato o evento rilevato in momento identificato. Da distinguere da evento previsto o stimato. Esempio : Passaggio effettivo bus può differire da stima. Approfondisci nella guida : [Orari autobus: quale differenza tra orari teorici e tempo reale?](https://www.roote.ai/it/guides/orari-autobus-quale-differenza-tra-orari-teorici-e-tempo-reale/) ## 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. Approfondisci nella guida : [Disponibilità delle bici in tempo reale: come visualizzarla in un'app?](https://www.roote.ai/it/guides/disponibilita-bici-tempo-reale-app/) ## 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. Approfondisci nella guida : [Disponibilità delle bici in tempo reale: come visualizzarla in un'app?](https://www.roote.ai/it/guides/disponibilita-bici-tempo-reale-app/) ## 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. Approfondisci nella guida : [Disponibilità delle bici in tempo reale: come visualizzarla in un'app?](https://www.roote.ai/it/guides/disponibilita-bici-tempo-reale-app/) ## 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. Approfondisci nella guida : [Disponibilità delle bici in tempo reale: come visualizzarla in un'app?](https://www.roote.ai/it/guides/disponibilita-bici-tempo-reale-app/) ## 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. Approfondisci nella guida : [Disponibilità delle bici in tempo reale: come visualizzarla in un'app?](https://www.roote.ai/it/guides/disponibilita-bici-tempo-reale-app/) ## 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. Approfondisci nella guida : [Nessun risultato o errore API: come fare la differenza?](https://www.roote.ai/it/guides/nessun-risultato-o-errore-api-come-fare-la-differenza/) ## Provenienza Informazioni per identificare origine dato e come è stato prodotto secondo contratto. Aiutano a interpretarne portata. Esempio : Un risultato mantiene fonte e contesto raccolta. Approfondisci nella guida : [Come creare un assistente che trova le mobilità intorno a un indirizzo?](https://www.roote.ai/it/guides/come-creare-un-assistente-che-trova-le-mobilita-intorno-a-un-indirizzo/) ## 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. Approfondisci nella guida : [Come ricercare le fermate di trasporto nelle vicinanze con un API?](https://www.roote.ai/it/guides/come-ricercare-le-fermate-di-trasporto-vicino-con-una-api/) ## 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. Approfondisci nella guida : [GTFS, GTFS-RT e GBFS: quali differenze?](https://www.roote.ai/it/guides/gtfs-gtfs-rt-e-gbfs-quali-differenze/) ## 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. Approfondisci nella guida : [GTFS, GTFS-RT e GBFS: quali differenze?](https://www.roote.ai/it/guides/gtfs-gtfs-rt-e-gbfs-quali-differenze/) ## 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. Approfondisci nella guida : [GTFS, GTFS-RT e GBFS: quali differenze?](https://www.roote.ai/it/guides/gtfs-gtfs-rt-e-gbfs-quali-differenze/) ## 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. Approfondisci nella guida : [Nessun risultato o errore API: come fare la differenza?](https://www.roote.ai/it/guides/nessun-risultato-o-errore-api-come-fare-la-differenza/) ## 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. Approfondisci nella guida : [API o MCP: quale scegliere per integrare dati di mobilità?](https://www.roote.ai/it/guides/api-o-mcp-quale-scegliere-per-integrare-dati-mobilita/) ## 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. Approfondisci nella guida : [Come ricercare le fermate di trasporto nelle vicinanze con un API?](https://www.roote.ai/it/guides/come-ricercare-le-fermate-di-trasporto-vicino-con-una-api/) ## 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. Approfondisci nella guida : [Come ricercare le fermate di trasporto nelle vicinanze con un API?](https://www.roote.ai/it/guides/come-ricercare-le-fermate-di-trasporto-vicino-con-una-api/) ## 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. Approfondisci nella guida : [Come integrare una mappa di mobilità nel proprio sito?](https://www.roote.ai/it/guides/integrare-una-mappa-di-mobilita-nel-suo-sito/) ## 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. Approfondisci nella guida : [Nessun risultato o errore API: come fare la differenza?](https://www.roote.ai/it/guides/nessun-risultato-o-errore-api-come-fare-la-differenza/) ## 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. Approfondisci nella guida : [Nessun risultato o errore API: come fare la differenza?](https://www.roote.ai/it/guides/nessun-risultato-o-errore-api-come-fare-la-differenza/) ## 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. Approfondisci nella guida : [Nessun risultato o errore API: come fare la differenza?](https://www.roote.ai/it/guides/nessun-risultato-o-errore-api-come-fare-la-differenza/) ## 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. Approfondisci nella guida : [Nessun risultato o errore API: come fare la differenza?](https://www.roote.ai/it/guides/nessun-risultato-o-errore-api-come-fare-la-differenza/) ## 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. Approfondisci nella guida : [Nessun risultato o errore API: come fare la differenza?](https://www.roote.ai/it/guides/nessun-risultato-o-errore-api-come-fare-la-differenza/) ## 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. Approfondisci nella guida : [Come connettere un assistente IA al MCP ROOTE?](https://www.roote.ai/it/guides/come-connettere-un-assistente-ia-al-mcp-roote/) ## 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. Approfondisci nella guida : [Come ricercare le fermate di trasporto nelle vicinanze con un API?](https://www.roote.ai/it/guides/come-ricercare-le-fermate-di-trasporto-vicino-con-una-api/) ## 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. Approfondisci nella guida : [Come ricercare le fermate di trasporto nelle vicinanze con un API?](https://www.roote.ai/it/guides/come-ricercare-le-fermate-di-trasporto-vicino-con-una-api/) ## 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. Approfondisci nella guida : [Come integrare una mappa di mobilità nel proprio sito?](https://www.roote.ai/it/guides/integrare-una-mappa-di-mobilita-nel-suo-sito/) ## 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. Approfondisci nella guida : [Come integrare una mappa di mobilità nel proprio sito?](https://www.roote.ai/it/guides/integrare-una-mappa-di-mobilita-nel-suo-sito/) ## 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. Approfondisci nella guida : [Cos’è un server MCP e a cosa serve?](https://www.roote.ai/it/guides/cos-e-un-server-mcp-e-a-cosa-serve/) ## Server MCP Programma che espone capacità secondo protocollo MCP. Strumenti annunciati definiscono cosa client può invocare. Esempio : tools/list permette consultare inventario disponibile. Approfondisci nella guida : [Cos’è un server MCP e a cosa serve?](https://www.roote.ai/it/guides/cos-e-un-server-mcp-e-a-cosa-serve/) ## Client MCP Componente app IA che comunica con server MCP. Gestisce scambi protocollo per questa connessione. Esempio : Client invia argomenti ricerca a ROOTE. Approfondisci nella guida : [Cos’è un server MCP e a cosa serve?](https://www.roote.ai/it/guides/cos-e-un-server-mcp-e-a-cosa-serve/) ## 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. Approfondisci nella guida : [Cos’è un server MCP e a cosa serve?](https://www.roote.ai/it/guides/cos-e-un-server-mcp-e-a-cosa-serve/) ## 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. Approfondisci nella guida : [Come connettere un assistente IA al MCP ROOTE?](https://www.roote.ai/it/guides/come-connettere-un-assistente-ia-al-mcp-roote/) ## 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. Approfondisci nella guida : [Come connettere un assistente IA al MCP ROOTE?](https://www.roote.ai/it/guides/come-connettere-un-assistente-ia-al-mcp-roote/) ## 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. Approfondisci nella guida : [Come creare un assistente che trova le mobilità intorno a un indirizzo?](https://www.roote.ai/it/guides/come-creare-un-assistente-che-trova-le-mobilita-intorno-a-un-indirizzo/) ## 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. Approfondisci nella guida : [Come creare un assistente che trova le mobilità intorno a un indirizzo?](https://www.roote.ai/it/guides/come-creare-un-assistente-che-trova-le-mobilita-intorno-a-un-indirizzo/) ## 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. Approfondisci nella guida : [Come creare un assistente che trova le mobilità intorno a un indirizzo?](https://www.roote.ai/it/guides/come-creare-un-assistente-che-trova-le-mobilita-intorno-a-un-indirizzo/) ## 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. Approfondisci nella guida : [Cos’è un server MCP e a cosa serve?](https://www.roote.ai/it/guides/cos-e-un-server-mcp-e-a-cosa-serve/)