GTFS Realtime Ringkasan¶
Mulai¶
Memberikan pembaruan data transit kepada pengguna secara real time sangat meningkatkan pengalaman mereka terhadap layanan transit Anda. Memberikan informasi terkini tentang waktu kedatangan dan keberangkatan saat ini memungkinkan pengguna untuk merencanakan perjalanan mereka dengan lancar. Akibatnya, jika terjadi keterlambatan yang tidak menguntungkan, pengendara akan lega mengetahui bahwa mereka dapat tinggal di rumah sedikit lebih lama.
GTFSRealtime adalah spesifikasi umpan yang memungkinkan agen transportasi umum untuk menyediakanRealtime update tentang armada mereka untuk pengembang aplikasi. Ini adalah perpanjangan dari GTFS (General Transit Feed Specification ), format data terbuka untuk jadwal transportasi umum dan informasi geografis terkait.GTFSRealtime dirancang di sekitar kemudahan implementasi, bagusGTFS interoperabilitas dan fokus pada informasi penumpang.
Spesifikasi ini dirancang melalui kemitraan awal dengan agensi mitra Pembaruan Transit Langsung , sejumlah pengembang angkutan umum dan Google. Spesifikasi diterbitkan di bawah Lisensi Apache 2.0 .
Bagaimana cara memulai?¶
- Lanjutkan membaca ikhtisar di bawah ini.
- Tentukan entitas feed mana yang akan Anda sediakan.
- Lihatlah contoh feed .
- Buat feed Anda sendiri menggunakan referensi .
- Publikasikan umpan Anda .
Ikhtisar tentangGTFSRealtime feed¶
Spesifikasi saat ini mendukung jenis informasi berikut:
- Pembaruan perjalanan - penundaan, pembatalan, perubahan rute
- Peringatan layanan - berhenti bergerak, peristiwa tak terduga yang memengaruhi stasiun, rute, atau seluruh jaringan
- Posisi kendaraan - informasi tentang kendaraan termasuk lokasi dan tingkat kemacetan
Umpan dapat, meskipun tidak diharuskan, menggabungkan entitas dari jenis yang berbeda. Umpan disajikan melalui HTTP dan sering diperbarui. File itu sendiri adalah file biner biasa, jadi semua jenis server web dapat meng-host dan melayani file (protokol transfer lain mungkin juga digunakan). Sebagai alternatif, server aplikasi web juga dapat digunakan yang sebagai respons terhadap permintaan GET HTTP yang valid akan mengembalikan umpan. Tidak ada batasan tentang seberapa sering atau metode yang tepat tentang bagaimana feed harus diperbarui atau diambil.
KarenaGTFSRealtime memungkinkan Anda untuk menyajikan status aktual armada Anda, umpan perlu diperbarui secara berkala - sebaiknya setiap kali data baru masuk dari sistem Lokasi Kendaraan Otomatis Anda.
Selengkapnya tentang entitas feed...
Format data¶
ItuGTFSRealtime format pertukaran data didasarkan pada Protocol Buffer
Buffer protokol adalahlanguage - dan mekanisme platform-netral untuk membuat serialisasi data terstruktur (pikirkan XML, tetapi lebih kecil, lebih cepat, dan lebih sederhana). Struktur data didefinisikan dalam gtfs-realtime.proto, yang kemudian digunakan untuk menghasilkan kode sumber agar mudah membaca dan menulis data terstruktur Anda dari dan ke berbagai aliran data, menggunakan berbagai bahasa – misalnyaJava , C++ atauPython .
Lebih lanjut tentang Protokol Buffer... .
Struktur data¶
Hirarki elemen dan definisi tipenya ditentukan dalam gtfs-realtime.proto file.
File teks ini digunakan untuk menghasilkan perpustakaan yang diperlukan dalam pilihan pemrograman Andalanguage. Pustaka ini menyediakan kelas dan fungsi yang diperlukan untuk menghasilkanGTFSRealtime feed. Pustaka tidak hanya membuat pembuatan feed lebih mudah tetapi juga memastikan bahwa hanya feed yang valid yang diproduksi.
Selengkapnya tentang struktur data...
Mendapatkan bantuan¶
Untuk berpartisipasi dalam diskusi seputarGTFSRealtime dan menyarankan perubahan dan penambahan spesifikasi, bergabunglah dengan GTFS Realtime mailing list](https://groups.google.com/group/gtfs-realtime) dan ikuti percakapan di repositori Google/transit GitHub .
Google Maps dan Pembaruan Transit Langsung¶
Salah satu kemungkinan aplikasi yang menggunakanGTFSRealtime adalah Pembaruan Transit Langsung , fitur dalam Google Maps yang memberi penggunaRealtime informasi angkutan. Jika Anda bekerja untuk agen transportasi umum yang tertarik untuk menyediakanRealtime pembaruan Google Maps, kunjungi Laman Mitra Google Transit .