GTFS Schedule garraio eskaintza planifikatua deskribatzen du. GTFS Realtime, maiz GTFS-RT deitzen dena, zerbitzua buruzko informazio eguneratuak bidaltzen ditu. GBFS mugikortasun partekatuko zerbitzuak deskribatzen ditu, bereziki haien geltokiak eta argitaratutako fluxuetan oinarritutako ibilgailu erabilgarriak. Aukeratu formatua zure aplikazioak erantzun behar duen galderaren arabera.
Formatu hauek datuak antolatzen dituzte; ez dute bermatzen nonahi eskuragarriak izatea edo fluxu bakoitzaren kalitatea.
GTFS eskaintza planifikatua adierazteko
GTFS Schedule multzo batek fitxategi taulatuak batzen ditu, operadoreak, geldialdiak, lerroak, bidaiak eta haien igarotzeak barne. Egutegiek egun egokiak adierazten dituzte. Fitxategiak identifikatzaileekin lotzen dira. GTFS Schedule erreferentzia.
Galdera hauei erantzuteko balio du, hala nola “non dago geldialdi hau?” edo “zer ibilbide dago zerbitzu honetarako?”. Ordutegi bat erabiltzeko, egutegia eta fitxategien arteko harremanak interpretatu behar dira.
Geldialdien zerrenda bat irakurtzea ez da nahikoa ibilbideak berreskuratzeko. Aldiz, geldialdi baten kokapena erabilgarria izan daiteke ordutegirik agertu gabe.
GTFS-RT zerbitzu informazioa eguneratzeko
GTFS Realtime bidaiaren eguneratzeak, ibilgailuen kokapenak eta alerta mezularitza eskaintzen ditu. Bidaiaren eguneratzeek igarotzeak eta zerbitzu aldaketak biltzen dituzte. Fluxuak Protocol Buffers erabiltzen ditu, formatua serializazio egituradunean. GTFS Realtime sarrera.
Ekoizle batek kategorien batzuk soilik argitaratu ditzake beste guztiak ematen ez dituela bermatuz. Kokapen fluxu baten presentziak ez du bermatzen geldialdi guztietarako estimazioak egotea.
Interfazean, bereiz ezazu igarotze planifikatua eta eguneratutako estimazioa. Gure gida ordutegi teorikoak eta denbora erreala erabiltzailearen ikuspegitik aldea azaltzen du.
GBFS mugikortasun partekaturako
GBFS JSON fluxuak erabiltzen ditu mugikortasun partekaturako zerbitzu bat deskribatzeko. Sistema eta bertsioaren arabera, geltokiak, haien egoera, ibilgailuak eta zerbitzuaren bestelako ezaugarriak adieraz ditzakete. Dokumentazioak geldialdi informazioa eta erabilgarritasun egoerak bereizten ditu. GBFS dokumentazioa.
Bereizi zure aplikazioan kokapen egonkorrak eta azkar aldatzen diren egoerak. Mantendu formatua bertsio eta denbora marka egokiak interpretatzean.
Esleipen fluxu bat ez da erreserba edo giltzapatzeko API bat. Eskaria ezagutzeko laguntza ematen du; alokairua zerbitzuari dagokio.
Aukeratu erabilera kasuaren arabera
| Beharra | Aztertu beharreko formatua |
|---|---|
| Geltoki eta lerro planifikatuak deskribatu | GTFS Schedule |
| Igarotze aurreikusitak eta zerbitzu egunak interpretatu | GTFS Schedule |
| Igarotzeak eguneratu edo zerbitzu informazioa jaso | GTFS-RT, argitaratutako fluxuen arabera |
| Mugikortasun partekatuko geltoki edo ibilgailuak kokatu | GBFS, argitaratutako datuaren arabera |
Diseinu adibidea: mapa batek tram geltokiak eta bizikleta geltokiak erakusten ditu. Leku egitura datuak erabiltzen ditu kokapenetarako, eta egoera eguneratuak bizikleten erabilgarritasunarako. Bi geruzek cache eta eguneratze beharrak dituzte bereizita.
Iturri bakoitzaren mugak aurreikusi
Baliogabetasunak, eremu aukerak, estaldura eta erabilera eskubideak egiaztatu. Identifikatzaile bat testuinguruan bakarrik du zentzua: ekoizle desberdinek kate berberak erabili ditzakete entitate desberdinetarako.
Galdutako edo iraungitako datuak ere aurreikusi. Fluxu bat baliogabe denean hutsik datorren zerrenda ez da zerbitzua ez dagoela aurkeztu behar. Ez ordezkatu isilpean ezezagunen bat zero balioarekin.
Fluxuak zuzenean erabili ala API bat?
Integratzio zuzena zure ardura da iturriak biltzea, balidatzea eta interpretatzea. API batek kontratu komuna eskaintzen du, baina beti irakurri estaldura, oharrak eta baldintzak.
ROOTE lehen kasu batentzat, begiratu API batekin gertuko geltokiak nola bilatu. Has zaitez zure interfaze beharrarekin, eta ondoren egiaztatu eremu eskuragarriak.
Ateratako zatiak irakurri eta arkitektura bat aukeratu
GTFS Schedule-en, stop_times.txt fitxategiko zatitxo batek lasterketa bat, geldialdi bat eta planifikatutako pasabide bat lotzen ditu. Beheko adibide laburrak hezitzailea da: ez du GTFS multzo osoa osatzen eta bere identifikatzaileek trips.txt, stops.txt eta egutegiekin lotu behar dira.
GTFS Denbora Errealekoan, bilatu entitate erabilgarria: TripUpdate batek pasabide bat eguneratu dezake, VehiclePosition batek posizio bat deskribatzen du, eta Alert batek zerbitzu informazioa transmititzen du. Ibilgailu posizio bat ez da automatikoki irteera estimazioa. Transmititutako formatua Protocol Buffers da; diagnostikako JSON errepresentazio batek ez du erreferentziazko fluxu binariorik ordezkatzen.
GBFS-en, station_information-ek geltokiak deskribatzen ditu, eta station_status-ek euren egoerak argitaratuak deskribatzen ditu. Kontagailu batzuen izenak eta erabilgarri dauden fitxategiak bertsioaren arabera aldatzen dira. Beheko JSON zatitxoak GBFS 2.3 eta bere num_bikes_available eta num_docks_available aldagaiak adierazten ditu; eredu bat hartu aurretik, egiaztatu bertsioa.
Lekuen mapa bat egitura-datuetatik abiatu daiteke. Hurrengo pasabideen pantaila batek eguneratze egokiak eta planifikatutako erorketa bat behar ditu gero. Bizikleta eskurgarri pantailak kontagailuak, alokairu baldintzak eta denbora egokitasuna kudeatu behar ditu. Pantaila hauetako hiruek ez dute automatikoki cache politika bera partekatzen.
# 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
}Bizikleta eskuragarritasuna eta freskotasuna formatatzea
Zure produktuarentzako API edo MCP bat hautatzea
Ohiko galderak
GTFS-k automatikoki ba al du denbora errealeko informaziorik?
Ez. GTFS Schedule planifikatutako eskaintza adierazten du; informazio eguneratuak beste fluxuek, hala nola GTFS-RT-k, dituzte.
GBFS-k bizikleta bat giltzapetzea ahalbidetzen al du?
Zerbitzua eta bere datu publikoa deskribatzen ditu. Alokairua operadorearen gaitasunen esku dago.
Formatu estandar batek bermatzen al du estaldura osoa?
Ez. Formatua egitura definitzen du; estaldura eta argitaratutako informazioa iturriaren arabera aldatzen dira.