GTFS Schedule kirjeldab planeeritud ühistranspordi pakkumist. GTFS Realtime ehk GTFS-RT edastab jooksvaid andmeid teenuse kohta. GBFS kirjeldab jagatud mobiilsusteenuseid, sealhulgas jaamu ja kättesaadavaid sõidukeid vastavalt avaldatud voogudele. Valige formaat vastavalt sellele, millist küsimust teie rakendus peab lahendama.
Need formaadid organiseerivad andmeid; need ei taga nende kättesaadavust kõikjal ega iga voo kvaliteeti.
GTFS planeeritud pakkumise esitamiseks
GTFS Schedule koosneb mitu tabelifailidest, mis kirjeldavad muu hulgas teenusepakkujaid, peatusi, liine, sõite ja nende läbimisi. Kalender näitab, millistel päevadel teenus kehtib. Failid on omavahel seotud identifikaatorite kaudu. GTFS Schedule viide.
Selle abil saab vastata küsimustele nagu „kus see peatus asub?“ või „millal on selle teenuse järgmine läbiminek?“. Sõiduplaani kasutamiseks tuleb mõista kalendrit ja failidevahelisi seoseid.
Ainult peatuseloendi lugemine ei ole piisav läbimiste taastamiseks. Teisalt võib peatuskoht olla kasulik ka ilma sõiduplaanita kuvamata.
GTFS-RT teenuseandmete ajakohastamiseks
GTFS Realtime suudab anda sõiduuuendusi, sõidukite asukohateavet ja hoiatusi. Sõiduuuendused hõlmavad läbimisi ja teenuse muudatusi. Vood kasutavad Protocol Buffers formaati, mis on struktureeritud serialiseerimisviis. GTFS Realtime sissejuhatus.
Andmete tootja võib avaldada ainult mõned kategooriad, mitte kõiki. Asukoha voo olemasolu ei taga andmeid kõigi peatuskohtade jaoks.
Kasutajaliideses eristage planeeritud läbimist ja ajakohastatud hinnangut. Meie juhend teoreetilised ajad ja tegelik aeg selgitab seda erinevust kasutaja vaatepunktist.
GBFS jagatud mobiilsuse jaoks
GBFS kasutab JSON-vooge jagatud mobiilsusteenuse kirjeldamiseks. Sõltuvalt süsteemist ja versioonist võivad need sisaldada jaamu, nende olekut, sõidukeid ja muid teenuse omadusi. Dokumentatsioon eristab eriti jaama andmeid ja kättesaadavuse olekuid. GBFS dokumentatsioon.
Eraldage oma rakenduses suhteliselt stabiilsed asukohad kiiresti muutuvatest olekutest. Hoidke vormingu versioon ja asjakohane ajatempel tõlgendamisel alles.
Kättesaadavuse voog ei ole broneerimis- ega lukustamataoleku API. See aitab pakkumist leida, rentimine toimub teenuse pakkuja kaudu.
Võrrelge kasutusjuhtude põhjal
| Vajadus | Vaadeldav formaat |
|---|---|
| Kirjeldada planeeritud peatusi ja liine | GTFS Schedule |
| Tõlgendada planeeritud läbimisi ja teenusepäevi | GTFS Schedule |
| Ajakohastada läbimisi või saada teenuseinfot | GTFS-RT, vastavalt avaldatud voogudele |
| Leida jagatud mobiilsuse jaamu või sõidukeid | GBFS, vastavalt avaldatud andmetele |
Disaini näide: kaart kuvab trammipeatusi ja jalgrattajaamu. Kasutatakse struktuurandmeid asukohtade jaoks ja ajakohaseid olekuid rattakättesaadavuse kohta. Mõlemad kihid vajavad erinevat vahemällu salvestamist ja värskendusi.
Arvestage iga andmeallika piirangutega
Kontrollige versioone, valikulisi välju, katvust ja kasutusõigusi. Identifikaatoril on tähendus ainult oma kontekstis: kaks tootjat võivad kasutada sama stringi erinevate üksuste tähistamiseks.
Varuge puuduvate või aegunud andmetega tegelemiseks. Voost puuduv tühi nimekiri ei tohi tähendada teenuse puudumist. Vältige teadmata info vaikset nullistamist.
Kasuta vooge otse või API-d kaudu
Otsene integreerimine jätab andmete kogumise, valideerimise ja tõlgendamise teie kanda. API võib pakkuda ühtset lepingut, kuid sisaldab alati oma katvuse, hoiatused ja tingimused.
ROOTE esimese kasutusjuhtumi jaoks vaadake kuidas API abil lähimaid peatusi otsida. Alustage kasutajaliidese vajadusest ja kontrollige tegelikult saadaolevaid välja.
Lugeda väljavõtteid ja valida arhitektuur
GTFS Schedule'is seob stop_times.txt väljavõte sõidu, peatuse ja planeeritud läbipääsu. Alljärgnev lihtsustatud näide on õppeotstarbeline: see ei ole täielik GTFS komplekt ja selle identifikaatorid tuleb siduda trips.txt, stops.txt ja kalendritega.
GTFS Realtime puhul otsige kasulikku üksust: TripUpdate võib uuendada läbipääsu, VehiclePosition kirjeldab sõiduki asukohta ja Alert edastab teenuseinfo. Sõiduki asukoht ei ole automaatselt saabumise hinnang. Edastatav formaat on Protocol Buffers; JSON diagnostiline esitlus ei ole binaarne põhivoog.
GBFS-is kirjeldab station_information jaamasid, samas kui station_status kirjeldab nende avaldatud olekuid. Mõnede loendurite nimed ja kättesaadavad failid muutuvad versiooniti. Järgmine JSON väljavõte illustreerib GBFS 2.3 versiooni ning väljundeid num_bikes_available ja num_docks_available; kontrollige versiooni enne näite kasutamist.
Asukohakaart võib alata struktuursete andmetega. Järgmiste läbipääsude näitamiseks ekraan vajab vastavaid uuendusi ja ekspilitsiitselt planeeritud varuvarianti. Jalgrataste saadavuse ekraan peab haldama loendurid, renditingimused ja ajaliselt kehtivust. Need kolm ekraani ei jaga automaatselt sama vahemällu salvestamise poliitikat.
# 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
}Jalgratta saadavuse ja andmete värskuse vormindamine
Valida API või MCP oma toote jaoks
Korduma kippuvad küsimused
Kas GTFS sisaldab automaatselt reaalajas andmeid?
Ei. GTFS Schedule kirjeldab planeeritud pakkumist; jooksvaid andmeid haldavad teised vood, nagu GTFS-RT.
Kas GBFS võimaldab jalgratast lukust avada?
See kirjeldab teenust ja selle avalikke andmeid. Rentimine toimub operaatori pakutavate võimaluste kaudu.
Kas standardvorming tagab täieliku katvuse?
Ei. Vorming määratleb struktuuri; katvus ja avaldatud info sõltuvad andmeallikatest.