# Słownik mobilności i danych.

Proste definicje, by pojąć transport, usługi lokalne i narzędzia łączące je z twoimi aplikacjami.

Source: https://www.roote.ai/pl/slownik-mobilnosci/
Language: pl
Author: ROOTE

## Rowery na minuty

Usługa umożliwiająca krótkoterminowe korzystanie z roweru zgodnie z warunkami operatora. Może działać ze stacjami lub bez nich.

Przykład : Zlokalizuj rower i skorzystaj z odpowiedniej wypożyczalni.

Zgłęb w przewodniku : [Jak znaleźć rower na minuty w swojej okolicy?](https://www.roote.ai/pl/guides/jak-znalezc-rower-wolnej-jazdy-w-swojej-okolicy/)

## Mobilność współdzielona

Usługi udostępniające pojazdy wykorzystywane kolejno przez wielu użytkowników zamiast prywatnego pojazdu przypisanego do jednej osoby.

Przykład : Rowery i hulajnogi do wynajęcia w mieście.

Zgłęb w przewodniku : [Jak znaleźć rower na minuty w swojej okolicy?](https://www.roote.ai/pl/guides/jak-znalezc-rower-wolnej-jazdy-w-swojej-okolicy/)

## Stojak do przypięcia

Element stacji, do którego można przypiąć rower. Obecność stojaka nie gwarantuje, że w danym momencie można tam odstawić rower.

Przykład : Miejsce na zwrot musi być dostępne i możliwe do użycia.

Zgłęb w przewodniku : [Pusta lub pełna stacja rowerowa: co robić?](https://www.roote.ai/pl/guides/pusta-lub-pelna-stacja-rowerowa-co-robic-zrodlowa-roote/)

## Stacja rowerowa

Miejsce zorganizowane do wypożyczania i oddawania rowerów współdzielonych. Współrzędne, pojemności i dostępność opisują różne aspekty stacji.

Przykład : Stacja może być widoczna na mapie, ale tymczasowo pusta.

Zgłęb w przewodniku : [Pusta lub pełna stacja rowerowa: co robić?](https://www.roote.ai/pl/guides/pusta-lub-pelna-stacja-rowerowa-co-robic-zrodlowa-roote/)

## System bezstacyjny — free-floating

Model, w którym pojazdy nie muszą być pobierane i zwracane do stałego stojaka. Obowiązują strefy i zasady parkowania usługi.

Przykład : Hulajnogę trzeba zwrócić w dozwolonej strefie.

Zgłęb w przewodniku : [Rower ze stacji czy bez stacji: jakie są różnice?](https://www.roote.ai/pl/guides/rower-z-stacji-czy-bez-stacji-jakie-roznice/)

## Dostępność

Stan lub liczba pojazdów gotowych do użycia według znanych informacji. Obserwowana dostępność może się zmieniać i nie jest rezerwacją.

Przykład : Trzy rowery widoczne na stacji to nie znaczy, że są zarezerwowane.

Zgłęb w przewodniku : [Dostępność rowerów na żywo: jak ją wyświetlić w aplikacji?](https://www.roote.ai/pl/guides/dostepnosc-rowerow-na-zywo-jak-wyswietlic-w-aplikacji/)

## Pobrane pojazdu

Rozpoczęcie korzystania z pojazdu. Licznik dodatni nie zawsze oznacza, że można go wypożyczyć, jeśli usługa wskazuje inaczej.

Przykład : Rowery są obecne, ale wypożyczenie może być zablokowane.

Zgłęb w przewodniku : [Dostępność rowerów na żywo: jak ją wyświetlić w aplikacji?](https://www.roote.ai/pl/guides/dostepnosc-rowerow-na-zywo-jak-wyswietlic-w-aplikacji/)

## Zwrot pojazdu

Zakończenie korzystania z pojazdu zgodnie z zasadami usługi. Warunki zwrotu mogą różnić się od warunków wypożyczenia.

Przykład : Stacja pozwala wypożyczyć rower, ale nie ma miejsc do zwrotu.

Zgłęb w przewodniku : [Pusta lub pełna stacja rowerowa: co robić?](https://www.roote.ai/pl/guides/pusta-lub-pelna-stacja-rowerowa-co-robic-zrodlowa-roote/)

## Rower elektryczny wspomagany

Rower z silnikiem wspomagającym pedałowanie według określonych parametrów. W danych mobilności podaje się zwykle rodzaj napędu i baterię osobno.

Przykład : Stacja może rozróżniać rowery mechaniczne i elektryczne.

Zgłęb w przewodniku : [Dostępność rowerów na żywo: jak ją wyświetlić w aplikacji?](https://www.roote.ai/pl/guides/dostepnosc-rowerow-na-zywo-jak-wyswietlic-w-aplikacji/)

## Intermodalność

Kolejne korzystanie z różnych środków transportu podczas jednej podróży. Każdy etap ma własne rozkłady, dostęp i warunki.

Przykład : Najpierw jedziesz rowerem do tramwaju, potem idziesz na piechotę.

Zgłęb w przewodniku : [Jak połączyć rower i komunikację miejską na co dzień?](https://www.roote.ai/pl/guides/jak-polaczyc-rower-i-komunikacje-miejska-na-co-dzien/)

## Przystanek transportu

Miejsce, gdzie transport zabiera lub wysadza pasażerów. Przystanek bez rozkładu nie pokazuje automatycznie kolejnych odjazdów.

Przykład : Przystanek autobusowy bez godziny odjazdu zwrócony jako wynik.

Zgłęb w przewodniku : [Jak znaleźć najbliższy przystanek autobusowy lub tramwajowy?](https://www.roote.ai/pl/guides/jak-znalezc-najblizszy-przystanek-autobusowy-lub-tramwajowy/)

## Peron

Miejsce lub punkt węzła transportowego do wsiadania. Kilka bliskich peronów może obsługiwać różne kierunki lub usługi.

Przykład : Oba kierunki linii mogą korzystać z osobnych peronów.

Zgłęb w przewodniku : [Jak znaleźć właściwy przystanek autobusowy i właściwy kierunek?](https://www.roote.ai/pl/guides/jak-znalezc-wlasciwy-przystanek-autobusowy-i-wlasciwy-kierunek/)

## Linia

Usługa transportowa wyróżniona w sieci, z jedno- lub wieloma wariantami tras. Sama nazwa nie określa kierunku jazdy.

Przykład : Linia może mieć różne końcowe przystanki.

Zgłęb w przewodniku : [Jak znaleźć właściwy przystanek autobusowy i właściwy kierunek?](https://www.roote.ai/pl/guides/jak-znalezc-wlasciwy-przystanek-autobusowy-i-wlasciwy-kierunek/)

## Kurs

Wykonanie kursu transportowego przypisanego do trasy i rozkładu. W GTFS kurs łączy się z linią i kalendarzem usług.

Przykład : Dwa kolejne odjazdy tej samej linii to dwa kursy.

Zgłęb w przewodniku : [GTFS, GTFS-RT i GBFS: jakie są różnice?](https://www.roote.ai/pl/guides/gtfs-gtfs-rt-i-gbfs-jakie-sa-roznice/)

## Kierunek

Wskazanie sensu lub celu kursu. Należy zweryfikować go z trasą i miejscem wsiadania.

Przykład : Szukasz tramwaju do celu, nie w przeciwnym kierunku.

Zgłęb w przewodniku : [Jak znaleźć właściwy przystanek autobusowy i właściwy kierunek?](https://www.roote.ai/pl/guides/jak-znalezc-wlasciwy-przystanek-autobusowy-i-wlasciwy-kierunek/)

## Pętla

Końcowy punkt trasy transportu. Linia może mieć różne warianty z różnymi pętlami.

Przykład : Krótszy kurs kończy się przed standardową pętlą.

Zgłęb w przewodniku : [Jak znaleźć właściwy przystanek autobusowy i właściwy kierunek?](https://www.roote.ai/pl/guides/jak-znalezc-wlasciwy-przystanek-autobusowy-i-wlasciwy-kierunek/)

## Przesiadka

Zmiana pojazdu lub środka transportu podczas podróży. Bliskość przystanków nie gwarantuje wygodnej przesiadki.

Przykład : Należy uwzględnić marsz między peronami i czas oczekiwania.

Zgłęb w przewodniku : [Jak czytać mapę autobusu, tramwaju lub metra?](https://www.roote.ai/pl/guides/jak-czytac-mape-autobusu-tramwaju-lub-metra/)

## Planowa godzina

Godzina według rozkładu na dany dzień i kurs. Nie zawsze odzwierciedla aktualne położenie pojazdu.

Przykład : Odjazd zaplanowany na 8:10 według kalendarza.

Zgłęb w przewodniku : [Rozkłady jazdy autobusów: jaka różnica między rozkładami teoretycznymi a rzeczywistymi?](https://www.roote.ai/pl/guides/rozkldy-jazdy-komunikacji-miejskiej-roznice-miedzy-rozkldami-teoretycznymi-a-rzeczywistymi/)

## Szacowany czas

Przewidywany czas kursu wyliczony z dostępnych danych. Może ulegać zmianom wraz z nowymi informacjami.

Przykład : Przejazd planowany na 8:10 teraz szacowany na 8:14.

Zgłęb w przewodniku : [Rozkłady jazdy autobusów: jaka różnica między rozkładami teoretycznymi a rzeczywistymi?](https://www.roote.ai/pl/guides/rozkldy-jazdy-komunikacji-miejskiej-roznice-miedzy-rozkldami-teoretycznymi-a-rzeczywistymi/)

## Następny odjazd

Nadchodzące odjazdy lub kursy dla miejsca i usługi. Znalezienie przystanku to nie jest szukanie kolejnych odjazdów.

Przykład : Lista przystanków i lista odjazdów to dwa różne wyniki.

Zgłęb w przewodniku : [Jak wyszukać przystanki komunikacji w pobliżu za pomocą API?](https://www.roote.ai/pl/guides/jak-wyszukac-przystanki-komunikacji-w-poblizu-z-uzyciem-api/)

## Zakłócenie

Wydarzenie wpływające na kurs, jak przerwa lub zmiana trasy. Skutki dotyczą określonego obszaru i czasu.

Przykład : Komunikat o zakłóceniach może dotyczyć linii tylko w konkretnych godzinach.

Zgłęb w przewodniku : [Jak stworzyć asystenta, który znajdzie mobilność wokół adresu?](https://www.roote.ai/pl/guides/jak-stworzyc-asystenta-mobilnosci-przy-adresie/)

## Kalendarz usług

Informacje o dniach, w których kursy są realizowane, wraz z wyjątkami. Rozkłady należy interpretować w kontekście kalendarza.

Przykład : Kurs w dni robocze może nie być realizowany w niedzielę.

Zgłęb w przewodniku : [GTFS, GTFS-RT i GBFS: jakie są różnice?](https://www.roote.ai/pl/guides/gtfs-gtfs-rt-i-gbfs-jakie-sa-roznice/)

## Usługa miejska

Obiekt lub usługa użyteczna w pobliżu, np. toaleta, źródło wody, stacja ładowania. Dane mogą być niekompletne.

Przykład : Wynik lokalizacji opisuje usługę i znane informacje o niej.

Zgłęb w przewodniku : [Jak wyszukać przystanki komunikacji w pobliżu za pomocą API?](https://www.roote.ai/pl/guides/jak-wyszukac-przystanki-komunikacji-w-poblizu-z-uzyciem-api/)

## Toalety publiczne

Toalety dostępne publicznie według lokalnych zasad. Obecność w danych nie gwarantuje bezpłatności ani dostępności.

Przykład : Sprawdź przed skorzystaniem rzeczywiste warunki dostępu.

Zgłęb w przewodniku : [Jak znaleźć darmowe toalety publiczne w pobliżu?](https://www.roote.ai/pl/guides/jak-znalezc-darmowe-toalety-publiczne-w-poblizu/)

## Dostępność

Cecha pozwalająca korzystać z miejsca lub usługi zgodnie z potrzebami użytkownika. Brak danych nie oznacza dostępności ani jej braku.

Przykład : Dostępność dla wózków może być podana lub nieznana.

Zgłęb w przewodniku : [Dostępne toalety publiczne: co sprawdzić przed wyjściem?](https://www.roote.ai/pl/guides/toalety-publiczne-dostepne-co-sprawdzic/)

## Osoba z ograniczoną mobilnością — OOM

Osoba mająca problemy z poruszaniem się, stałe lub tymczasowe. Oznaczenie OOM nie wyjaśnia wszystkich potrzeb i udogodnień.

Przykład : Obecność rampy nie wyklucza innych barier.

Zgłęb w przewodniku : [Dostępne toalety publiczne: co sprawdzić przed wyjściem?](https://www.roote.ai/pl/guides/toalety-publiczne-dostepne-co-sprawdzic/)

## Godziny otwarcia

Okresy, w których miejsce deklaruje pracę. Nie jest to potwierdzenie funkcjonowania w czasie rzeczywistym.

Przykład : Tymczasowe zamknięcie może nie być odzwierciedlone w standardowych godzinach.

Zgłęb w przewodniku : [Jak znaleźć darmowe toalety publiczne w pobliżu?](https://www.roote.ai/pl/guides/jak-znalezc-darmowe-toalety-publiczne-w-poblizu/)

## Woda pitna

Woda oznaczona jako bezpieczna do spożycia. Punkt wodny lub fontanna bez wyraźnej informacji nie są gwarancją.

Przykład : Należy rozróżnić typ urządzenia i informacje o nim.

Zgłęb w przewodniku : [Jak wyszukać przystanki komunikacji w pobliżu za pomocą API?](https://www.roote.ai/pl/guides/jak-wyszukac-przystanki-komunikacji-w-poblizu-z-uzyciem-api/)

## Stacja ładowania

Urządzenie do ładowania kompatybilnych pojazdów. Lokalizacja nie gwarantuje dostępności ani zgodności z wtyczką.

Przykład : Miejsce ładowania i jego status to różne informacje.

Zgłęb w przewodniku : [Jak wyszukać przystanki komunikacji w pobliżu za pomocą API?](https://www.roote.ai/pl/guides/jak-wyszukac-przystanki-komunikacji-w-poblizu-z-uzyciem-api/)

## Rodzaj usługi

Kategoria używana do wyboru lub opisu usługi miejskiej. Dozwolone wartości zależą od interfejsu i schematu.

Przykład : API usług ROOTE używa typu=toilets dla toalet.

Zgłęb w przewodniku : [Jak wyszukać przystanki komunikacji w pobliżu za pomocą API?](https://www.roote.ai/pl/guides/jak-wyszukac-przystanki-komunikacji-w-poblizu-z-uzyciem-api/)

## Geolokalizacja

Pozyskiwanie pozycji geograficznej przez urządzenie lub aplikację. Zależy od pozwoleń i dostępnej dokładności.

Przykład : Przycisk lokalizacji wymaga zgody przeglądarki.

Zgłęb w przewodniku : [Jak wbudować mapę mobilności na swojej stronie?](https://www.roote.ai/pl/guides/jak-wbudowac-mape-mobilnosci-na-stronie/)

## Współrzędne GPS

Wartości reprezentujące punkt geograficzny, zwykle szerokość i długość geograficzną. Kolejność zależy od używanego interfejsu.

Przykład : W wyszukiwarce lokalnej podajemy dwie odrębne współrzędne.

Zgłęb w przewodniku : [Jak wyszukać przystanki komunikacji w pobliżu za pomocą API?](https://www.roote.ai/pl/guides/jak-wyszukac-przystanki-komunikacji-w-poblizu-z-uzyciem-api/)

## Szerokość geograficzna

Współrzędna określająca pozycję na północ lub południe od równika w stopniach według przykładów ROOTE. Zakres od −90 do 90.

Przykład : Szerokość geograficzna punktu wyszukiwania przekazywana jest w lat.

Zgłęb w przewodniku : [Jak wyszukać przystanki komunikacji w pobliżu za pomocą API?](https://www.roote.ai/pl/guides/jak-wyszukac-przystanki-komunikacji-w-poblizu-z-uzyciem-api/)

## Długość geograficzna

Współrzędna określająca pozycję na wschód lub zachód od południka zerowego. Przykłady ROOTE używają stopni między −180 a 180.

Przykład : Długość geograficzna może być przekazywana w lon lub alternatywnie lng.

Zgłęb w przewodniku : [Jak wyszukać przystanki komunikacji w pobliżu za pomocą API?](https://www.roote.ai/pl/guides/jak-wyszukac-przystanki-komunikacji-w-poblizu-z-uzyciem-api/)

## Geokodowanie

Wyszukiwanie przekształcające adres lub opis miejsca na kandydatów z koordynatami. Wiele miejsc może odpowiadać jednemu wpisowi.

Przykład : Dwa miasta mogą mieć ulicę o tym samym nazwie.

Zgłęb w przewodniku : [Jak stworzyć asystenta, który znajdzie mobilność wokół adresu?](https://www.roote.ai/pl/guides/jak-stworzyc-asystenta-mobilnosci-przy-adresie/)

## Geokodowanie odwrotne

Wyszukiwanie miejsc lub nazw na podstawie współrzędnych. Wynik może przedstawiać miejsce w pobliżu, nie gwarantując dokładnego adresu.

Przykład : Punkt GPS powiązany z czytelną nazwą.

Zgłęb w przewodniku : [Czym jest serwer MCP i do czego służy?](https://www.roote.ai/pl/guides/czym-jest-serwer-mcp-i-do-czego-sluzy/)

## Punkt zainteresowania — POI

Miejsce przydatne w wyszukiwaniu, np. obiekt lub urządzenie. POI różni się od zwykłego adresu pocztowego.

Przykład : Nazwa hotelu może być wyszukiwana jako obiekt.

Zgłęb w przewodniku : [Jak stworzyć asystenta, który znajdzie mobilność wokół adresu?](https://www.roote.ai/pl/guides/jak-stworzyc-asystenta-mobilnosci-przy-adresie/)

## Punkt wyszukiwania

Punkt, od którego liczona jest odległość i wykonywane wyszukiwanie lokalne. Może się różnić od wyświetlanego centrum mapy.

Przykład : Kamera przesuwa się, a wyszukiwanie jest skupione na Bordeaux.

Zgłęb w przewodniku : [Jak wbudować mapę mobilności na swojej stronie?](https://www.roote.ai/pl/guides/jak-wbudowac-mape-mobilnosci-na-stronie/)

## Promień wyszukiwania

Odległość wokół punktu startowego ograniczająca zakres poszukiwań. Jednostka i zakres zależą od umowy API lub narzędzia.

Przykład : radius=600 oznacza promień 600 metrów w przykładzie REST.

Zgłęb w przewodniku : [Jak wyszukać przystanki komunikacji w pobliżu za pomocą API?](https://www.roote.ai/pl/guides/jak-wyszukac-przystanki-komunikacji-w-poblizu-z-uzyciem-api/)

## Odległość geograficzna

Odległość między punktami wyliczona zgodnie z metodą usługi. Nie jest automatycznie trasą ani czasem dojścia.

Przykład : Bliskie miejsce może wymagać objazdu, by było dostępne.

Zgłęb w przewodniku : [Jak wyszukać przystanki komunikacji w pobliżu za pomocą API?](https://www.roote.ai/pl/guides/jak-wyszukac-przystanki-komunikacji-w-poblizu-z-uzyciem-api/)

## Powiększenie mapy

Poziom skalowania widoku mapowego. Kontroluje widoczność, nie zastępuje promienia zapytania API.

Przykład : zoom=15 przybliża widok mapy.

Zgłęb w przewodniku : [Jak wbudować mapę mobilności na swojej stronie?](https://www.roote.ai/pl/guides/jak-wbudowac-mape-mobilnosci-na-stronie/)

## Dane w czasie rzeczywistym

Informacje aktualizowane, by pokazać bieżący stan lub zasilić prognozę. Świeżość danych musi być oceniona; czas rzeczywisty nie oznacza natychmiastowości ani gwarancji.

Przykład : Prognoza przejazdu jest aktualizowana na podstawie najnowszych danych.

Zgłęb w przewodniku : [Rozkłady jazdy autobusów: jaka różnica między rozkładami teoretycznymi a rzeczywistymi?](https://www.roote.ai/pl/guides/rozkldy-jazdy-komunikacji-miejskiej-roznice-miedzy-rozkldami-teoretycznymi-a-rzeczywistymi/)

## Obserwacja

Stan lub zdarzenie zarejestrowane w określonym czasie. Należy odróżniać ją od zdarzeń planowanych lub prognozowanych.

Przykład : Rzeczywisty przejazd autobusu może różnić się od prognozy.

Zgłęb w przewodniku : [Rozkłady jazdy autobusów: jaka różnica między rozkładami teoretycznymi a rzeczywistymi?](https://www.roote.ai/pl/guides/rozkldy-jazdy-komunikacji-miejskiej-roznice-miedzy-rozkldami-teoretycznymi-a-rzeczywistymi/)

## Świeżość danych

Określenie aktualności informacji na podstawie dat i zasad umowy. Czas zapytania sam w sobie nie dowodzi świeżości źródła.

Przykład : Odczytany teraz licznik może pochodzić ze starej obserwacji.

Zgłęb w przewodniku : [Dostępność rowerów na żywo: jak ją wyświetlić w aplikacji?](https://www.roote.ai/pl/guides/dostepnosc-rowerow-na-zywo-jak-wyswietlic-w-aplikacji/)

## Znacznik czasu

Wskazanie czasu powiązane z danymi lub zdarzeniem. Znaczenie zależy od pola: obserwacja, aktualizacja, odbiór lub wygaśnięcie.

Przykład : source_updated_at i received_at opisują różne etapy.

Zgłęb w przewodniku : [Dostępność rowerów na żywo: jak ją wyświetlić w aplikacji?](https://www.roote.ai/pl/guides/dostepnosc-rowerow-na-zywo-jak-wyswietlic-w-aplikacji/)

## Dane przeterminowane — stale

Informacje uznane za zbyt stare według umowy lub polityki ważności. Mogą być przechowywane jako historia, bez podawania ich jako aktualne.

Przykład : Interfejs wskazuje, że dostępność wymaga odświeżenia.

Zgłęb w przewodniku : [Dostępność rowerów na żywo: jak ją wyświetlić w aplikacji?](https://www.roote.ai/pl/guides/dostepnosc-rowerow-na-zywo-jak-wyswietlic-w-aplikacji/)

## Czas życia danych — TTL

Okres stosowany do zarządzania ważnością lub odnowieniem danych w pamięci podręcznej zgodnie z umową. Nie dowodzi samego czasu obserwacji źródłowej.

Przykład : Wygasły cache musi być odświeżony zgodnie z polityką.

Zgłęb w przewodniku : [Dostępność rowerów na żywo: jak ją wyświetlić w aplikacji?](https://www.roote.ai/pl/guides/dostepnosc-rowerow-na-zywo-jak-wyswietlic-w-aplikacji/)

## Pamięć podręczna

Tymczasowe przechowywanie wyników, by uniknąć powtarzających się identycznych zapytań. Wartość w cache zachowuje swoje źródło i kontekst czasowy.

Przykład : Dwa takie same zapytania mogą użyć ciągle ważnej odpowiedzi.

Zgłęb w przewodniku : [Dostępność rowerów na żywo: jak ją wyświetlić w aplikacji?](https://www.roote.ai/pl/guides/dostepnosc-rowerow-na-zywo-jak-wyswietlic-w-aplikacji/)

## Zasięg danych

Obszar i poziom kompletności dostępnych informacji dla zapytania lub źródła. Częściowy zasięg ogranicza wnioski, które można wyciągnąć.

Przykład : Lista może być przydatna, mimo że nie pokrywa wszystkich usług.

Zgłęb w przewodniku : [Brak wyniku czy błąd API: jak je rozróżnić?](https://www.roote.ai/pl/guides/brak-wyniku-czy-blad-api-jak-roznicowac/)

## Pochodzenie danych

Informacje identyfikujące źródło danych i sposób ich pozyskania zgodnie z umową. Pomagają interpretować zakres informacji.

Przykład : Wynik zachowuje swoje źródło i kontekst zbierania.

Zgłęb w przewodniku : [Jak stworzyć asystenta, który znajdzie mobilność wokół adresu?](https://www.roote.ai/pl/guides/jak-stworzyc-asystenta-mobilnosci-przy-adresie/)

## Przypisanie

Wzmianka o dostawcy lub źródle danych. Gdy wymagana, aplikacja powinna ją wyświetlać przy korzystaniu z danych.

Przykład : Przy przypisaniu wymaganym must-have pokazuj w interfejsie.

Zgłęb w przewodniku : [Jak wyszukać przystanki komunikacji w pobliżu za pomocą API?](https://www.roote.ai/pl/guides/jak-wyszukac-przystanki-komunikacji-w-poblizu-z-uzyciem-api/)

## GTFS Schedule

Standardowy format opisujący planowaną ofertę transportu: przystanki, linie, kursy, kalendarze i odjazdy. Nie zawiera automatycznie danych bieżących.

Przykład : Procesowane są kursy powiązane z liniami i dniami działania.

Zgłęb w przewodniku : [GTFS, GTFS-RT i GBFS: jakie są różnice?](https://www.roote.ai/pl/guides/gtfs-gtfs-rt-i-gbfs-jakie-sa-roznice/)

## GTFS Realtime — GTFS-RT

Standardowy format do przesyłania aktualizacji kursów, pozycji pojazdów i alertów. Zakres publikowanych kategorii zależy od dostawcy.

Przykład : Strumień pozycji nie oznacza prognoz dla wszystkich przystanków.

Zgłęb w przewodniku : [GTFS, GTFS-RT i GBFS: jakie są różnice?](https://www.roote.ai/pl/guides/gtfs-gtfs-rt-i-gbfs-jakie-sa-roznice/)

## GBFS

Standardowy format danych publicznych dotyczących współdzielonej mobilności. W zależności od wersji oraz strumieni opisuje systemy, stacje, pojazdy i ich statusy.

Przykład : Informacje o stacjach i liczniki dostępności są oddzielone.

Zgłęb w przewodniku : [GTFS, GTFS-RT i GBFS: jakie są różnice?](https://www.roote.ai/pl/guides/gtfs-gtfs-rt-i-gbfs-jakie-sa-roznice/)

## Wartość nieznana — null

Brak znanej wartości zgodnie z umową przy użyciu null. Nie powinna być zastępowana zerem, fałszem ani dowodem braku.

Przykład : Null w liczniku rowerów nie oznacza pustej stacji.

Zgłęb w przewodniku : [Brak wyniku czy błąd API: jak je rozróżnić?](https://www.roote.ai/pl/guides/brak-wyniku-czy-blad-api-jak-roznicowac/)

## API

Interfejs pozwalający programowi korzystać z funkcji innej usługi poprzez zdefiniowany kontrakt. Określa oczekiwane wejścia i odpowiedzi.

Przykład : Aplikacja wyszukuje przystanki przez API ROOTE.

Zgłęb w przewodniku : [API czy MCP: który wybrać do integracji danych mobilności?](https://www.roote.ai/pl/guides/api-czy-mcp-ktory-wybrac-do-integracji-danych-mobilnosci/)

## API REST

Podejście do HTTP używające zasobów i mechanizmów www. Kontrakt API definiuje trasy, metody i formaty danych.

Przykład : Zapytanie jest wysyłane do udokumentowanej trasy GET.

Zgłęb w przewodniku : [Jak wyszukać przystanki komunikacji w pobliżu za pomocą API?](https://www.roote.ai/pl/guides/jak-wyszukac-przystanki-komunikacji-w-poblizu-z-uzyciem-api/)

## Endpoint — trasa API

Adres i operacja oferowane przez API w danym zakresie funkcji. Różne trasy mogą zwracać różne rodziny wyników.

Przykład : /v1/transit/nearby wyszukuje miejsca transportu w pobliżu.

Zgłęb w przewodniku : [Jak wyszukać przystanki komunikacji w pobliżu za pomocą API?](https://www.roote.ai/pl/guides/jak-wyszukac-przystanki-komunikacji-w-poblizu-z-uzyciem-api/)

## Parametr zapytania

Wartość przekazywana po znaku zapytania w URL. Nazwa i format są zdefiniowane przez API.

Przykład : modes=bus,tram wybiera tryby w kompatybilnym URL.

Zgłęb w przewodniku : [Jak wbudować mapę mobilności na swojej stronie?](https://www.roote.ai/pl/guides/jak-wbudowac-mape-mobilnosci-na-stronie/)

## Status HTTP

Kod określający wynik zapytania na poziomie protokołu HTTP. Powinien być uzupełniony statusem biznesowym i zawartością.

Przykład : HTTP 200 może zawierać status error w warstwie aplikacji.

Zgłęb w przewodniku : [Brak wyniku czy błąd API: jak je rozróżnić?](https://www.roote.ai/pl/guides/brak-wyniku-czy-blad-api-jak-roznicowac/)

## Wynik pusty — empty

Zapytanie nie zwróciło żadnych obiektów w danym zakresie. Nie dowodzi braku usług poza dostępnymi danymi.

Przykład : Brak przystanków spełniających podane filtry.

Zgłęb w przewodniku : [Brak wyniku czy błąd API: jak je rozróżnić?](https://www.roote.ai/pl/guides/brak-wyniku-czy-blad-api-jak-roznicowac/)

## Częściowa odpowiedź — partial

Wynik zawierający użyteczne informacje z ograniczeniami lub brakami. Powinien mieć dołączone odpowiednie ostrzeżenia.

Przykład : Jedno źródło odpowiada, inne jest niedostępne.

Zgłęb w przewodniku : [Brak wyniku czy błąd API: jak je rozróżnić?](https://www.roote.ai/pl/guides/brak-wyniku-czy-blad-api-jak-roznicowac/)

## Limit czasu — timeout

Przerwanie oczekiwania, gdy operacja przekracza ustalony czas. Oznacza niedokończone wyszukiwanie, nie brak wyników.

Przykład : Aplikacja proponuje ponowienie próby zamiast pustej listy.

Zgłęb w przewodniku : [Brak wyniku czy błąd API: jak je rozróżnić?](https://www.roote.ai/pl/guides/brak-wyniku-czy-blad-api-jak-roznicowac/)

## Limit częstotliwości — rate limit

Ograniczenie liczby zapytań na jednostkę czasu przez usługę. Reguły i zasady odnowienia zależą od aktywnego kontraktu.

Przykład : Kod 429 wymaga przestrzegania zasad odnowienia.

Zgłęb w przewodniku : [Brak wyniku czy błąd API: jak je rozróżnić?](https://www.roote.ai/pl/guides/brak-wyniku-czy-blad-api-jak-roznicowac/)

## Token Bearer

Identyfikator dostępu przekazywany w nagłówku Authorization według określonego mechanizmu. Powinien być bezpiecznie przechowywany.

Przykład : Authorization: Bearer stosowane bez ujawniania tokenu w URL.

Zgłęb w przewodniku : [Jak połączyć asystenta AI z MCP ROOTE?](https://www.roote.ai/pl/guides/jak-polaczyc-asystenta-ai-z-mcp-roote/)

## JSON

Tekstowy format strukturalny wykorzystujący obiekty, tablice, łańcuchy i liczby. Poprawny składniowo JSON może nie spełniać wymagań API.

Przykład : Kolekcja stations powinna mieć typ i pola zgodne z oczekiwaniami.

Zgłęb w przewodniku : [Jak wyszukać przystanki komunikacji w pobliżu za pomocą API?](https://www.roote.ai/pl/guides/jak-wyszukac-przystanki-komunikacji-w-poblizu-z-uzyciem-api/)

## OpenAPI

Specyfikacja opisująca kontrakt API HTTP w ustrukturyzowanym dokumencie. Pomaga sprawdzać trasy, parametry, odpowiedzi i schematy.

Przykład : Kontrakt ROOTE jest opublikowany w openapi.json.

Zgłęb w przewodniku : [Jak wyszukać przystanki komunikacji w pobliżu za pomocą API?](https://www.roote.ai/pl/guides/jak-wyszukac-przystanki-komunikacji-w-poblizu-z-uzyciem-api/)

## Embed — osadzona mapa

Wstawienie zewnętrznego doświadczenia np. mapy w iframe. Parametry i uprawnienia określają jej kontekst użycia.

Przykład : Iframe ROOTE pokazuje rowery wokół Bordeaux.

Zgłęb w przewodniku : [Jak wbudować mapę mobilności na swojej stronie?](https://www.roote.ai/pl/guides/jak-wbudowac-mape-mobilnosci-na-stronie/)

## Iframe

Element HTML ładujący dokument wewnątrz strony. Na odmiennych domenach rodzic nie może swobodnie czytać zawartości iframe.

Przykład : Zmiany wyszukiwania wymagają udokumentowanej wymiany z rodzicem.

Zgłęb w przewodniku : [Jak wbudować mapę mobilności na swojej stronie?](https://www.roote.ai/pl/guides/jak-wbudowac-mape-mobilnosci-na-stronie/)

## MCP — Model Context Protocol

Protokół umożliwiający aplikacji SI komunikację z serwerami oferującymi narzędzia lub kontekst. Sam nie definiuje jakości zwracanych danych.

Przykład : Asystent odkrywa narzędzia wyszukiwania ROOTE.

Zgłęb w przewodniku : [Czym jest serwer MCP i do czego służy?](https://www.roote.ai/pl/guides/czym-jest-serwer-mcp-i-do-czego-sluzy/)

## Serwer MCP

Program udostępniający funkcje według protokołu MCP. Rzeczywista oferta narzędzi zależy od serwera.

Przykład : tools/list pozwala na sprawdzenie dostępnego inwentarza.

Zgłęb w przewodniku : [Czym jest serwer MCP i do czego służy?](https://www.roote.ai/pl/guides/czym-jest-serwer-mcp-i-do-czego-sluzy/)

## Klient MCP

Komponent aplikacji SI łączący się z serwerem MCP i obsługujący wymiany protokołu.

Przykład : Klient przesyła parametry wyszukiwania do ROOTE.

Zgłęb w przewodniku : [Czym jest serwer MCP i do czego służy?](https://www.roote.ai/pl/guides/czym-jest-serwer-mcp-i-do-czego-sluzy/)

## Aplikacja goszcząca MCP

Aplikacja obsługująca interakcję użytkownika i jeden lub więcej klientów MCP. Odpowiada za wyniki w swoim doświadczeniu.

Przykład : Twoja aplikacja konwersacyjna podłącza serwer ROOTE.

Zgłęb w przewodniku : [Czym jest serwer MCP i do czego służy?](https://www.roote.ai/pl/guides/czym-jest-serwer-mcp-i-do-czego-sluzy/)

## Narzędzie MCP

Wykonywalna funkcja opisana nazwą, funkcjonalnością i schematem argumentów. Asystent powinien używać danych akceptowanych przez schemat.

Przykład : geocode przyjmuje adres; transit_nearby – współrzędne.

Zgłęb w przewodniku : [Jak połączyć asystenta AI z MCP ROOTE?](https://www.roote.ai/pl/guides/jak-polaczyc-asystenta-ai-z-mcp-roote/)

## Streamable HTTP

Transport MCP pozwalający na komunikację zdalną przez HTTP. Obsługa zależy od klienta.

Przykład : Zdalny serwer ROOTE korzysta z https://mcp.roote.ai/mcp.

Zgłęb w przewodniku : [Jak połączyć asystenta AI z MCP ROOTE?](https://www.roote.ai/pl/guides/jak-polaczyc-asystenta-ai-z-mcp-roote/)

## Odpowiedź oparta na danych — grounding

Tworzenie odpowiedzi z faktycznie pozyskanych lub dostarczonych informacji. Brakujące pola i zastrzeżenia powinny być widoczne.

Przykład : Asystent korzysta z dostarczonych miejsc bez wymyślania harmonogramów.

Zgłęb w przewodniku : [Jak stworzyć asystenta, który znajdzie mobilność wokół adresu?](https://www.roote.ai/pl/guides/jak-stworzyc-asystenta-mobilnosci-przy-adresie/)

## Halucynacja asystenta SI

Generowanie informacji bez podstaw, przedstawianych jako pewne. W mobilności może to być wymyślony rozkład lub dostępność.

Przykład : Asystent podaje przejazd, a narzędzie zwróciło tylko przystanek.

Zgłęb w przewodniku : [Jak stworzyć asystenta, który znajdzie mobilność wokół adresu?](https://www.roote.ai/pl/guides/jak-stworzyc-asystenta-mobilnosci-przy-adresie/)

## Wstrzyknięcie instrukcji

Próba użycia zewnętrznej treści do zmiany poleceń asystenta. Opisy dostawców powinny pozostać danymi, nie rozkazami.

Przykład : Ukryta instrukcja w nazwie miejsca nie powinna być wykonywana.

Zgłęb w przewodniku : [Jak stworzyć asystenta, który znajdzie mobilność wokół adresu?](https://www.roote.ai/pl/guides/jak-stworzyc-asystenta-mobilnosci-przy-adresie/)

## Tylko do odczytu

Możliwość przeglądania bez operacji zmiany. Odczyt dostępności nie rezerwuje ani nie wypożycza pojazdu.

Przykład : Narzędzia danych ROOTE służą do przeglądania informacji.

Zgłęb w przewodniku : [Czym jest serwer MCP i do czego służy?](https://www.roote.ai/pl/guides/czym-jest-serwer-mcp-i-do-czego-sluzy/)