GTFS Schedule inaelezea huduma ya usafiri iliyopangwa. GTFS Realtime, mara nyingi huitwa GTFS-RT, hutoa taarifa za huduma zilizosasishwa. GBFS inaelezea huduma za usafiri wa pamoja, hasa vituo vyake na magari yanayopatikana kulingana na mtiririko wa data uliotangazwa. Chagua muundo kulingana na swali ambalo programu yako inapaswa kutatua.
Miundo hii inaandaa data; haitoi uhakikisho wa upatikanaji wake kila mahali wala ubora wa kila mtiririko.
GTFS kwa kuwakilisha huduma iliyopangwa
Seti ya GTFS Schedule huhusisha faili za jedwali zinazoelezea hasa waendeshaji, vituo, mistari, safari na kupitia zao. Ratiba zinaonyesha siku husika. Faili hizi huhusishwa kwa vitambulisho. Marejeleo ya GTFS Schedule.
Inasaidia kujibu maswali kama “kituo hiki kiko wapi?” au “kupitia kunatarajiwa lini kwa huduma hii?”. Kuendesha ratiba, unapaswa kuelewa ratiba za kalenda na uhusiano kati ya faili.
Kusoma orodha tu ya vituo haitatoshi kujenga tena taarifa za kupitia. Kinyume chake, nafasi ya kituo inaweza kuwa muhimu hata kama ratiba hazionyeshwi.
GTFS-RT kwa kusasisha taarifa za huduma
GTFS Realtime inaweza kutoa masasisho ya safari, nafasi za magari na tahadhari. Masasisho ya safari yanajumuisha taarifa za kupitia na mabadiliko ya huduma. Mtiririko hutumia Protocol Buffers, muundo wa serialization uliopangwa. Utangulizi wa GTFS Realtime.
Mtengenezaji anaweza kutangaza aina fulani tu bila kutoa zote nyingine. Upatikanaji wa mtiririko wa nafasi hautahakikishi makadirio kwa vituo vyote.
Kwa kiolesura, tengeneza tofauti kati ya kupitia lililopangwa na makadirio yaliyosasishwa. Mwongozo wetu ratiba za nadharia na wakati halisi unaelezea tofauti hii kwa mtazamo wa mtumiaji.
GBFS kwa usafiri wa pamoja
GBFS hutumia mtiririko wa JSON kuelezea huduma ya usafiri wa pamoja. Kulingana na mfumo na toleo, inaweza kutoa taarifa za vituo, hali yao, magari na sifa nyingine za huduma. Nyaraka hutoa tofauti kati ya taarifa za kituo na hali za upatikanaji. Nyaraka za GBFS.
Tenganisha katika programu yako maeneo ambayo ni thabiti kwa kiasi kikubwa na hali zinazobadilika haraka. Hifadhi toleo la muundo na alama ya muda muhimu wakati wa tafsiri.
Mtiririko wa upatikanaji si API ya kuhifadhi au kufungua. Husaidia ugunduzi wa huduma; shughuli ya kukodisha ni jukumu la huduma husika.
Linganisheni kulingana na matumizi
| Mahitaji | Muundo wa kuangalia |
|---|---|
| Kuelezea vituo na mistari iliyopangwa | GTFS Schedule |
| Kufasiri kupitia zinazotarajiwa na siku za huduma | GTFS Schedule |
| Kusasaisha kupitia au kupokea taarifa za huduma | GTFS-RT, kulingana na mtiririko uliotangazwa |
| Kupata vituo au magari ya usafiri wa pamoja | GBFS, kulingana na data zilizotangazwa |
Mfano wa muundo: ramani inaonyesha vituo vya tramu na vituo vya baiskeli. Inatumia data za muundo kwa maeneo na hali zilizosasishwa kwa upatikanaji wa baiskeli. Tabaka hizi mbili zina mahitaji tofauti ya kuhifadhi na sasisho.
Kukadiria mipaka ya kila chanzo
Angalia matoleo, mashamba yasiyotakiwa, mfukaji na haki za matumizi. Kitambulisho kina maana tu katika muktadha wake: watengenezaji wawili wanaweza kutumia mfululizo sawa kwa vitu tofauti.
Panga pia data zinazokosekana au zilizochakaa. Orodha tupu kutoka mtiririko usiopatikana haipaswi kuonyeshwa kama huduma haipo. Epuka kubadilisha kitaifa taarifa isiyojulikana kuwa sifuri.
Kutumia mtiririko moja kwa moja au API
Unganishaji moja kwa moja hukupa jukumu la kukusanya, kuthibitisha na kutafsiri vyanzo. API inaweza kutoa mkataba wa kawaida, lakini lazima usome daira yake, onyo na masharti kila mara.
Kwa matumizi ya awali ya ROOTE, angalia jinsi ya kutafuta vituo karibu kwa API. Anza na hitaji la kiolesura chako, kisha angalia mashamba yaliyopo kweli.
Soma vipande na chagua usanifu
Katika GTFS Schedule, kipande cha stop_times.txt kinaunganisha safari, kituo na kupita kwa ratiba. Mfano uliofupishwa hapa chini ni wa mafunzo: hauwakilishi seti kamili ya GTFS na vitambulisho vyake vinapaswa kuunganishwa na trips.txt, stops.txt na kalenda.
Kwa GTFS Realtime, tafuta kifungu kinachofaa: TripUpdate inaweza kusasisha muda wa kupita, VehiclePosition inaeleza nafasi, na Alert hutuma taarifa za huduma. Nafasi ya gari si makisio ya kuwasili moja kwa moja. Muundo unaotumika ni Protocol Buffers; uwakilishi wa JSON wa uchunguzi si mtiririko wa binary msingi.
Katika GBFS, station_information inaeleza vituo wakati station_status inaeleza hali zao zilizochapishwa. Majina ya hesabu fulani na faili zinazopatikana hubadilika kulingana na toleo. Kipande cha JSON kilicho hapa chini kinaonyesha GBFS 2.3 na maeneo yake num_bikes_available na num_docks_available; hakikisha toleo kabla ya kutumia mfano.
Ramani ya maeneo inaweza kuanza na data muundo. Skrini ya mizunguko ijayo inahitaji sasisho zinazolingana na kurudi kwa ratiba kwa uwazi. Skrini ya baiskeli zinazopatikana inapaswa kusimamia hesabu, vigezo vya kukodisha na uhalali wa muda. Skrini hizi tatu hazishiriki sera moja ya kuhifadhi kwa moja kwa moja.
# 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
}Panga upatikanaji wa baiskeli na uhalisi wake
Chagua API au MCP kwa bidhaa yako
Maswali yanayoulizwa mara kwa mara
Je, GTFS ina data za wakati halisi moja kwa moja?
Hapana. GTFS Schedule inaelezea huduma iliyopangwa; taarifa za wakati halisi hutoka kwenye mtiririko mwingine, hasa GTFS-RT.
Je, GBFS inaweza kufungua baiskeli?
Inaelezea huduma na data za umma zinazohusiana. Ushirikiano wa kukodisha hutegemea uwezo unaotolewa na mtoaji huduma.
Je, muundo wa kawaida huhakikisha upatikanaji kamili?
Hapana. Muundo unaeleza tu muundo wa data; upatikanaji na taarifa zinazotangazwa hutegemea vyanzo.