GTFS Schedule, planlanmış ulaşım teklifini tanımlar. GTFS Realtime, genellikle GTFS-RT olarak anılır, hizmetle ilgili güncel bilgileri iletir. GBFS, istasyonlar ve yayınlanan akışlara göre mevcut araçlar dahil olmak üzere paylaşım mobilite hizmetlerini tanımlar. Uygulamanızın çözmesi gereken soruya göre formatı seçin.
Bu formatlar verileri organize eder; her yerde kullanılabilirliklerini veya her akışın kalitesini garanti etmezler.
Planlanmış teklifi temsil etmek için GTFS
Bir GTFS Schedule seti, özellikle işletmeciler, duraklar, hatlar, seferler ve geçişlerini tanımlayan tablo dosyalarını bir araya getirir. Takvimler ilgili günleri gösterir. Dosyalar kimliklerle ilişkilendirilir. GTFS Schedule Referansı.
"Bu durak nerede?" veya "Bu servis için hangi geçiş planlandı?" gibi sorulara yanıt verir. Saatleri kullanmak için takvimi ve dosyalar arasındaki ilişkileri yorumlamalısınız.
Yalnızca durak listesi okumak, geçişleri yeniden oluşturmak için yeterli değildir. Tersine, bir durak konumu, saatleri göstermeden faydalı olabilir.
Hizmet bilgilerini güncellemek için GTFS-RT
GTFS Realtime kurs güncellemeleri, araç konumları ve uyarılar sağlayabilir. Kurs güncellemeleri özellikle geçişler ve servis değişikliklerini kapsar. Akışlar, yapılandırılmış bir seri hale getirme formatı olan Protocol Buffers kullanır. GTFS Realtime Girişi.
Bir veri sağlayıcı bazı kategorileri yayınlayabilir, diğerlerini sağlamayabilir. Konum akışının varlığı tüm duraklar için tahmin garantisi vermez.
Arayüz için planlanan geçiş ve güncellenmiş tahmin arasındaki farkı ayırın. Bizim rehberimiz teorik ve gerçek zamanlı saatler bu farkı kullanıcı perspektifinden açıklar.
Paylaşılan mobilite için GBFS
GBFS, JSON akışları kullanarak paylaşılan mobilite hizmetini tanımlar. Sisteme ve sürüme göre, istasyonları, durumlarını, araçları ve hizmetin diğer özelliklerini içerebilir. Dokümantasyon özellikle istasyon bilgileri ve mevcut durumları ayırır. GBFS Dokümantasyonu.
Uygulamanızda nispeten stabil konumları hızlı değişen durumlardan ayırın. Yorumlama sırasında format sürümünü ve ilgili zaman damgasını koruyun.
Mevcudiyet akışı rezervasyon veya kilit açma API'si değildir. Teklifi keşfetmeye yardımcı olur; kiralama operasyonu ilgili hizmete aittir.
Kullanım durumuna göre karşılaştırma
| İhtiyaç | İncelenecek format |
|---|---|
| Planlanmış durakları ve hatları tanımlamak | GTFS Schedule |
| Planlanan geçişleri ve servis günlerini yorumlamak | GTFS Schedule |
| Geçişleri güncellemek veya hizmet bilgisi almak | GTFS-RT, yayınlanan akışlara bağlı olarak |
| Paylaşılan mobilite istasyonlarını veya araçlarını bulmak | GBFS, yayınlanan verilere bağlı olarak |
Tasarım örneği: bir harita tramvay duraklarını ve bisiklet istasyonlarını gösteriyor. Konumlar için yapısal verileri, bisiklet bulunabilirliği için güncel durumları kullanır. İki katmanın önbellekleme ve güncelleme ihtiyaçları farklıdır.
Her kaynağın sınırlarını planlayın
Sürümleri, isteğe bağlı alanları, kapsama alanını ve kullanım haklarını kontrol edin. Bir kimlik sadece kendi bağlamında anlamlıdır: iki sağlayıcı farklı varlıklar için aynı dizgileri kullanabilir.
Eksik veya eski verileri de hesaba katın. Erişilemeyen bir akıştan boş liste alınması, hizmet yokluğu olarak gösterilmemelidir. Bilinmeyen bir bilgiyi sessizce sıfırla değiştirmekten kaçının.
Akışları doğrudan kullanmak mı yoksa API üzerinden mi
Doğrudan entegrasyon, kaynakları toplama, doğrulama ve yorumlama sorumluluğunu size bırakır. API ortak bir sözleşme sunabilir ancak kapsamını, uyarılarını ve koşullarını her zaman okumalısınız.
İlk ROOTE kullanım durumu için şuraya bakın: API ile yakınlardaki durakları nasıl arayacağınızı öğrenin. Öncelikle arayüz gereksiniminizden başlayın, ardından gerçek kullanımda mevcut alanları kontrol edin.
Alıntıları okumak ve bir mimari seçmek
GTFS Schedule’da, stop_times.txt dosyasından bir alıntı bir seferi, bir durağı ve planlı bir geçişi bağlar. Aşağıdaki sınırlı örnek öğreticidir: tam bir GTFS paketi değildir ve kimlikleri trips.txt, stops.txt ve takvimlerle ilişkilendirilmelidir.
GTFS Realtime için, faydalı varlıkları arayın: TripUpdate bir geçişi güncelleyebilir, VehiclePosition bir konumu tanımlar ve Alert servis bilgisi iletir. Bir araç konumu otomatik olarak varış tahmini değildir. Aktarılan format Protocol Buffers’dır; tanısal JSON temsili referans ikili akış değildir.
GBFS’de, station_information istasyonları tanımlarken station_status onların yayımlanan durumlarını açıklar. Bazı sayaç isimleri ve mevcut dosyalar sürüme göre değişir. Aşağıdaki JSON alıntısı GBFS 2.3 ve num_bikes_available ile num_docks_available alanlarını gösterir; örnek almadan önce sürümü kontrol edin.
Bir konum haritası yapısal verilerle başlayabilir. Bir sonraki geçişler ekranı ilgili güncellemeleri ve açıkça planlanmış bir yedeklemeyi gerektirir. Bir mevcut bisiklet ekranı sayaçları, kiralama koşullarını ve zaman geçerliliğini yönetmelidir. Bu üç ekran otomatik olarak aynı önbellek politikasını paylaşmaz.
# 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
}Bisiklet kullanılabilirliği ve güncelliği biçimlendirmek
Ürününüz için bir API veya MCP seçmek
Sıkça Sorulan Sorular
GTFS otomatik olarak gerçek zamanlı bilgi içerir mi?
Hayır. GTFS Schedule planlanmış teklifi temsil eder; güncel bilgiler GTFS-RT gibi diğer akışlardan sağlanır.
GBFS bisiklet kilidini açmaya olanak tanır mı?
Hizmeti ve açık verileri tanımlar. Kiralama operatörün sunduğu yetenekler aracılığıyla yapılır.
Standart bir format tam kapsam garantisi verir mi?
Hayır. Format yapıyı tanımlar; kapsama ve yayınlanan bilgiler kaynaklara bağlıdır.