# Glosarul mobilității și datelor.

Definiții clare pentru a înțelege transportul, serviciile locale și uneltele care le leagă de aplicațiile tale.

Source: https://www.roote.ai/ro/glosar-mobilitate/
Language: ro
Author: ROOTE

## Bicicletă în regim self-service

Serviciu care permite închirierea temporară a unei biciclete după condițiile operatorului. Poate funcționa cu stații fixe sau fără.

Exemplu : Localizezi o bicicletă și folosești serviciul corespunzător.

Aprofundează în ghid : [Cum să găsești o bicicletă în regim liber în apropierea ta?](https://www.roote.ai/ro/guides/cum-sa-gasesti-o-bicicleta-in-sistem-liber-in-apropierea-ta/)

## Mobilitate partajată

Set de servicii care oferă acces la vehicule utilizate succesiv de mai mulți utilizatori, nu de un singur proprietar.

Exemplu : Biciclete și trotinete disponibile pentru închiriat în oraș.

Aprofundează în ghid : [Cum să găsești o bicicletă în regim liber în apropierea ta?](https://www.roote.ai/ro/guides/cum-sa-gasesti-o-bicicleta-in-sistem-liber-in-apropierea-ta/)

## Stație de legare

Echipament într-o stație unde o bicicletă poate fi ancorată. Prezența nu garantează acceptarea returnării în acel moment.

Exemplu : O loc de returnare trebuie să fie disponibil și utilizabil.

Aprofundează în ghid : [Stație de biciclete goală sau plină: ce faci?](https://www.roote.ai/ro/guides/statie-de-biciclete-goala-sau-plina-ce-faci/)

## Stație de biciclete

Loc organizat pentru luarea sau returnarea bicicletelor partajate. Coordonații, capacitățile și disponibilitatea descriu aspecte distincte ale stației.

Exemplu : O stație poate exista pe hartă, dar să fie temporar goală.

Aprofundează în ghid : [Stație de biciclete goală sau plină: ce faci?](https://www.roote.ai/ro/guides/statie-de-biciclete-goala-sau-plina-ce-faci/)

## Fără stație — free-floating

Organizare în care vehiculele nu trebuie luate sau returnate la o stație fixă. Zonele și regulile de parcare sunt cele ale serviciului.

Exemplu : O trotinetă trebuie returnată într-o zonă permisă.

Aprofundează în ghid : [Bicicletă cu stație sau fără stație: care sunt diferențele?](https://www.roote.ai/ro/guides/bicicleta-cu-statie-sau-fara-statie-care-sunt-diferentele/)

## Disponibilitate

Starea sau cantitatea ce poate fi utilizată conform informațiilor disponibile. Disponibilitatea observată poate varia și nu înseamnă rezervare.

Exemplu : Trei biciclete observate într-o stație nu înseamnă trei rezervări.

Aprofundează în ghid : [Disponibilitatea bicicletelor în timp real: cum să o afișați într-o aplicație?](https://www.roote.ai/ro/guides/disponibilitate-velocipede-timp-real-afisare-aplicatie/)

## Preluarea unui vehicul

Acțiunea de a începe utilizarea unui vehicul. Contorul pozitiv nu este suficient dacă serviciul semnalează că preluarea este dezactivată.

Exemplu : Biciclete prezente, dar închirierea poate fi interzisă.

Aprofundează în ghid : [Disponibilitatea bicicletelor în timp real: cum să o afișați într-o aplicație?](https://www.roote.ai/ro/guides/disponibilitate-velocipede-timp-real-afisare-aplicatie/)

## Returnare

Sfârșitul utilizării unui vehicul conform regulilor serviciului. Posibilitățile de returnare pot diferi de cele de preluare.

Exemplu : O stație permite plecarea dar nu are locuri de returnare.

Aprofundează în ghid : [Stație de biciclete goală sau plină: ce faci?](https://www.roote.ai/ro/guides/statie-de-biciclete-goala-sau-plina-ce-faci/)

## Bicicletă cu asistență electrică

Bicicletă cu motor ce asistă pedalarea conform caracteristicilor sale. În datele de mobilitate, propulsia și bateria pot fi indicate separat.

Exemplu : O stație poate distinge biciclete mecanice de cele electrice.

Aprofundează în ghid : [Disponibilitatea bicicletelor în timp real: cum să o afișați într-o aplicație?](https://www.roote.ai/ro/guides/disponibilitate-velocipede-timp-real-afisare-aplicatie/)

## Intermodalitate

Utilizarea succesivă a mai multor moduri de transport într-o călătorie. Fiecare etapă are propriile orare, acces și condiții.

Exemplu : Folosești bicicleta până la tramvai, apoi continui pe jos.

Aprofundează în ghid : [Cum să combini bicicleta cu transportul public zilnic?](https://www.roote.ai/ro/guides/cum-sa-combini-bicicleta-cu-transportul-public-zilnic/)

## Stație de transport

Loc unde un serviciu de transport preia sau lasă pasageri. O stație fără acoperiș nu oferă neapărat orarele următoarelor sosiri.

Exemplu : O stație de autobuz returnată fără orar de plecare.

Aprofundează în ghid : [Cum să găsești cea mai apropiată stație de autobuz sau tramvai?](https://www.roote.ai/ro/guides/cum-sa-gasesti-cel-mai-apropiat-statie-de-autobuz-sau-tramvai/)

## Peron

Spațiu sau punct de îmbarcare într-un loc de transport. Peroanele apropiate pot deservi direcții sau servicii diferite.

Exemplu : Sensurile unei linii pot avea peron distincte.

Aprofundează în ghid : [Cum să găsești stația corectă de autobuz și direcția potrivită?](https://www.roote.ai/ro/guides/cum-sa-gasesti-statia-corecta-de-autobuz-si-directia-potrivita/)

## Linie

Serviciu identificat într-o rețea, cu un traseu sau variante multiple. Numele liniei nu indică întotdeauna sensul corect.

Exemplu : Aceeași linie poate avea mai multe capete de linie.

Aprofundează în ghid : [Cum să găsești stația corectă de autobuz și direcția potrivită?](https://www.roote.ai/ro/guides/cum-sa-gasesti-statia-corecta-de-autobuz-si-directia-potrivita/)

## Cursa

Executarea unui serviciu de transport asociat unui traseu și opriri. În GTFS, o cursă este legată de o linie și un calendar.

Exemplu : Două plecări successive ale aceleiași linii sunt două curse.

Aprofundează în ghid : [GTFS, GTFS-RT și GBFS: care sunt diferențele?](https://www.roote.ai/ro/guides/gtfs-gtfs-rt-si-gbfs-ce-diferente/)

## Direcție

Indicație a sensului sau destinației unui serviciu. Trebuie verificată cu traseul și punctul de plecare.

Exemplu : Cauți tramvaiul spre destinația ta, nu în sens invers.

Aprofundează în ghid : [Cum să găsești stația corectă de autobuz și direcția potrivită?](https://www.roote.ai/ro/guides/cum-sa-gasesti-statia-corecta-de-autobuz-si-directia-potrivita/)

## Capăt de linie

Sfârșitul unui traseu. O linie poate avea variante cu capete diferite.

Exemplu : O cursă scurtă se termină înainte de capătul obișnuit.

Aprofundează în ghid : [Cum să găsești stația corectă de autobuz și direcția potrivită?](https://www.roote.ai/ro/guides/cum-sa-gasesti-statia-corecta-de-autobuz-si-directia-potrivita/)

## Schimbare

Trecerea de la un serviciu sau mod la altul în timpul unei călătorii. Apropierea a două stații nu garantează posibilitatea schimbului.

Exemplu : Trebuie prevăzută deplasarea între peroane și timpul de așteptare.

Aprofundează în ghid : [Cum să citești o hartă de autobuz, tramvai sau metrou?](https://www.roote.ai/ro/guides/cum-sa-citesti-un-harta-de-autobuz-tramvai-sau-metro/)

## Orar teoretic

Ora planificată conform planului de servicii pentru o dată și oprire date. Nu reflectă neapărat situația curentă a vehiculului.

Exemplu : Plecare programată la 8:10 în calendar.

Aprofundează în ghid : [Orarul autobuzelor: care este diferența dintre orarele teoretice și cele în timp real?](https://www.roote.ai/ro/guides/orarul-autobuzelor-diferenta-intre-orare-teoretice-si-timp-real/)

## Orar estimat

Previziune a unei opriri viitoare calculată din datele disponibile. Poate fi ajustată la sosirea unor noi informații.

Exemplu : O oprire preconizată la 8:10 este acum estimată la 8:14.

Aprofundează în ghid : [Orarul autobuzelor: care este diferența dintre orarele teoretice și cele în timp real?](https://www.roote.ai/ro/guides/orarul-autobuzelor-diferenta-intre-orare-teoretice-si-timp-real/)

## Următoarea plecare

Trecere sau plecare viitoare returnată pentru un loc și serviciu. Găsirea unei stații nu este o căutare a plecărilor sale.

Exemplu : Lista de stații și lista de plecări sunt două rezultate diferite.

Aprofundează în ghid : [Cum să cauți stațiile de transport în apropiere folosind o API?](https://www.roote.ai/ro/guides/cum-sa-cauti-statiile-de-transport-apropiate-cu-o-api/)

## Perturbare

Eveniment care afectează un serviciu de transport, precum întreruperea sau modificarea traseului. Efectele trebuie citite în perimetrul și intervalul indicate.

Exemplu : Alertă valabilă doar pentru o linie și anumite ore.

Aprofundează în ghid : [Cum să creezi un asistent care găsește mobilități în jurul unei adrese?](https://www.roote.ai/ro/guides/cum-sa-creezi-un-asistent-pentru-mobilitati-in-jurul-unei-adrese/)

## Calendar de servicii

Informații despre zilele în care un serviciu funcționează, cu excepții posibile. Orarele trebuie interpretate cu calendarul.

Exemplu : O oprire în timpul săptămânii poate lipsi duminica.

Aprofundează în ghid : [GTFS, GTFS-RT și GBFS: care sunt diferențele?](https://www.roote.ai/ro/guides/gtfs-gtfs-rt-si-gbfs-ce-diferente/)

## Serviciu urban

Echipament sau serviciu util lângă un loc, e.g. toalete, punct de apă sau stație de încărcare. Atributele pot fi incomplete.

Exemplu : Un rezultat local descrie serviciul și informațiile cunoscute.

Aprofundează în ghid : [Cum să cauți stațiile de transport în apropiere folosind o API?](https://www.roote.ai/ro/guides/cum-sa-cauti-statiile-de-transport-apropiate-cu-o-api/)

## Toalete publice

Toalete destinate uzului public conform condițiilor locale. Prezența în date nu garantează gratuitate, accesibilitate sau deschidere.

Exemplu : Verifică condițiile indicate înainte de a te deplasa.

Aprofundează în ghid : [Cum să găsești toalete publice gratuite în apropiere?](https://www.roote.ai/ro/guides/cum-sa-gasesti-toalete-publice-gratuite-in-apropiere/)

## Accesibilitate

Caracteristici care permit utilizarea unui loc sau serviciu conform nevoilor persoanei. Lipsa datelor nu înseamnă accesibil sau inaccesibil.

Exemplu : Accesul pentru scaun cu rotile poate fi cunoscut sau necunoscut.

Aprofundează în ghid : [Toalete publice accesibile: ce să verificați înainte de a vă deplasa?](https://www.roote.ai/ro/guides/toalete-publice-accesibile-ce-trebuie-verificat-inainte-de-deplasare/)

## Persoană cu mobilitate redusă — PMR

Persoană cu dificultăți de deplasare, temporar sau permanent. Mențiunea PMR nu detaliază toate accesurile și echipamentele necesare.

Exemplu : Prezența unei rampe nu exclude alte obstacole.

Aprofundează în ghid : [Toalete publice accesibile: ce să verificați înainte de a vă deplasa?](https://www.roote.ai/ro/guides/toalete-publice-accesibile-ce-trebuie-verificat-inainte-de-deplasare/)

## Ore de funcționare

Intervale în care un loc anunță că este deschis. Nu confirmă în timp real disponibilitatea.

Exemplu : O închidere temporară poate să nu fie reflectată în programul obișnuit.

Aprofundează în ghid : [Cum să găsești toalete publice gratuite în apropiere?](https://www.roote.ai/ro/guides/cum-sa-gasesti-toalete-publice-gratuite-in-apropiere/)

## Apă potabilă

Apă indicată ca potrivită pentru consum uman. Un punct de apă sau fântână nu este potabilă fără informație explicită.

Exemplu : Tipul echipamentului și atributele sale trebuie diferențiate.

Aprofundează în ghid : [Cum să cauți stațiile de transport în apropiere folosind o API?](https://www.roote.ai/ro/guides/cum-sa-cauti-statiile-de-transport-apropiate-cu-o-api/)

## Stație de încărcare

Echipament pentru reîncărcarea vehiculului compatibil. Localizarea nu garantează disponibilitate sau compatibilitate conector.

Exemplu : Locația și starea de funcționare sunt informații separate.

Aprofundează în ghid : [Cum să cauți stațiile de transport în apropiere folosind o API?](https://www.roote.ai/ro/guides/cum-sa-cauti-statiile-de-transport-apropiate-cu-o-api/)

## Tipul serviciului

Categorie folosită pentru selectarea sau descrierea unui serviciu urban. Valorile acceptate depind de interfață și schemă.

Exemplu : API-ul ROOTE folosește types=toilets pentru toalete.

Aprofundează în ghid : [Cum să cauți stațiile de transport în apropiere folosind o API?](https://www.roote.ai/ro/guides/cum-sa-cauti-statiile-de-transport-apropiate-cu-o-api/)

## Geolocalizare

Obținerea poziției geografice printr-un dispozitiv sau aplicație. Depinde de permisiuni și acuratețea disponibilă.

Exemplu : Butonul de localizare solicită acordul browserului.

Aprofundează în ghid : [Cum să integrezi o hartă de mobilitate în site-ul tău?](https://www.roote.ai/ro/guides/cum-sa-integrezi-o-harta-de-mobilitate-pe-site-ul-tau/)

## Coordonate GPS

Valori ce reprezintă un punct geografic, de obicei latitudine și longitudine. Ordinea trebuie specificată în interfață.

Exemplu : O căutare de proximitate primește două coordonate distincte.

Aprofundează în ghid : [Cum să cauți stațiile de transport în apropiere folosind o API?](https://www.roote.ai/ro/guides/cum-sa-cauti-statiile-de-transport-apropiate-cu-o-api/)

## Latitudine

Coordonata nord-sud față de ecuator, exprimată în grade în exemplele ROOTE. Valori între −90 și 90.

Exemplu : Latitudinea punctului de căutare este transmisă în lat.

Aprofundează în ghid : [Cum să cauți stațiile de transport în apropiere folosind o API?](https://www.roote.ai/ro/guides/cum-sa-cauti-statiile-de-transport-apropiate-cu-o-api/)

## Longitudine

Coordonata est-vest față de meridianul de referință, în grade între −180 și 180 în exemplele ROOTE.

Exemplu : Longitudinea poate fi transmisă în lon sau aliasul documentat lng.

Aprofundează în ghid : [Cum să cauți stațiile de transport în apropiere folosind o API?](https://www.roote.ai/ro/guides/cum-sa-cauti-statiile-de-transport-apropiate-cu-o-api/)

## Geocodare

Căutare ce transformă o adresă sau expresie geografică în candidați cu coordonate. Mai multe locuri pot corespunde aceleiași intrări.

Exemplu : Două orașe au străzi cu același nume.

Aprofundează în ghid : [Cum să creezi un asistent care găsește mobilități în jurul unei adrese?](https://www.roote.ai/ro/guides/cum-sa-creezi-un-asistent-pentru-mobilitati-in-jurul-unei-adrese/)

## Geocodare inversă

Căutarea de locuri sau denumiri din coordonate. Rezultatul poate reprezenta un loc apropiat, nu o adresă exactă garantată.

Exemplu : Un punct GPS este asociat unei etichete lizibile.

Aprofundează în ghid : [Ce este un server MCP și la ce folosește?](https://www.roote.ai/ro/guides/ce-este-un-server-mcp-si-la-ce-este-util/)

## Punct de interes — POI

Loc identificabil, util căutării, precum o unitate sau echipament. POI se deosebește de o simplă adresă poștală.

Exemplu : Numele unui hotel poate fi căutat ca unitate.

Aprofundează în ghid : [Cum să creezi un asistent care găsește mobilități în jurul unei adrese?](https://www.roote.ai/ro/guides/cum-sa-creezi-un-asistent-pentru-mobilitati-in-jurul-unei-adrese/)

## Punct de plecare căutare

Punct de referință pentru o căutare de proximitate și calculare distanțe. Poate fi diferit de centrul afișat pe hartă.

Exemplu : Camera se mută, dar căutarea rămâne centrată pe Bordeaux.

Aprofundează în ghid : [Cum să integrezi o hartă de mobilitate în site-ul tău?](https://www.roote.ai/ro/guides/cum-sa-integrezi-o-harta-de-mobilitate-pe-site-ul-tau/)

## Rază căutare

Distanță în jurul punctului de origine care delimitează căutarea. Unitățile și limitele depind de contractul rutei sau al uneltei.

Exemplu : radius=600 solicită o rază de 600 metri în exemplul REST.

Aprofundează în ghid : [Cum să cauți stațiile de transport în apropiere folosind o API?](https://www.roote.ai/ro/guides/cum-sa-cauti-statiile-de-transport-apropiate-cu-o-api/)

## Distanță geografică

Distanță calculată între poziții conform metodei serviciului. Nu este automat distanță de itinerar sau timp de mers.

Exemplu : Locul apropiat poate necesita un ocol pentru acces.

Aprofundează în ghid : [Cum să cauți stațiile de transport în apropiere folosind o API?](https://www.roote.ai/ro/guides/cum-sa-cauti-statiile-de-transport-apropiate-cu-o-api/)

## Zoom hartă

Nivel de mărire al hărții afișate. Controlează vizibilitatea și nu înlocuiește raza cererii API.

Exemplu : zoom=15 apropie vederea asupra hărții.

Aprofundează în ghid : [Cum să integrezi o hartă de mobilitate în site-ul tău?](https://www.roote.ai/ro/guides/cum-sa-integrezi-o-harta-de-mobilitate-pe-site-ul-tau/)

## Date în timp real

Informații actualizate pentru a reprezenta o situație recentă sau a alimenta o estimare. Prospețimea trebuie evaluată; timp real nu înseamnă instant sau garantat.

Exemplu : O estimare a sosirii este recalculată din date recente.

Aprofundează în ghid : [Orarul autobuzelor: care este diferența dintre orarele teoretice și cele în timp real?](https://www.roote.ai/ro/guides/orarul-autobuzelor-diferenta-intre-orare-teoretice-si-timp-real/)

## Observație

Stare sau eveniment observat la un moment specific. Trebuie diferențiat de evenimente planificate sau estimate.

Exemplu : Trecerea reală a unui autobuz poate fi diferită de estimare.

Aprofundează în ghid : [Orarul autobuzelor: care este diferența dintre orarele teoretice și cele în timp real?](https://www.roote.ai/ro/guides/orarul-autobuzelor-diferenta-intre-orare-teoretice-si-timp-real/)

## Prospețimea datelor

Calificarea actualității unei informații, în funcție de datele sale și regulile contractului. Ora consultării nu garantează prospețimea sursei.

Exemplu : Un contor primit acum poate proveni dintr-o observație veche.

Aprofundează în ghid : [Disponibilitatea bicicletelor în timp real: cum să o afișați într-o aplicație?](https://www.roote.ai/ro/guides/disponibilitate-velocipede-timp-real-afisare-aplicatie/)

## Marcaj temporal

Indicație de timp asociată unei date sau eveniment. Sensul depinde de câmp: observație, actualizare, primire sau expirare.

Exemplu : source_updated_at și received_at descriu etape diferite.

Aprofundează în ghid : [Disponibilitatea bicicletelor în timp real: cum să o afișați într-o aplicație?](https://www.roote.ai/ro/guides/disponibilitate-velocipede-timp-real-afisare-aplicatie/)

## Dată expirată — stale

Informație considerată prea veche conform contractului sau politicii de valabilitate. Poate fi păstrată ca istoric recent, nu ca proaspătă.

Exemplu : Interfața indică că disponibilitatea trebuie actualizată.

Aprofundează în ghid : [Disponibilitatea bicicletelor în timp real: cum să o afișați într-o aplicație?](https://www.roote.ai/ro/guides/disponibilitate-velocipede-timp-real-afisare-aplicatie/)

## Durata valabilității — TTL

Durată folosită pentru a gestiona valabilitatea sau reîmprospătarea unei date în cache, conform contractului. Nu certifică ora observației sursă.

Exemplu : Un cache expirat trebuie reîmprospătat conform politicii stabilite.

Aprofundează în ghid : [Disponibilitatea bicicletelor în timp real: cum să o afișați într-o aplicație?](https://www.roote.ai/ro/guides/disponibilitate-velocipede-timp-real-afisare-aplicatie/)

## Cache

Stocare temporară a rezultatelor pentru a evita căutări identice repetate. Valoarea din cache păstrează originea și contextul temporal.

Exemplu : Două cereri identice pot folosi un răspuns încă valid.

Aprofundează în ghid : [Disponibilitatea bicicletelor în timp real: cum să o afișați într-o aplicație?](https://www.roote.ai/ro/guides/disponibilitate-velocipede-timp-real-afisare-aplicatie/)

## Acoperire

Perimetru și grad de completitudine a informațiilor disponibile pentru o căutare sau sursă. Acoperirea parțială limitează concluziile posibile.

Exemplu : O listă utilă nu reprezintă toate serviciile existente.

Aprofundează în ghid : [Fără rezultate sau eroare API: cum să faci diferența?](https://www.roote.ai/ro/guides/fara-rezultate-sau-eroare-api-cum-sa-faci-diferenta/)

## Proveniență

Informații care identifică originea datelor și, conform contractului, modul de producere. Ajută la interpretarea valorii.

Exemplu : Un rezultat păstrează sursa și contextul colectării.

Aprofundează în ghid : [Cum să creezi un asistent care găsește mobilități în jurul unei adrese?](https://www.roote.ai/ro/guides/cum-sa-creezi-un-asistent-pentru-mobilitati-in-jurul-unei-adrese/)

## Atribuire

Mențiunea furnizorului sau sursei asociate datelor. Dacă este cerută, experiența care folosește rezultatul trebuie să o afișeze.

Exemplu : O atribuire required=true trebuie păstrată în interfață.

Aprofundează în ghid : [Cum să cauți stațiile de transport în apropiere folosind o API?](https://www.roote.ai/ro/guides/cum-sa-cauti-statiile-de-transport-apropiate-cu-o-api/)

## GTFS Schedule

Format standard pentru descrierea ofertei de transport planificate: stații, linii, curse, calendare și sosiri. Nu oferă automat actualizări în timp real.

Exemplu : Treceri planificate legate de curse și zilele serviciului.

Aprofundează în ghid : [GTFS, GTFS-RT și GBFS: care sunt diferențele?](https://www.roote.ai/ro/guides/gtfs-gtfs-rt-si-gbfs-ce-diferente/)

## GTFS Realtime — GTFS-RT

Format standard pentru transmiterea actualizărilor de curse, poziții vehicule și alerte. Categoriile difuzate depind de producător.

Exemplu : Un flux de poziții nu garantează estimări pentru toate opririle.

Aprofundează în ghid : [GTFS, GTFS-RT și GBFS: care sunt diferențele?](https://www.roote.ai/ro/guides/gtfs-gtfs-rt-si-gbfs-ce-diferente/)

## GBFS

Format standard de date publice pentru mobilitate partajată. În funcție de versiune și fluxuri, descrie sistemele, stațiile, vehiculele și stările lor.

Exemplu : Informațiile de stații și contoarele de disponibilitate sunt separate.

Aprofundează în ghid : [GTFS, GTFS-RT și GBFS: care sunt diferențele?](https://www.roote.ai/ro/guides/gtfs-gtfs-rt-si-gbfs-ce-diferente/)

## Valoare necunoscută — null

Lipsa unei valori cunoscute conform unui contract care folosește null pentru acest sens. Nu trebuie înlocuit cu zero, fals sau demonstrație de absență.

Exemplu : Un contor biciclete null nu indică o stație goală.

Aprofundează în ghid : [Fără rezultate sau eroare API: cum să faci diferența?](https://www.roote.ai/ro/guides/fara-rezultate-sau-eroare-api-cum-sa-faci-diferenta/)

## API

Interfață ce permite unui program să folosească capacitățile altui serviciu printr-un contract definit, precizând intrările și răspunsurile așteptate.

Exemplu : O aplicație caută stații cu API-ul ROOTE.

Aprofundează în ghid : [API sau MCP: pe care să-l alegi pentru integrarea datelor de mobilitate?](https://www.roote.ai/ro/guides/api-sau-mcp-pe-care-saelege-pentru-integrarea-datelor-de-mobilitate/)

## API REST

Interfață HTTP utilizând resurse și mecanisme web. Contractul API specifică rutele, metodele și reprezentările.

Exemplu : O căutare este trimisă prin ruta GET documentată.

Aprofundează în ghid : [Cum să cauți stațiile de transport în apropiere folosind o API?](https://www.roote.ai/ro/guides/cum-sa-cauti-statiile-de-transport-apropiate-cu-o-api/)

## Endpoint — ruta API

Adresă și operațiune expusă de API pentru o capacitate. Rute diferite pot oferi familii diferite de rezultate.

Exemplu : /v1/transit/nearby caută locuri de transport.

Aprofundează în ghid : [Cum să cauți stațiile de transport în apropiere folosind o API?](https://www.roote.ai/ro/guides/cum-sa-cauti-statiile-de-transport-apropiate-cu-o-api/)

## Parametru de cerere

Valoare transmisă în partea URL după semnul întrebării. Numele și formatul sunt definite de interfața utilizată.

Exemplu : modes=bus,tram selectează moduri într-un URL compatibil.

Aprofundează în ghid : [Cum să integrezi o hartă de mobilitate în site-ul tău?](https://www.roote.ai/ro/guides/cum-sa-integrezi-o-harta-de-mobilitate-pe-site-ul-tau/)

## Stare HTTP

Cod ce indică rezultatul cererii la nivel HTTP. Trebuie completat cu validarea conținutului și a stării funcționale.

Exemplu : HTTP 200 poate conține un status de eroare la nivel aplicație.

Aprofundează în ghid : [Fără rezultate sau eroare API: cum să faci diferența?](https://www.roote.ai/ro/guides/fara-rezultate-sau-eroare-api-cum-sa-faci-diferenta/)

## Rezultat gol — empty

Căutare fără entități în perimetrul consultat. Nu indică neapărat lipsa serviciilor în afara datelor disponibile.

Exemplu : Nici o stație returnată cu filtrele setate.

Aprofundează în ghid : [Fără rezultate sau eroare API: cum să faci diferența?](https://www.roote.ai/ro/guides/fara-rezultate-sau-eroare-api-cum-sa-faci-diferenta/)

## Răspuns parțial — partial

Rezultat cu informații utilizabile dar cu limite sau lipsuri semnalate. Trebuie însoțit de avertismentele relevante.

Exemplu : O sursă răspunde, alta nu este disponibilă.

Aprofundează în ghid : [Fără rezultate sau eroare API: cum să faci diferența?](https://www.roote.ai/ro/guides/fara-rezultate-sau-eroare-api-cum-sa-faci-diferenta/)

## Timp expirat — timeout

Întreruperea unei așteptări ce depășește un prag temporar pentru o operațiune. Arată o căutare nefinalizată, nu lipsa rezultatelor.

Exemplu : Aplicația recomandă reîncercarea în loc să afișeze o listă goală.

Aprofundează în ghid : [Fără rezultate sau eroare API: cum să faci diferența?](https://www.roote.ai/ro/guides/fara-rezultate-sau-eroare-api-cum-sa-faci-diferenta/)

## Limită de frecvență — rate limit

Restricție privind rata cererilor permise de un serviciu. Regulile și metodele de reluare depind de contractul activ.

Exemplu : Cod 429 cere respectarea indicațiilor de reluare.

Aprofundează în ghid : [Fără rezultate sau eroare API: cum să faci diferența?](https://www.roote.ai/ro/guides/fara-rezultate-sau-eroare-api-cum-sa-faci-diferenta/)

## Jeton Bearer

Identificator de acces transmis în antetul Authorization conform mecanismului. Trebuie păstrat în configurare securizată.

Exemplu : Authorization: Bearer folosit fără a publica tokenul în URL.

Aprofundează în ghid : [Cum să conectezi un asistent IA la MCP ROOTE?](https://www.roote.ai/ro/guides/cum-sa-conectezi-un-asistent-ai-la-mcp-roote/)

## JSON

Format textual structurat ce folosește obiecte, array-uri, șiruri și numere. Un JSON valid sintactic poate să nu respecte schema API.

Exemplu : O colecție de stații trebuie să aibă tipul și câmpurile așteptate.

Aprofundează în ghid : [Cum să cauți stațiile de transport în apropiere folosind o API?](https://www.roote.ai/ro/guides/cum-sa-cauti-statiile-de-transport-apropiate-cu-o-api/)

## OpenAPI

Specificație care descrie contractul unei API HTTP într-un document structurat. Ajută la verificarea rutelor, parametrilor, răspunsurilor și schemelor.

Exemplu : Contractul ROOTE este publicat în openapi.json.

Aprofundează în ghid : [Cum să cauți stațiile de transport în apropiere folosind o API?](https://www.roote.ai/ro/guides/cum-sa-cauti-statiile-de-transport-apropiate-cu-o-api/)

## Embed — hartă integrată

Inserarea unei experiențe externe într-o pagină, de ex. o hartă într-un iframe. Parametrii și permisiunile determină contextul de utilizare.

Exemplu : Un iframe ROOTE afișează bicicletele din jurul Bordeaux.

Aprofundează în ghid : [Cum să integrezi o hartă de mobilitate în site-ul tău?](https://www.roote.ai/ro/guides/cum-sa-integrezi-o-harta-de-mobilitate-pe-site-ul-tau/)

## Iframe

Element HTML care încarcă un document într-o pagină. Pe domenii diferite, pagina părinte nu poate accesa liber conținutul intern.

Exemplu : Schimbările de căutare necesită un schimb documentat cu pagina părinte.

Aprofundează în ghid : [Cum să integrezi o hartă de mobilitate în site-ul tău?](https://www.roote.ai/ro/guides/cum-sa-integrezi-o-harta-de-mobilitate-pe-site-ul-tau/)

## MCP — Model Context Protocol

Protocol pentru ca o aplicație IA să comunice cu servere ce expun unelte sau contexte. Nu garantează singur calitatea datelor returnate.

Exemplu : Un asistent descoperă uneltele de căutare ROOTE.

Aprofundează în ghid : [Ce este un server MCP și la ce folosește?](https://www.roote.ai/ro/guides/ce-este-un-server-mcp-si-la-ce-este-util/)

## Server MCP

Program care expune capabilități conform protocolului MCP. Uneltele anunțate de server definesc ce poate apela clientul.

Exemplu : tools/list arată inventarul disponibil.

Aprofundează în ghid : [Ce este un server MCP și la ce folosește?](https://www.roote.ai/ro/guides/ce-este-un-server-mcp-si-la-ce-este-util/)

## Client MCP

Componentă a aplicației IA ce comunică cu un server MCP. Gestionează schimburile protocolului pentru conexiunea respectivă.

Exemplu : Clientul trimite argumentele unei căutări către ROOTE.

Aprofundează în ghid : [Ce este un server MCP și la ce folosește?](https://www.roote.ai/ro/guides/ce-este-un-server-mcp-si-la-ce-este-util/)

## Aplicație gazdă MCP

Aplicație care găzduiește interacțiunea cu utilizatorul și gestionează unul sau mai mulți clienți MCP. Rămâne responsabilă de folosirea rezultatelor în experiența sa.

Exemplu : Aplicația ta conversțională conectează un server ROOTE.

Aprofundează în ghid : [Ce este un server MCP și la ce folosește?](https://www.roote.ai/ro/guides/ce-este-un-server-mcp-si-la-ce-este-util/)

## Unealtă MCP

Capacitate executabilă descrisă prin nume, funcție și schema de argumente. Asistentul trebuie să folosească intrările acceptate.

Exemplu : geocode primește o adresă; transit_nearby primește coordonate.

Aprofundează în ghid : [Cum să conectezi un asistent IA la MCP ROOTE?](https://www.roote.ai/ro/guides/cum-sa-conectezi-un-asistent-ai-la-mcp-roote/)

## Streamable HTTP

Transport MCP pentru comunicare cu un server la distanță prin HTTP. Compatibilitatea trebuie verificată în clientul folosit.

Exemplu : Serverul ROOTE folosește https://mcp.roote.ai/mcp.

Aprofundează în ghid : [Cum să conectezi un asistent IA la MCP ROOTE?](https://www.roote.ai/ro/guides/cum-sa-conectezi-un-asistent-ai-la-mcp-roote/)

## Răspuns bazat pe date — grounding

Generarea unui răspuns pornind de la informații efectiv obținute sau furnizate. Câmpurile lipsă și limitările trebuie să rămână vizibile.

Exemplu : Asistentul folosește locurile returnate fără a inventa ore.

Aprofundează în ghid : [Cum să creezi un asistent care găsește mobilități în jurul unei adrese?](https://www.roote.ai/ro/guides/cum-sa-creezi-un-asistent-pentru-mobilitati-in-jurul-unei-adrese/)

## Halucinație a unui asistent IA

Generarea de informații nefundamentate, prezentate ca și cunoscute. În mobilitate, poate fi un orar sau disponibilitate inventate.

Exemplu : Asistentul anunță o oprire, dar s-a primit doar o stație.

Aprofundează în ghid : [Cum să creezi un asistent care găsește mobilități în jurul unei adrese?](https://www.roote.ai/ro/guides/cum-sa-creezi-un-asistent-pentru-mobilitati-in-jurul-unei-adrese/)

## Injecție de prompt

Tentativă de a folosi conținut extern pentru a modifica instrucțiunile unui asistent. Descrierile furnizorilor trebuie să fie date, nu comenzi.

Exemplu : Instrucțiune ascunsă în numele unui loc nu trebuie executată.

Aprofundează în ghid : [Cum să creezi un asistent care găsește mobilități în jurul unei adrese?](https://www.roote.ai/ro/guides/cum-sa-creezi-un-asistent-pentru-mobilitati-in-jurul-unei-adrese/)

## Doar citire

Capacitatea de consultare fără modificare prevăzută de unealtă. Verificarea disponibilității nu rezervă, nu deblochează și nu închiriază un vehicul.

Exemplu : Uneltele ROOTE Data servesc la consultarea informațiilor.

Aprofundează în ghid : [Ce este un server MCP și la ce folosește?](https://www.roote.ai/ro/guides/ce-este-un-server-mcp-si-la-ce-este-util/)