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.
Słownik ROOTE
Słownik mobilności i danych.
Proste definicje, by pojąć transport, usługi lokalne i narzędzia łączące je z twoimi aplikacjami.
79 definicji wyświetlonych
A
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.
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.
C
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ą.
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.
D
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.
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.
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.
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.
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.
E
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.
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.
G
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.
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.
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ą.
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.
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.
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.
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.
H
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.
I
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.
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ę.
J
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.
K
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ę.
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.
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.
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.
L
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.
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.
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.
M
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.
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.
N
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.
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.
O
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.
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.
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.
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.
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.
P
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.
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.
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.
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ą.
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.
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.
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.
Powiększenie mapy
Poziom skalowania widoku mapowego. Kontroluje widoczność, nie zastępuje promienia zapytania API.
Przykład
zoom=15 przybliża widok mapy.
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.
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.
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.
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.
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.
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.
R
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.
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.
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.
S
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.
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.
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.
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.
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.
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.
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.
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.
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.
Ś
Ś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.
T
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.
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.
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.
U
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.
W
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.
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.
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.
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.
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.
Z
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.
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.
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.
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.
Brak pasujących definicji. Spróbuj inne słowo lub usuń filtr.
Źródła do zgłębienia
Terminy dotyczące ROOTE opierają się na dokumentowanych kontraktach. Standardy i protokoły mają własne oficjalne źródła.
Powrót do centrum zasobów