GTFS Schedule popisuje plánovanou nabídku dopravy. GTFS Realtime, často označovaný jako GTFS-RT, poskytuje aktuální informace o provozu. GBFS popisuje služby sdílené mobility, zejména jejich stanice a dostupná vozidla podle zveřejněných toků. Vyberte formát podle otázky, kterou má vaše aplikace řešit.
Tyto formáty organizují data; nezaručují však jejich dostupnost všude ani kvalitu každého toku.
GTFS pro zobrazení plánované nabídky
Sada GTFS Schedule obsahuje tabulkové soubory popisující zejména provozovatele, zastávky, linky, spoje a jejich průjezdy. Kalendáře uvádějí příslušné dny. Soubory jsou propojeny pomocí identifikátorů. Reference GTFS Schedule.
Umožňuje odpovědět na otázky jako „kde se nachází tato zastávka?“ nebo „jaký průjezd je plánován pro tuto službu?“. Pro práci s jízdním řádem je třeba interpretovat kalendář a souvislosti mezi soubory.
Pouhé načtení seznamu zastávek tedy nestačí k rekonstrukci průjezdů. Naopak, poloha zastávky může být užitečná i bez zobrazení časů jízd.
GTFS-RT pro aktualizaci provozních informací
GTFS Realtime může poskytovat aktualizace spojů, polohy vozidel a upozornění. Aktualizace spojů zahrnují zejména průjezdy a změny provozu. Tóky používají Protocol Buffers, strukturovaný formát serializace. Úvod do GTFS Realtime.
Poskytovatel může zveřejnit některé kategorie bez nutnosti dodání všech ostatních. Přítomnost toku poloh negarantuje odhady pro všechny zastávky.
Pro uživatelské rozhraní rozlišujte mezi plánovaným průjezdem a aktualizovaným odhadem. Náš průvodce teoretické a reálné jízdní řády vysvětluje tento rozdíl z pohledu uživatele.
GBFS pro sdílenou mobilitu
GBFS používá JSON toky k popisu služby sdílené mobility. Podle systému a verze mohou obsahovat informace o stanicích, jejich stavu, vozidlech a dalších charakteristikách služby. Dokumentace rozlišuje zejména informace o stanicích a stavech dostupnosti. Dokumentace GBFS.
Ve vaší aplikaci oddělte relativně stabilní polohy od rychle se měnících stavů. Uchovávejte verzi formátu a relevantní časové razítko při interpretaci.
Tok dostupnosti není API pro rezervaci nebo odemykání. Pomáhá objevit nabídku; samotná operace pronájmu patří příslušné službě.
Porovnání podle případu použití
| Potřeba | Formát k prozkoumání |
|---|---|
| Popis plánovaných zastávek a linek | GTFS Schedule |
| Interpretace plánovaných průjezdů a provozních dnů | GTFS Schedule |
| Aktualizace průjezdů nebo příjem provozních informací | GTFS-RT, podle publikovaných toků |
| Lokalizace stanic nebo vozidel sdílené mobility | GBFS, podle publikovaných dat |
Příklad návrhu: mapa zobrazuje zastávky tramvaje a stanice kol. Používá strukturální data k umístění a aktualizované stavy pro dostupnost kol. Obě vrstvy mají rozdílné požadavky na cache a aktualizace.
Plánování limitů každého zdroje
Zkontrolujte verze, nepovinná pole, pokrytí a práva k použití. Identifikátor má význam pouze ve svém kontextu: dva poskytovatelé mohou používat stejné řetězce pro odlišné entity.
Plánujte také na chybějící nebo zastaralá data. Prázdný seznam ze nedostupného toku by neměl být prezentován jako absence služby. Vyhněte se tichému nahrazení neznámé informace nulou.
Přímé použití toků nebo API
Přímá integrace na vás klade odpovědnost za sběr, validaci a interpretaci zdrojů. API může nabídnout jednotnou smlouvu, ale vždy čtěte pokrytí, varování a podmínky.
Pro první případ použití ROOTE navštivte jak vyhledávat zastávky v okolí přes API. Začněte potřebou svého rozhraní a pak ověřte dostupná pole.
Čtení úryvků a výběr architektury
V GTFS Schedule úryvek souboru stop_times.txt spojuje jízdu, zastávku a naplánované průjezdy. Níže uvedený zjednodušený příklad je instruktivní: nejedná se o kompletní GTFS dataset a jeho identifikátory musí být propojeny se soubory trips.txt, stops.txt a kalendáři.
Pro GTFS Realtime hledejte užitečnou entitu: TripUpdate může aktualizovat průjezd, VehiclePosition popisuje polohu a Alert přenáší servisní informace. Poloha vozidla není automaticky odhadem příjezdu. Přenášený formát je Protocol Buffers; JSON reprezentace pro diagnostiku není referenční binární tok.
V GBFS popisuje station_information stanice, zatímco station_status uvádí jejich aktuální stav. Názvy některých čítačů a dostupné soubory se mění podle verze. Níže uvedený JSON úryvek ilustruje GBFS 2.3 a jeho pole num_bikes_available a num_docks_available; zkontrolujte verzi před použitím příkladu.
Mapa míst může začít strukturálními daty. Displej příštích průjezdů pak vyžaduje odpovídající aktualizace a explicitně naplánovaný záložní režim. Displej dostupných kol musí spravovat čítače, podmínky pronájmu a časovou platnost. Tyto tři displeje automaticky nesdílejí stejnou politiku kešování.
# Extrait pédagogique de stop_times.txt
trip_id,arrival_time,departure_time,stop_id,stop_sequence
trip_demo,08:10:00,08:10:00,stop_demo,1
# Extrait pédagogique de station_status en GBFS 2.3
{
"station_id": "station_demo",
"num_bikes_available": 3,
"num_docks_available": 7,
"is_installed": true,
"is_renting": true,
"is_returning": true,
"last_reported": 1720000000
}Formátování dostupnosti kol a jejich aktuálnosti
Výběr API nebo MCP pro váš produkt
Často kladené otázky
Obsahuje GTFS automaticky aktuální údaje?
Ne. GTFS Schedule reprezentuje plánovanou nabídku; aktuální informace poskytují jiné toky, zejména GTFS-RT.
Umožňuje GBFS odemknout kolo?
Popisuje službu a její veřejná data. Pronájem probíhá přes funkce provozovatele.
Zaručuje standardní formát úplné pokrytí?
Ne. Formát definuje strukturu; pokrytí a zveřejněné informace závisí na zdrojích.