Referensi

Dokumen ini menentukan format dan struktur file yang membentuk set data GTFS.

Daftar isi

  1. Definisi istilah
  2. Jenis kolom
  3. File set data
  4. Persyaratan file
  5. Definisi kolom

Definisi istilah

Bagian ini mendefinisikan istilah yang digunakan di seluruh dokumen ini.

  • Set data - Set file lengkap yang didefinisikan oleh referensi spesifikasi ini. Mengubah set data akan membuat set data versi baru. Set data harus dipublikasikan di URL permanen publik, termasuk nama file zip. (mis., https://www.agency.org/gtfs/gtfs.zip).
  • Catatan - Struktur data dasar terdiri atas sejumlah nilai berbeda pada kolom yang mendeskripsikan satu entitas (mis. perusahaan transportasi umum, perhentian, rute, dsb.). Direpresentasikan sebagai baris dalam tabel.
  • Kolom - Properti objek atau entitas. Direpresentasikan sebagai kolom dalam tabel.
  • Nilai Kolom - Entri individual dalam kolom. Direpresentasikan sebagai satu sel dalam tabel.
  • Wajib - Kolom harus disertakan dalam set data, dan nilai harus diberikan dalam kolom tersebut untuk setiap catatan. Beberapa kolom wajib mengizinkan string kosong sebagai nilai (ditunjukkan dalam spesifikasi ini sebagai kosong). Untuk memasukkan string kosong, cukup hilangkan teks di antara koma untuk kolom tersebut.
  • Opsional - Kolom dapat dihapus dari set data. Jika kolom opsional disertakan, sebagian entri dalam kolom tersebut dapat berupa string kosong. Untuk memasukkan string kosong, cukup hilangkan teks di antara koma untuk kolom tersebut. Kolom yang dihapus setara dengan kolom yang seluruhnya kosong.
  • Wajib bersyarat - Kolom atau file bersifat wajib berdasarkan ketentuan tertentu, yang diuraikan dalam deskripsi kolom atau file. Jika di luar kondisi tersebut, kolom atau file ini bersifat opsional.
  • Hari layanan - Hari layanan adalah jangka waktu yang digunakan untuk menunjukkan penjadwalan rute. Definisi persis hari layanan bervariasi dari satu perusahaan ke perusahaan lainnya, tetapi hari layanan sering tidak sesuai dengan hari kalender. Hari layanan dapat melampaui jam 24:00:00 jika layanan dimulai pada satu hari dan berakhir pada hari berikutnya. Misalnya, layanan yang berjalan dari jam 08:00:00 pada hari Jumat hingga jam 02:00:00 pada hari Sabtu dapat dinyatakan sebagai berjalan dari jam 08:00:00 hingga jam 26:00:00 pada satu hari layanan.

Jenis kolom

  • Warna - Warna yang dienkode sebagai angka heksadesimal enam digit. Lihat https://htmlcolorcodes.com untuk menghasilkan nilai valid ("#" awal tidak disertakan).
    Contoh: FFFFFF untuk putih, 000000 untuk hitam, atau 0039A6 untuk garis A,C,E di NYMTA.
  • Kode Mata Uang - Kode mata uang alfabet ISO 4217. Untuk daftar mata uang saat ini, lihat https://en.wikipedia.org/wiki/ISO_4217#Active_codes.
    Contoh: CAD untuk dolar Kanada, EUR untuk euro, atau JPY untuk yen Jepang.
  • Tanggal - Hari layanan dalam format YYYYMMDD. Karena waktu dalam hari layanan dapat melampaui jam 24:00:00, hari layanan sering berisi informasi untuk hari berikutnya.
    Contoh: 20180913 untuk 13 September 2018.
  • Email - Alamat email.
    Contoh: example@example.com
  • Enum - Opsi yang berasal dari kumpulan konstanta standar yang ditentukan di kolom "Deskripsi".
    Contoh: Kolom route_type berisi 0 untuk trem, 1 untuk kereta bawah tanah...
  • ID - Nilai kolom ID adalah ID internal, yang tidak ditujukan untuk ditampilkan kepada penumpang, dan merupakan urutan karakter UTF-8. Sebaiknya hanya gunakan karakter ASCII yang dapat dicetak. ID yang ditentukan dalam satu file .txt sering dirujuk di file .txt lainnya.
    Contoh: Kolom stop_id dalam stops.txt adalah ID. Kolom stop_id di stop_times.txt adalah ID yang merujuk stops.stop_id.
  • Kode Bahasa: Kode bahasa IETF BCP 47. Untuk membaca pengantar tentang IETF BCP 47, lihat http://www.rfc-editor.org/rfc/bcp/bcp47.txt dan http://www.w3.org/International/articles/language-tags/.
    Contoh: en untuk bahasa Inggris, en-US untuk bahasa Inggris Amerika, atau de untuk bahasa Jerman.
  • Lintang - Lintang WGS84 dalam derajat desimal. Nilai harus lebih besar dari atau sama dengan -90.0 dan kurang dari atau sama dengan 90.0.
    Contoh: 41.890169 untuk Koloseum di Roma.
  • Bujur - Bujur WGS84 dalam derajat desimal. Nilai harus lebih besar dari atau sama dengan -180.0 dan kurang dari atau sama dengan 180.0.
    Contoh: 12.492269 untuk Koloseum di Roma.
  • Bilangan Mengambang Non-negatif - Bilangan titik mengambang yang lebih besar atau sama dengan 0.
  • Bilangan Bulat Non-negatif - Bilangan bulat yang lebih besar atau sama dengan 0.
  • Nomor telepon - Nomor telepon.
  • Waktu - Waktu dalam format HH:MM:SS format (H:MM:SS juga diterima). Waktu diukur dari "tengah hari minus 12j" dari hari layanan (faktanya tengah malam, kecuali untuk hari saat terjadi pergantian waktu musim panas. Untuk mendapatkan informasi lebih lanjut, lihat artikel panduan. Untuk waktu yang terjadi setelah tengah malam, masukkan waktu sebagai nilai yang lebih besar daripada 24:00:00 dalam HH:MM:SS waktu lokal untuk hari saat dimulainya jadwal perjalanan.
    Contoh: 14:30:00 untuk 14.30 atau 25:35:00 untuk 1.35 pada hari berikutnya.
  • Teks - String karakter UTF-8 yang ditujukan untuk ditampilkan dan karenanya harus dapat dibaca manusia.
  • Zona waktu - Zona waktu TZ dari https://www.iana.org/time-zones. Nama zona waktu tidak boleh berisi karakter spasi, tetapi dapat berisi garis bawah. Lihat http://en.wikipedia.org/wiki/List_of_tz_zones untuk mendapatkan daftar nilai yang valid.
    Contoh: Asia/Tokyo, America/Los_Angeles, atau Africa/Cairo.
  • URL - URL yang sepenuhnya memenuhi syarat yang menyertakan http:// atau https://, dan karakter khusus apa pun dalam URL harus di-escape dengan benar. Lihat http://www.w3.org/Addressing/URL/4_URI_Recommentations.html berikut untuk mengetahui cara membuat nilai URL yang sepenuhnya memenuhi syarat.

File set data

Spesifikasi ini menentukan file berikut:

Nama file Wajib Definisi
agency.txt Wajib Perusahaan transportasi umum dengan layanan direpresentasikan dalam set data ini.
stops.txt Wajib Perhentian tempat kendaraan menjemput atau mengantar penumpang. Juga menentukan stasiun dan pintu masuk stasiun.
routes.txt Wajib Rute transportasi umum. Rute adalah grup perjalanan yang ditampilkan kepada penumpang sebagai layanan tunggal.
trips.txt Wajib Perjalanan untuk setiap rute. Perjalanan adalah urutan dari dua perhentian atau lebih yang terjadi selama jangka waktu spesifik.
stop_times.txt Wajib Waktu saat kendaraan tiba di dan berangkat dari perhentian untuk setiap perjalanan.
calendar.txt Wajib bersyarat Tanggal layanan yang ditentukan menggunakan jadwal mingguan dengan tanggal mulai dan akhir. File ini wajib ada kecuali jika semua tanggal layanan ditentukan di calendar_dates.txt.
calendar_dates.txt Wajib bersyarat Pengecualian untuk layanan yang ditentukan di calendar.txt. Jika calendar.txt dihapus, calendar_dates.txt wajib ada dan harus berisi semua tanggal layanan.
fare_attributes.txt Opsional Informasi tarif untuk rute perusahaan transportasi umum.
fare_rules.txt Opsional Aturan untuk menerapkan tarif itinerari.
shapes.txt Opsional Aturan untuk memetakan jalur perjalanan kendaraan, terkadang disebut sebagai penyelarasan rute.
frequencies.txt Opsional Headway (waktu antara perjalanan) untuk layanan berbasis headway atau representasi terkompresi untuk layanan jadwal tetap.
transfers.txt Opsional Aturan untuk membuat koneksi di titik transfer antara rute.
pathways.txt Opsional Jalur yang menghubungkan semua lokasi dalam stasiun.
levels.txt Opsional Tingkat dalam stasiun.
feed_info.txt Wajib bersyarat Metadata set data, termasuk informasi penayang, versi, dan masa berlaku.
translations.txt Opsional Informasi terjemahan dari perusahaan transportasi umum.
attributions.txt Opsional Menentukan atribusi yang diterapkan ke set data.

Persyaratan file

Persyaratan berikut berlaku untuk format dan konten file set data:

  • Semua file harus disimpan sebagai teks yang dipisahkan koma.
  • Baris pertama dari setiap file harus berisi nama kolom. Setiap subbagian Definisi kolom sesuai dengan salah satu file dalam set data GTFS dan mencantumkan nama kolom yang dapat digunakan dalam file tersebut.
  • Semua nama kolom peka huruf besar-kecil.
  • Nilai kolom tidak boleh berisi tab, enter, atau baris baru.
  • Nilai kolom yang berisi tanda petik atau koma harus diapit oleh tanda petik. Selain itu, setiap tanda petik pada nilai kolom harus didahului tanda petik. Hal ini sesuai dengan cara Microsoft Excel menghasilkan file yang dipisahkan dengan koma (CSV). Untuk mendapatkan informasi lebih lanjut tentang format file CSV, lihat http://tools.ietf.org/html/rfc4180. Contoh berikut menunjukkan bagaimana nilai kolom akan muncul dalam file yang dipisahkan koma:
    • Nilai kolom asli: Contains "quotes", commas and text
    • Nilai kolom dalam file CSV: "Contains ""quotes"", commas and text"
  • Nilai kolom tidak boleh berisi tag HTML, komentar, atau escape sequence.
  • Hapus spasi ekstra antara kolom atau nama kolom. Sebagian besar parser menganggap spasi sebagai bagian dari nilai, yang dapat mengakibatkan error.
  • Setiap baris harus berakhir dengan karakter pemisah baris CRLF atau LF.
  • File harus dienkode dalam UTF-8 untuk mendukung semua karakter Unicode. File yang menyertakan karakter byte-order mark (BOM) Unicode dapat diterima. Lihat http://unicode.org/faq/utf_bom.html#BOM untuk informasi selengkapnya tentang karakter BOM dan UTF-8.
  • Semua file set data harus di-zip bersama-sama.

Definisi kolom

agency.txt

File: Wajib

Nama Kolom Jenis Wajib Deskripsi
agency_id ID Wajib Bersyarat Mengidentifikasi merek transportasi umum, yang sering kali identik dengan perusahaan transportasi umum. Perhatikan bahwa dalam beberapa kasus, seperti saat satu perusahaan mengoperasikan beberapa layanan terpisah, perusahaan dan merek akan berbeda. Dokumen ini menggunakan istilah "perusahaan" sebagai pengganti "merek". Set data dapat berisi data dari berbagai perusahaan. Kolom ini wajib ada jika set data berisi data untuk beberapa perusahaan transportasi umum. Jika tidak, kolom ini bersifat opsional.
agency_name Teks Wajib Nama lengkap perusahaan transportasi umum.
agency_url URL Wajib URL perusahaan transportasi umum.
agency_timezone Zona waktu Wajib Zona waktu tempat perusahaan transportasi umum berada. Jika beberapa perusahaan transportasi umum ditentukan dalam set data, setiap perusahaan transportasi umum harus memiliki agency_timezone yang sama.
agency_lang Kode bahasa Opsional Bahasa utama yang digunakan oleh perusahaan transportasi umum. Kolom ini membantu konsumen GTFS memilih aturan penggunaan huruf besar dan setelan spesifik per bahasa lainnya untuk set data.
agency_phone Nomor telepon Opsional Nomor telepon suara untuk perusahaan yang ditentukan. Kolom ini merupakan nilai string yang menampilkan nomor telepon sebagaimana umumnya untuk area layanan perusahaan tersebut. Ini bisa dan harus berisi tanda baca untuk mengelompokkan digit nomor tersebut. Teks yang dapat dihubungi (misalnya, 503-238-RIDE dari TriMet) diizinkan, tetapi kolom tidak boleh berisi teks deskriptif lainnya.
agency_fare_url URL Opsional URL halaman web yang memungkinkan penumpang membeli tiket atau instrumen tarif lainnya untuk perusahaan tersebut secara online.
agency_email Email Opsional Alamat email yang secara aktif dipantau oleh departemen layanan pelanggan perusahaan transportasi umum. Alamat email ini harus merupakan titik kontak langsung yang dapat digunakan penumpang transportasi umum untuk menghubungi perwakilan layanan pelanggan di perusahaan.

stops.txt

File: Wajib

Nama Kolom Jenis Wajib Deskripsi
stop_id ID Wajib Mengidentifikasi perhentian, stasiun, atau pintu masuk stasiun.

Istilah "pintu masuk stasiun" merujuk pada pintu masuk dan pintu keluar stasiun. Perhentian, stasiun, atau pintu masuk stasiun disebut sebagai lokasi. Beberapa rute dapat menggunakan perhentian yang sama.
stop_code Teks Opsional Teks pendek atau nomor yang mengidentifikasi lokasi untuk penumpang. Kode ini sering digunakan dalam sistem informasi transportasi umum berbasis telepon atau dicetak di papan tanda untuk mempermudah penumpang mendapatkan informasi perhentian tertentu. stop_code dapat sama seperti stop_id jika tersedia untuk publik. Kolom ini akan dibiarkan kosong untuk lokasi tanpa kode yang ditampilkan kepada penumpang.
stop_name Teks Wajib Bersyarat Nama lokasi. Gunakan nama yang akan dipahami orang dalam bahasa setempat dan internasional.

Jika lokasi adalah area naik turun (location_type=4), stop_name harus berisi nama area naik turun seperti yang ditampilkan oleh perusahaan transportasi umum. Hal ini dapat berupa satu huruf saja (seperti di beberapa stasiun kereta antarkota di Eropa), atau teks seperti “Area naik turun kursi roda” (Kereta Bawah Tanah NYC) atau “Kepala kereta api pendek” (Paris’ RER).

Wajib Bersyarat:
• Wajib untuk lokasi yang merupakan perhentian (location_type=0), stasiun (location_type=1), atau pintu masuk/keluar (location_type=2).
• Opsional untuk lokasi yang merupakan node umum (location_type=3) atau area naik turun (location_type=4).
stop_desc Teks Opsional Deskripsi lokasi yang memberikan informasi kualitas yang bermanfaat. Jangan hanya menggandakan nama lokasi.
stop_lat Lintang Wajib Bersyarat Lintang lokasi.

Wajib Bersyarat:
• Wajib untuk lokasi yang merupakan perhentian (location_type=0), stasiun (location_type=1), atau pintu masuk/keluar (location_type=2).
• Opsional untuk lokasi yang merupakan node umum (location_type=3) atau area naik turun (location_type=4).
stop_lon Bujur Wajib Bersyarat Bujur lokasi.

Wajib Bersyarat:
• Wajib untuk lokasi yang merupakan perhentian (location_type=0), stasiun (location_type=1), atau pintu masuk/keluar (location_type=2).
• Opsional untuk lokasi yang merupakan node umum (location_type=3) atau area naik turun (location_type=4).
zone_id ID Wajib Bersyarat Menentukan zona tarif untuk perhentian. Kolom ini wajib jika ada informasi tarif menggunakan fare_rules.txt, atau opsional jika tidak ada. Jika catatan ini merepresentasikan stasiun atau pintu masuk stasiun, zone_id diabaikan.
stop_url URL Opsional URL halaman web tentang lokasi. URL ini harus berbeda dari nilai kolom agency.agency_url dan routes.route_url.
location_type Enum Opsional Jenis lokasi:
• 0 (atau kosong): Perhentian (atau Platform). Lokasi tempat penumpang naik atau turun dari kendaraan transportasi umum. Disebut platform jika ditentukan dalam parent_station.
• 1: Stasiun. Struktur atau area fisik yang berisi satu atau beberapa platform.
• 2: Pintu Masuk/Keluar. Lokasi tempat penumpang dapat masuk atau keluar stasiun dari jalan. Jika pintu masuk/keluar milik beberapa stasiun, ini dapat dihubungkan dengan jalur menuju keduanya, tetapi penyedia data harus memilih salah satunya sebagai induk.
• 3: Node Umum. Lokasi dalam stasiun, yang tidak sesuai dengan location_type, lainnya, yang dapat digunakan untuk menghubungkan jalur yang ditentukan di pathways.txt.
• 4: Area Naik Turun. Lokasi spesifik pada platform, tempat penumpang dapat naik dan/atau keluar dari kendaraan.
parent_station ID yang merujuk stops.stop_id Wajib Bersyarat Menentukan hierarki di antara berbagai lokasi yang ditentukan di stops.txt. Hal ini berisi ID lokasi induk, sebagai berikut:
• Perhentian/platform (location_type=0): kolom parent_station berisi ID stasiun.
• Stasiun (location_type=1): kolom ini harus kosong.
• Pintu masuk/keluar (location_type=2) atau node umum (location_type=3): kolom parent_station berisi ID stasiun (location_type=1)
• Area Naik Turun (location_type=4): kolom parent_station berisi ID platform.

Wajib Bersyarat:
• Wajib untuk lokasi yang merupakan pintu masuk (location_type=2), node umum (location_type=3), atau area naik turun (location_type=4).
• Opsional untuk perhentian/platform (location_type=0).
• Dilarang untuk stasiun (location_type=1).
stop_timezone Zona waktu Opsional Zona waktu lokasi. Jika memiliki stasiun induk, lokasi mewarisi zona waktu stasiun induk, bukan menerapkan zona waktunya sendiri. Stasiun dan perhentian tanpa induk dengan stop_timezone kosong mewarisi zona waktu yang ditentukan oleh agency.agency_timezone. Jika nilai stop_timezone diberikan, waktu dalam stop_times.txt harus dimasukkan sebagai waktu sejak tengah malam di zona waktu yang ditentukan oleh agency.agency_timezone. Dengan begitu, nilai waktu dalam perjalanan akan selalu meningkat seiring berlangsungnya perjalanan, terlepas dari zona waktu yang dilalui oleh perjalanan.
wheelchair_boarding Enum Opsional Menunjukkan apakah naik turun kursi roda dimungkinkan dari lokasi. Opsi yang valid adalah:

Untuk perhentian tanpa induk:
0 atau kosong - Tidak ada informasi aksesibilitas untuk perhentian.
1 - Beberapa kendaraan di perhentian ini dapat dinaiki oleh penumpang dengan kursi roda.
2 - Kursi roda tidak dapat masuk ke kendaraan di perhentian ini.

Untuk perhentian turunan:
0 atau kosong - Perhentian akan mewarisi perilaku wheelchair_boarding dari stasiun induk, jika ditentukan di induk.
1 - Ada beberapa jalur yang dapat diakses dari luar stasiun ke perhentian/platform tertentu.
2 - Tidak ada jalur yang dapat diakses dari luar stasiun ke perhentian/platform tertentu.

Untuk pintu masuk/keluar stasiun:
0 atau kosong - Pintu masuk stasiun akan mewarisi perilaku wheelchair_boarding dari stasiun induk, jika ditentukan untuk induk.
1 - Pintu masuk stasiun dapat diakses kursi roda.
2 - Tidak ada jalur yang dapat diakses dari pintu masuk stasiun ke perhentian/platform.
level_id ID yang merujuk levels.level_id Opsional Tingkat lokasi. Tingkat yang sama dapat digunakan oleh beberapa stasiun yang tidak terhubung.
platform_code Teks Opsional ID platform untuk perhentian platform (perhentian milik stasiun). Hal ini hanya berupa ID platform (misalnya, G atau 3). Kata seperti "platform" atau "track" (atau kata padanan menurut bahasa feed) tidak boleh disertakan. Hal ini akan memungkinkan konsumen feed lebih mudah melakukan internasionalisasi dan melokalkan ID platform ke bahasa lain.

routes.txt

File: Wajib

Nama Kolom Jenis Wajib Deskripsi
route_id ID Wajib Mengidentifikasi rute.
agency_id ID yang merujuk agency.agency_id Wajib bersyarat Perusahaan transportasi umum untuk rute yang ditentukan. Kolom ini wajib ada jika set data memberikan data untuk rute dari beberapa perusahaan transportasi umum di agency.txt. Jika tidak, kolom ini bersifat opsional.
route_short_name Teks Wajib bersyarat Nama pendek rute. Kolom ini sering kali akan berupa ID abstrak yang singkat seperti "32", "100X", atau "Hijau" yang digunakan oleh penumpang untuk mengidentifikasi rute, tetapi tidak menunjukkan tempat-tempat yang dilayani rute. Baik route_short_name maupun route_long_name harus ditentukan, atau mungkin keduanya jika sesuai.
route_long_name Teks Wajib bersyarat Nama lengkap rute. Nama ini umumnya lebih deskriptif daripada route_short_name dan sering menyertakan tujuan atau perhentian rute. Baik route_short_name maupun route_long_name harus ditentukan, atau mungkin keduanya jika sesuai.
route_desc Teks Opsional Deskripsi rute yang memberikan informasi kualitas yang bermanfaat. Jangan hanya menggandakan nama rute.
Contoh: Kereta api “A” beroperasi antara Inwood-207 St, Manhattan dan Far Rockaway-Mott Avenue, Queens sepanjang waktu. Selain itu, dari pukul 06.00 sampai sekitar tengah malam, kereta tambahan "A" beroperasi antara Inwood-207 St dan Lefferts Boulevard (kereta biasanya melakukan pergantian antara Lefferts Blvd dan Far Rockaway).
route_type Enum Wajib Menunjukkan jenis transportasi yang digunakan pada rute. Opsi yang valid adalah:

0 - Trem atau LRT. Setiap sistem LRT atau sistem kereta jalan raya dalam area metropolitan.
1 - Kereta bawah tanah, MRT. Sistem kereta bawah tanah dalam area metropolitan.
2 - Kereta api. Digunakan untuk perjalanan antarkota atau jarak jauh.
3 - Bus. Digunakan untuk rute bus jarak pendek dan jarak jauh.
4 - Feri. Digunakan untuk layanan kapal jarak pendek dan jarak jauh.
5 - Trem kabel. Digunakan untuk kereta rel jalan raya yang kabelnya ada di bawah kendaraan, mis., kereta kabel di San Francisco.
6 - Transportasi gantung, kereta kabel gantung (mis., kereta gantung gondola, kereta gantung). Transportasi kabel dengan kabin, gerbong, gondola, atau kursi terbuka yang digantung menggunakan satu atau beberapa kabel.
7 - Funicular. Sistem kereta yang dirancang untuk tanjakan curam.
11 - Bus listrik. Bus listrik yang mengambil daya dari kabel listrik aliran atas menggunakan tiang.
12 - Monorel. Kereta dengan trek yang terdiri dari satu rel atau balok.
route_url URL Opsional URL halaman web tentang rute tertentu. Harus berbeda dari nilai agency.agency_url.
route_color Warna Opsional Penandaan warna rute yang cocok dengan material untuk publik. Default-nya putih (FFFFFF) jika dihapus atau dibiarkan kosong. Perbedaan warna antara route_color dan route_text_color harus memberikan kontras yang cukup saat dilihat di layar hitam-putih.
route_text_color Warna Opsional Warna yang dapat terlihat jelas untuk digunakan pada teks yang digambar dengan latar belakang route_color. Default-nya hitam (000000) jika dihapus atau dikosongkan. Perbedaan warna antara route_color dan route_text_color harus memberikan kontras yang cukup saat dilihat di layar hitam-putih.
route_sort_order Bilangan bulat non-negatif Opsional Menyusun rute yang ideal untuk presentasi kepada pelanggan. Rute dengan nilai route_sort_order yang lebih kecil harus ditampilkan terlebih dahulu.
continuous_pickup Enum Opsional Menunjukkan apakah penumpang dapat naik kendaraan transportasi umum di mana saja di sepanjang jalur perjalanan kendaraan. Jalur tersebut dijelaskan dengan shapes.txt pada setiap perjalanan rute. Opsi yang valid adalah:

0 - Penjemputan dengan perhentian terus-menerus.
1 atau kosong - Tidak ada penjemputan dengan perhentian terus-menerus.
2 - Harus menghubungi perusahaan untuk mengatur penjemputan dengan perhentian terus-menerus.
3 - Harus berkoordinasi dengan pengemudi untuk mengatur penjemputan dengan perhentian terus-menerus.

Perilaku penjemputan terus-menerus default yang ditetapkan di routes.txt dapat diganti di stop_times.txt.
continuous_drop_off Enum Opsional Menunjukkan apakah penumpang dapat turun dari kendaraan transportasi umum kapan saja di sepanjang jalur perjalanan kendaraan. Jalur tersebut dijelaskan dengan shapes.txt pada setiap perjalanan rute. Opsi yang valid adalah:

0 - Penurunan dengan perhentian terus-menerus.
1 atau kosong - Tidak ada penurunan dengan perhentian terus-menerus.
2 - Harus menghubungi perusahaan untuk mengatur penurunan dengan perhentian terus-menerus.
3 - Harus berkoordinasi dengan pengemudi untuk mengatur penurunan dengan perhentian terus-menerus.

Perilaku penurunan terus-menerus default yang ditetapkan di routes.txt dapat diganti di stop_times.txt.

trips.txt

File: Wajib

Nama Kolom Jenis Wajib Deskripsi
route_id ID yang merujuk routes.route_id Wajib Mengidentifikasi rute.
service_id ID yang merujuk calendar.service_id atau calendar_dates.service_id Wajib Mengidentifikasi kumpulan tanggal saat layanan tersedia untuk satu atau beberapa rute.
trip_id ID Wajib Mengidentifikasi perjalanan.
trip_headsign Teks Opsional Teks yang muncul pada tanda yang mengidentifikasi tujuan perjalanan bagi penumpang. Gunakan kolom ini untuk membedakan di antara pola layanan yang berbeda-beda di rute yang sama. Jika jurusan berubah selama perjalanan, trip_headsign dapat diganti dengan menentukan nilai untuk stop_times.stop_headsign.
trip_short_name Teks Opsional Teks yang tersedia untuk publik yang digunakan untuk mengidentifikasi perjalanan kepada penumpang, untuk mengidentifikasi nomor kereta untuk perjalanan kereta komuter. Jika penumpang biasanya tidak mengandalkan nama perjalanan, kosongkan kolom ini. Nilai trip_short_name, jika diberikan, harus secara unik mengidentifikasi perjalanan dalam satu hari layanan. Nilai ini tidak boleh digunakan untuk nama tujuan atau sebutan terbatas/ekspres.
direction_id Enum Opsional Menunjukkan arah perjalanan. Kolom ini tidak digunakan dalam pemilihan rute; kolom ini memberikan cara untuk memisahkan perjalanan berdasarkan arah saat memublikasikan jadwal. Opsi yang valid adalah:

0 - Perjalanan ke satu arah (mis. perjalanan keluar).
1 - Perjalanan ke arah sebaliknya (mis. perjalanan masuk).
Contoh: Kolom trip_headsign dan direction_id dapat digunakan bersama-sama untuk menetapkan nama perjalanan ke masing-masing arah untuk kumpulan perjalanan. File trips.txt dapat berisi catatan berikut untuk digunakan dalam tabel waktu:
trip_id,...,trip_headsign,direction_id
1234,...,Airport,0
1505,...,Downtown,1
block_id ID Opsional Mengidentifikasi blok yang mencakup perjalanan. Blok terdiri dari satu perjalanan atau beberapa perjalanan berurutan yang dilakukan menggunakan kendaraan yang sama, yang ditentukan oleh hari layanan dan block_id bersama. block_id dapat memiliki perjalanan dengan berbagai hari layanan, sehingga membentuk blok yang berbeda-beda. Lihat contoh di bawah
shape_id ID yang merujuk shapes.shape_id Wajib bersyarat Mengidentifikasi bentuk geospasial yang mendeskripsikan jalur perjalanan kendaraan untuk sebuah perjalanan.

Wajib bersyarat:
Kolom ini wajib diisi jika perjalanan memiliki perilaku berkelanjutan yang telah ditetapkan, baik di tingkat rute maupun di tingkat waktu perhentian.
Jika tidak, kolom ini bersifat opsional.
wheelchair_accessible Enum Opsional Menunjukkan aksesibilitas kursi roda. Opsi yang valid adalah:

0 atau kosong - Tidak ada informasi aksesibilitas untuk perjalanan.
1 - Kendaraan yang digunakan pada perjalanan tertentu ini dapat mengakomodasi setidaknya satu penumpang dengan kursi roda.
2 - Penumpang dengan kursi roda tidak dapat diakomodasi pada perjalanan ini.
bikes_allowed Enum Opsional Menunjukkan apakah sepeda diizinkan. Opsi yang valid adalah:

0 atau kosong - Tidak ada informasi sepeda untuk perjalanan.
1 - Kendaraan yang digunakan pada perjalanan tertentu ini dapat mengakomodasi setidaknya satu sepeda.
2 - Sepeda tidak diizinkan pada perjalanan ini.

Contoh: Blok dan hari layanan

Contoh di bawah ini valid, dengan blok berbeda setiap hari dalam seminggu.

route_id trip_id service_id block_id (waktu perhentian pertama) (waktu perhentian terakhir)
red trip_1 mon-tues-wed-thurs-fri-sat-sun red_loop 22:00:00 22:55:00
red trip_2 fri-sat-sun red_loop 23:00:00 23:55:00
red trip_3 fri-sat red_loop 24:00:00 24:55:00
red trip_4 mon-tues-wed-thurs red_loop 20:00:00 20:50:00
red trip_5 mon-tues-wed-thurs red_loop 21:00:00 21:50:00

Catatan tentang tabel di atas:

  • Pada hari Jumat hingga Sabtu pagi, misalnya, satu kendaraan mengoperasikan trip_1, trip_2, dan trip_3 (22.00 hingga 00.55). Perhatikan bahwa perjalanan terakhir terjadi pada hari Sabtu, 00:00 hingga 00:55, tetapi menjadi bagian dari “hari layanan” Jumat karena waktunya adalah 24:00:00 hingga 24:55:00.
  • Pada hari Senin, Selasa, Rabu, dan Kamis, satu kendaraan mengoperasikan trip_1, trip_4, dan trip_5 dalam blok dari 20.00 sampai 22.55.

stop_times.txt

File: Wajib

Nama Kolom Jenis Wajib Deskripsi
trip_id ID yang merujuk trips.trip_id Wajib Mengidentifikasi perjalanan.
arrival_time Waktu Wajib bersyarat Waktu kedatangan di perhentian spesifik untuk perjalanan spesifik di suatu rute. Jika tidak ada waktu terpisah untuk kedatangan dan keberangkatan di perhentian, masukkan nilai yang sama untuk arrival_time dan departure_time. Untuk waktu yang terjadi setelah tengah malam pada hari layanan, masukkan waktu sebagai nilai yang lebih besar dari 24:00:00 dalam HH:MM:SS waktu setempat untuk hari saat jadwal perjalanan dimulai.

Perhentian yang dijadwalkan tempat kendaraan secara ketat mengikuti waktu kedatangan dan keberangkatan yang ditentukan adalah timepoint. Jika perhentian ini bukan timepoint, sebaiknya berikan waktu estimasi atau interpolasi. Jika hal ini tidak tersedia, arrival_time dapat dikosongkan. Selanjutnya, tunjukkan bahwa waktu interpolasi tersebut diberikan dengan timepoint=0. Jika waktu interpolasi ditunjukkan dengan timepoint=0, timepoint harus ditunjukkan dengan timepoint=1. Berikan waktu kedatangan untuk semua perhentian yang merupakan timepoint. Waktu kedatangan harus ditetapkan untuk perhentian pertama dan terakhir dalam perjalanan.
departure_time Waktu Wajib bersyarat Waktu keberangkatan dari perhentian tertentu untuk perjalanan tertentu pada suatu rute. Untuk waktu yang terjadi setelah tengah malam pada hari layanan, masukkan waktu sebagai nilai yang lebih besar dari 24:00:00 dalam format HH:MM:SS waktu lokal untuk hari saat jadwal perjalanan dimulai. Jika tidak ada waktu terpisah untuk kedatangan dan keberangkatan di perhentian, masukkan nilai yang sama untuk arrival_time dan departure_time. Lihat deskripsi arrival_time untuk mendapatkan detail lebih lanjut tentang cara menggunakan timepoint dengan benar.

Kolom departure_time harus menentukan nilai waktu bila memungkinkan, termasuk waktu interpolasi atau waktu estimasi yang tidak mengikat di antara beberapa timepoint.
stop_id ID yang merujuk stops.stop_id Wajib Mengidentifikasi perhentian yang dilayani. Semua perhentian yang dilayani selama perjalanan harus memiliki catatan di stop_times.txt. Lokasi yang dirujuk harus berupa perhentian, bukan stasiun atau pintu masuk stasiun. Sebuah perhentian dapat dilayani beberapa kali dalam perjalanan yang sama, dan beberapa perjalanan dan rute mungkin melayani perhentian yang sama.
stop_sequence Bilangan bulat non-negatif Wajib Urutan perhentian untuk perjalanan tertentu. Nilai harus meningkat di sepanjang perjalanan, tetapi tidak harus berturut-turut.
Contoh: Lokasi pertama pada perjalanan dapat memiliki stop_sequence=1, lokasi kedua pada perjalanan dapat memiliki stop_sequence=23, lokasi ketiga dapat memiliki stop_sequence=40, dan seterusnya.
stop_headsign Teks Opsional Teks yang muncul pada tanda yang mengidentifikasi tujuan perjalanan bagi penumpang. Kolom ini mengganti trips.trip_headsign default saat jurusan berubah di antara perhentian. Jika jurusan ditampilkan untuk seluruh perjalanan, gunakan trips.trip_headsign sebagai gantinya.

Nilai stop_headsign yang ditentukan untuk satu stop_time tidak berlaku untuk stop_time berikutnya pada perjalanan yang sama. Jika Anda ingin mengganti trip_headsign untuk beberapa stop_time pada perjalanan yang sama, nilai stop_headsign harus diulangi di masing-masing baris stop_time.
pickup_type Enum Opsional Menunjukkan metode pengambilan. Opsi yang valid adalah:

0 atau kosong - Penjemputan dengan jadwal reguler.
1 - Penjemputan tidak tersedia.
2 - Harus menghubungi perusahaan untuk mengatur penjemputan.
3 - Harus berkoordinasi dengan pengemudi untuk mengatur penjemputan.
drop_off_type Enum Opsional Menunjukkan metode penurunan. Opsi yang valid adalah:

0 atau kosong - Pengantaran dengan jadwal reguler.
1 - Pengantaran yang tidak tersedia.
2 - Harus menghubungi perusahaan untuk mengatur penurunan.
3 - Harus berkoordinasi dengan pengemudi untuk mengatur penurunan.
continuous_pickup Enum Opsional Menunjukkan apakah penumpang dapat naik kendaraan transportasi umum kapan saja di sepanjang jalur perjalanan kendaraan. Jalur tersebut dijelaskan dengan shapes.txt, dari stop_time ini ke stop_time berikutnya dalam stop_sequence perjalanan. Opsi yang valid adalah:

0 - Penjemputan dengan perhentian terus-menerus.
1 atau kosong - Tidak ada penjemputan dengan perhentian terus-menerus.
2 - Harus menghubungi perusahaan untuk mengatur penjemputan terus-menerus.
3 - Harus berkoordinasi dengan pengemudi untuk mengatur penjemputan dengan perhentian terus-menerus.

Perilaku penjemputan terus-menerus di stop_times.txt menggantikan perilaku yang ditentukan di routes.txt.
continuous_drop_off Enum Opsional Menunjukkan apakah penumpang dapat turun dari kendaraan transportasi umum kapan saja di sepanjang jalur perjalanan kendaraan seperti yang dijelaskan dengan shapes.txt, dari stop_time ini ke stop_time berikutnya dalam stop_sequence perjalanan.

0 - Penurunan dengan perhentian secara kontinu.
1 atau kosong - Tidak ada penurunan dengan perhentian secara kontinu.
2 - Harus menghubungi perusahaan untuk mengatur penurunan secara kontinu.
3 - Harus berkoordinasi dengan pengemudi untuk mengatur penurunan dengan perhentian secara kontinu.

Perilaku penurunan secara kontinu yang ditunjukkan dalam stop_times.txt menggantikan perilaku yang ditentukan dalam routes.txt.
shape_dist_traveled Bilangan mengambang non-negatif Opsional Jarak aktual yang ditempuh di sepanjang bentuk yang terkait, dari perhentian pertama ke perhentian yang ditentukan dalam catatan ini. Kolom ini menentukan seberapa luas bentuk yang akan digambar di antara dua perhentian selama perjalanan. Harus berada dalam unit yang sama yang digunakan pada shapes.txt. Nilai yang digunakan untuk shape_dist_traveled harus meningkat bersama dengan stop_sequence. Nilai ini tidak dapat digunakan untuk menampilkan perjalanan arah sebaliknya di sepanjang rute.
Contoh: Jika bus menempuh jarak 5,25 kilometer dari awal bentuk ke perhentian, shape_dist_traveled=5.25.
timepoint Enum Opsional Menunjukkan apakah waktu kedatangan dan keberangkatan untuk sebuah perhentian benar-benar diikuti oleh kendaraan atau apakah waktu tersebut merupakan waktu perkiraan dan/atau interpolasi. Kolom ini memungkinkan produsen GTFS memberikan waktu perhentian interpolasi, sekaligus menunjukkan bahwa waktunya merupakan perkiraan. Opsi yang valid adalah:

0 - Waktu dianggap perkiraan.
1 atau kosong - Waktu dianggap tepat.

calendar.txt

File: Wajib bersyarat

Nama Kolom Jenis Wajib Deskripsi
service_id ID Wajib Secara unik mengidentifikasi kumpulan tanggal saat layanan tersedia untuk satu atau beberapa rute. Setiap nilai service_id dapat muncul maksimal sekali di file calendar.txt.
monday Enum Wajib Menunjukkan apakah layanan beroperasi di semua hari Senin dalam rentang tanggal yang ditentukan oleh kolom start_date dan end_date. Perhatikan bahwa pengecualian untuk tanggal tertentu dapat dicantumkan di calendar_dates.txt. Opsi yang valid adalah:

1 - Layanan tersedia untuk semua hari Senin dalam rentang tanggal.
0 - Layanan tidak tersedia untuk hari Senin dalam rentang tanggal.
tuesday Enum Wajib Berfungsi dengan cara yang sama seperti monday kecuali berlaku untuk hari Selasa
wednesday Enum Wajib Berfungsi dengan cara yang sama seperti monday kecuali berlaku untuk hari Rabu
thursday Enum Wajib Berfungsi dengan cara yang sama seperti monday kecuali berlaku untuk hari Kamis
friday Enum Wajib Berfungsi dengan cara yang sama seperti monday kecuali berlaku untuk hari Jumat
saturday Enum Wajib Berfungsi dengan cara yang sama seperti monday kecuali berlaku untuk hari Sabtu.
sunday Enum Wajib Berfungsi dengan cara yang sama seperti monday kecuali berlaku untuk hari Minggu.
start_date Tanggal Wajib Memulai hari layanan untuk interval layanan.
end_date Tanggal Wajib Mengakhiri hari layanan untuk interval layanan. Hari layanan ini disertakan dalam interval.

calendar_dates.txt

File: Wajib bersyarat

Tabel calendar_dates.txt memungkinkan Anda secara eksplisit mengaktifkan atau menonaktifkan ID layanan menurut tanggal. Kolom ini dapat digunakan dengan dua cara.

  • Direkomendasikan: Gunakan calendar_dates.txt bersama dengan calendar.txt untuk menetapkan pengecualian pada pola layanan default yang ditentukan dalam calendar.txt. Jika layanan umumnya reguler, dengan beberapa perubahan pada tanggal eksplisit (misalnya, untuk mengakomodasi layanan peristiwa khusus, atau jadwal sekolah), ini adalah pendekatan yang bagus. Dalam hal ini calendar_dates.service_id adalah ID yang merujuk calendar.service_id.
  • Alternatif: Hapus calendar.txt, dan tentukan setiap tanggal layanan di calendar_dates.txt. Hal ini memungkinkan variasi layanan yang cukup luas dan mengakomodasi layanan tanpa jadwal mingguan yang normal. Dalam hal ini, service_id adalah ID.
Nama Kolom Jenis Wajib Deskripsi
service_id ID yang merujuk calendar.service_id atau ID Wajib Mengidentifikasi kumpulan tanggal saat pengecualian layanan terjadi untuk satu atau beberapa rute. Setiap pasangan (service_id, date) hanya dapat muncul sekali di calendar_dates.txt jika menggunakan calendar.txt bersama dengan calendar_dates.txt. Jika nilai service_id muncul di calendar.txt dan calendar_dates.txt, informasi di calendar_dates.txt memodifikasi informasi layanan yang ditentukan di calendar.txt.
date Tanggal Wajib Tanggal saat pengecualian layanan terjadi.
exception_type Enum Wajib Menunjukkan apakah layanan tersedia pada tanggal yang ditentukan di kolom date. Opsi yang valid adalah:

1 - Layanan telah ditambahkan untuk tanggal yang ditentukan.
2 - Layanan telah dihapus untuk tanggal yang ditentukan.
Contoh: Misalnya suatu rute memiliki satu kumpulan perjalanan yang tersedia pada hari libur dan kumpulan perjalanan lainnya yang tersedia pada hari lain. Satu service_id dapat sesuai dengan jadwal layanan reguler dan service_id lainnya dapat sesuai dengan jadwal hari libur. Untuk hari libur tertentu, calendar_dates.txt dapat digunakan untuk menambahkan hari libur ke hari libur service_id dan untuk menghapus hari libur dari jadwal service_id reguler.

fare_attributes.txt

File: Opsional

Nama Kolom Jenis Wajib Deskripsi
fare_id ID Wajib Mengidentifikasi kelas tarif.
price Bilangan mengambang non-negatif Wajib Harga tarif, dalam unit yang ditentukan oleh currency_type.
currency_type Kode mata uang Wajib Mata uang yang digunakan untuk membayar tarif.
payment_method Enum Wajib Menunjukkan kapan tarif harus dibayar. Opsi yang valid adalah:

0 - Tarif dibayar di atas kendaraan.
1 - Tarif harus dibayar sebelum naik kendaraan.
transfers Enum Wajib Menunjukkan jumlah transfer yang diizinkan pada tarif ini. Fakta bahwa kolom ini dapat dikosongkan adalah pengecualian terhadap persyaratan bahwa kolom Wajib tidak boleh kosong. Opsi yang valid adalah:

0 - Transfer tidak diizinkan untuk tarif ini.
1 - Penumpang dapat melakukan transfer sekali.
2 - Penumpang dapat melakukan transfer dua kali.
kosong - Transfer tidak terbatas diizinkan.
agency_id ID yang merujuk agency.agency_id Wajib Bersyarat Mengidentifikasi perusahaan yang relevan untuk tarif. Kolom ini wajib ada untuk set data dengan beberapa perusahaan transportasi umum yang ditentukan di agency.txt. Jika tidak, kolom ini opsional.
transfer_duration Bilangan bulat non-negatif Opsional Durasi waktu dalam detik sebelum transfer berakhir. Jika transfers=0, kolom ini dapat digunakan untuk menunjukkan berapa lama tiket valid atau dapat dikosongkan.

fare_rules.txt

File: Opsional

Tabel fare_rules.txt menentukan bagaimana tarif di fare_attributes.txt berlaku untuk rencana perjalanan. Sebagian besar struktur tarif menggunakan beberapa kombinasi aturan berikut:

  • Tarif tergantung pada stasiun asal atau destinasi.
  • Tarif bergantung pada zona mana yang dilalui rencana perjalanan.
  • Tarif bergantung pada rute mana yang digunakan rencana perjalanan.

Untuk contoh yang menunjukkan cara menentukan struktur tarif dengan fare_rules.txt dan fare_attributes.txt, lihat https://code.google.com/p/googletransitdatafeed/wiki/FareExamples di wiki project open source GoogleTransitDataFeed.

Nama Kolom Jenis Wajib Deskripsi
fare_id ID yang merujuk fare_attributes.fare_id Wajib Mengidentifikasi kelas tarif.
route_id ID yang merujuk routes.route_id Opsional Mengidentifikasi rute yang dikaitkan dengan kelas tarif. Jika terdapat beberapa rute dengan atribut tarif yang sama, buat catatan di fare_rules.txt untuk setiap rute.
Contoh: Jika kelas tarif "b" valid pada rute "TSW" dan "TSE", file fare_rules.txt akan berisi catatan berikut untuk kelas tarif:
fare_id,route_id
b,TSW
b,TSE
origin_id ID yang merujuk stops.zone_id Opsional Mengidentifikasi zona asal. Jika kelas tarif memiliki beberapa zona asal, buat catatan di fare_rules.txt untuk setiap origin_id.
Contoh: Jika kelas tarif "b" valid untuk perjalanan yang berasal dari zona "2" atau zona "8", file fare_rules.txt akan berisi catatan berikut untuk kelas tarif:
fare_id,...,origin_id
b,...,2
b,...,8
destination_id ID yang merujuk stops.zone_id Opsional Mengidentifikasi zona tujuan. Jika jenis tiket memiliki beberapa zona tujuan, buat catatan di fare_rules.txt untuk setiap destination_id.
Contoh: Kolom origin_id dan destination_id dapat digunakan bersama-sama untuk menentukan bahwa jenis tiket "b" valid untuk perjalanan antara zona 3 dan 4, serta untuk perjalanan antara zona 3 dan 5, file fare_rules.txt akan berisi catatan berikut untuk jenis tiket:
fare_id,...,origin_id,destination_id
b,...,3,4
b,...,3,5
contains_id ID yang merujuk stops.zone_id Opsional Mengidentifikasi zona yang akan dimasuki penumpang saat menggunakan kelas tarif tertentu. Digunakan di beberapa sistem untuk menghitung kelas tarif yang benar.
Contoh: Jika kelas tarif "c" dikaitkan dengan semua perjalanan di rute GRT yang melewati zona 5, 6, dan 7, fare_rules.txt akan berisi catatan berikut:
fare_id,route_id,...,contains_id
c,GRT,...,5
c,GRT,...,6
c,GRT,...,7
Karena semua zona contains_id harus dicocokkan agar tarif dapat diterapkan, rencana perjalanan yang melewati zona 5 dan 6, tetapi tidak melewati zona 7, tidak akan memiliki kelas tarif "c". Untuk mendapatkan detail lebih lanjut, lihat https://code.google.com/p/googletransitdatafeed/wiki/FareExamples di wiki project GoogleTransitDataFeed.

shapes.txt

File: Opsional

Bentuk mendeskripsikan jalur yang dilalui kendaraan di sepanjang penyelarasan rute, dan ditentukan di file shapes.txt. Bentuk dikaitkan dengan Perjalanan, dan terdiri dari urutan titik yang dilewati kendaraan secara berurutan. Bentuk tidak perlu melakukan intersepsi lokasi Perhentian secara persis, tetapi semua perhentian pada perjalanan harus berada dalam rentang jarak yang kecil dari bentuk untuk perjalanan tersebut, yaitu dekat dengan segmen garis lurus yang menghubungkan titik-titik bentuk.

Nama Kolom Jenis Wajib Deskripsi
shape_id ID Wajib Mengidentifikasi bentuk.
shape_pt_lat Lintang Wajib Lintang titik bentuk. Setiap catatan di shapes.txt mewakili titik bentuk yang digunakan untuk menentukan bentuk.
shape_pt_lon Bujur Wajib Bujur titik bentuk.
shape_pt_sequence Bilangan bulat non-negatif Wajib Urutan titik-titik bentuk yang terhubung untuk membuat bentuk. Nilai harus meningkat di sepanjang perjalanan tetapi tidak harus berturut-turut.
Contoh: Jika bentuk "A_shp" memiliki tiga titik dalam definisinya, file shapes.txt dapat berisi catatan berikut untuk menentukan bentuk:
shape_id,shape_pt_lat,shape_pt_lon,shape_pt_sequence
A_shp,37.61956,-122.48161,0
A_shp,37.64430,-122.41070,6
A_shp,37.65863,-122.30839,11
shape_dist_traveled Bilangan mengambang non-negatif Opsional Jarak aktual yang ditempuh di sepanjang bentuk dari titik bentuk pertama hingga titik yang ditentukan dalam catatan ini. Digunakan oleh perencana perjalanan untuk menunjukkan bagian bentuk yang benar pada peta. Nilai harus meningkat bersama dengan shape_pt_sequence. Nilai ini tidak dapat digunakan untuk menunjukkan perjalanan balik di sepanjang rute. Satuan jarak harus sesuai dengan satuan yang digunakan di stop_times.txt
Contoh: Jika bus berjalan di sepanjang tiga titik yang ditentukan di atas untuk A_shp, nilai shape_dist_traveled tambahan (yang ditunjukkan di sini dalam kilometer) akan terlihat seperti ini:
shape_id,shape_pt_lat,shape_pt_lon,shape_pt_sequence,shape_dist_traveled
A_shp,37.61956,-122.48161,0,0
A_shp,37.64430,-122.41070,6,6.8310
A_shp,37.65863,-122.30839,11,15.8765

frequencies.txt

File: Opsional

File frequencies.txt merepresentasikan perjalanan yang beroperasi di headway reguler (waktu di antara perjalanan). File ini dapat digunakan untuk merepresentasikan dua jenis layanan berbeda:

  • Layanan berbasis frekuensi (exact_times=0) yang tidak mengikuti jadwal tetap sepanjang hari. Sebagai gantinya, operator berupaya secara ketat mempertahankan headway yang ditentukan sebelumnya untuk perjalanan.
  • Representasi terkompresi untuk layanan berbasis jadwal (exact_times=1) yang memiliki headway yang sama persis untuk perjalanan selama jangka waktu yang ditentukan. Dalam layanan berbasis jadwal, operator berupaya mematuhi jadwal secara ketat.
Nama Kolom Jenis Wajib Deskripsi
trip_id ID yang merujuk trips.trip_id Wajib Mengidentifikasi perjalanan yang menerapkan headway layanan yang ditentukan.
start_time Waktu Wajib Waktu saat kendaraan pertama berangkat dari perhentian pertama pada perjalanan dengan headway yang ditentukan.
end_time Waktu Wajib Waktu saat layanan berubah ke headway yang berbeda (atau berhenti) di perhentian pertama pada perjalanan.
headway_secs Bilangan bulat non-negatif Wajib Waktu, dalam detik, antara keberangkatan dari perhentian yang sama (headway) untuk perjalanan, selama interval waktu yang ditentukan oleh start_time dan end_time. Beberapa headway untuk perjalanan yang sama diizinkan, tetapi tidak boleh tumpang-tindih. Headway baru dapat dimulai pada waktu yang sama persis saat headway sebelumnya berakhir.
exact_times Enum Opsional Menunjukkan jenis layanan untuk perjalanan. Lihat deskripsi file untuk mendapatkan informasi lebih lanjut. Opsi yang valid adalah:

0 atau kosong - Perjalanan berbasis frekuensi.
1 - Perjalanan berbasis jadwal dengan headway yang sama persis sepanjang hari. Dalam kasus ini, nilai end_time harus lebih besar daripada start_time perjalanan yang terakhir diinginkan tetapi lebih kecil daripada start_time + headway_secs perjalanan yang terakhir diinginkan.

transfers.txt

File: Opsional

Saat menghitung rencana perjalanan, aplikasi yang menggunakan GTFS menginterpolasi transfer berdasarkan waktu yang diizinkan dan kedekatan perhentian. File transfers.txt menentukan aturan dan penggantian tambahan untuk transfer yang dipilih.

Nama Kolom Jenis Wajib Deskripsi
from_stop_id ID yang merujuk stops.stop_id Wajib Mengidentifikasi perhentian atau stasiun tempat koneksi di antara rute dimulai. Jika kolom ini merujuk ke stasiun, aturan transfer berlaku untuk semua perhentian turunannya.
to_stop_id ID yang merujuk stops.stop_id Wajib Mengidentifikasi perhentian atau stasiun tempat koneksi di antara rute berakhir. Jika kolom ini merujuk ke stasiun, aturan transfer berlaku untuk semua perhentian turunan.
transfer_type Enum Wajib Menunjukkan jenis koneksi untuk pasangan yang ditentukan (from_stop_id, to_stop_id). Opsi yang valid adalah:

0 atau kosong - Titik transfer yang direkomendasikan di antara rute.
1 - Titik transfer berjangka waktu di antara dua rute. Kendaraan yang berangkat diharapkan menunggu kendaraan yang datang dan menyisakan waktu yang cukup bagi penumpang untuk transfer di antara rute.
2 - Transfer memerlukan jumlah waktu minimum antara kedatangan dan keberangkatan untuk memastikan koneksi. Waktu yang diperlukan untuk transfer ditentukan oleh min_transfer_time.
3 - Transfer tidak dapat dilakukan di antara rute di lokasi.
4 - Penumpang dapat tetap berada di kendaraan yang sama untuk transfer dari satu perjalanan ke perjalanan lain ("transfer tanpa pindah").
5 - Transfer tanpa pindah tidak diizinkan di antara perjalanan berurutan. Penumpang harus turun dari kendaraan dan naik kembali.
min_transfer_time Bilangan bulat non-negatif Opsional Jumlah waktu, dalam detik, yang harus tersedia untuk mengizinkan transfer di antara rute pada perhentian yang ditentukan. min_transfer_time harus memadai agar penumpang biasa dapat berpindah di antara dua perhentian, termasuk waktu buffer untuk memungkinkan variasi jadwal di setiap rute.

pathways.txt

File: Opsional

Ekstensi GTFS-Pathways menggunakan representasi grafik untuk mendeskripsikan kereta bawah tanah atau kereta api, dengan node (lokasi) dan tepi (jalur).

Untuk beralih dari pintu masuk (yang merupakan node yang direpresentasikan sebagai lokasi dengan location_type=2) ke platform (yang merupakan node yang direpresentasikan sebagai lokasi dengan location_type=0), penumpang akan melewati jalur pejalan kaki, gerbang tiket, tangga, dll. (yang merupakan tepi yang direpresentasikan sebagai jalur). Proposal juga menambahkan jenis lokasi lain, yaitu jenis lokasi umum yang disebut “node umum”, misalnya untuk merepresentasikan penyeberangan jalur pejalan kaki yang dapat digunakan untuk menuju ke berbagai jalur pejalan kaki.

Peringatan: Jalur harus menyeluruh di stasiun. Akibatnya, segera setelah satu platform (sebagai perhentian), pintu masuk, atau node milik stasiun dihubungkan ke sebuah jalur, stasiun dianggap memiliki deskripsi jalur yang menyeluruh. Oleh karena itu, aturan umum berikut berlaku:

  • Tidak ada lokasi yang terputus: Jika lokasi dalam stasiun memiliki jalur, maka semua lokasi harus memiliki jalur (kecuali untuk platform yang memiliki area naik turun).
  • Tidak ada platform yang terkunci: Setiap platform harus terhubung ke setidaknya satu pintu masuk melalui beberapa rangkaian jalur. Meskipun sangat jarang, ada stasiun yang tidak memungkinkan Anda untuk pergi ke luar.
  • Tidak ada jalur untuk platform dengan area naik turun: Platform yang memiliki area naik turun diperlakukan sebagai objek induk, bukan titik. Platform ini mungkin tidak memiliki jalur yang ditetapkan. Semua jalur harus ditujukan untuk area naik turun.
Nama Kolom Jenis Wajib Deskripsi
pathway_id ID Wajib Kolom pathway_id berisi ID yang secara unik mengidentifikasi jalur. pathway_id digunakan oleh sistem sebagai ID internal catatan ini (mis., kunci utama dalam database), sehingga pathway_id harus berupa set data unik.
Jalur yang berbeda-beda dapat mengarah dari from_stop_id yang sama ke to_stop_id yang sama. Misalnya, hal ini terjadi jika dua eskalator berdampingan dalam arah berlawanan, atau jika tangga berada di dekat lift dan keduanya mengarah dari satu tempat yang sama ke tempat lainnya yang sama.
from_stop_id ID yang merujuk stops.stop_id Wajib Lokasi tempat jalur dimulai. Kolom ini berisi stop_id yang mengidentifikasi platform, pintu masuk/keluar, node umum, atau area naik turun dari file stops.txt.
to_stop_id ID yang merujuk stops.stop_id Wajib Lokasi tempat jalur berakhir. Kolom ini berisi stop_id yang mengidentifikasi platform, pintu masuk/keluar, node umum, atau area naik turun dari file stops.txt.
pathway_mode Enum Wajib Jenis jalur di antara pasangan (from_stop_id, to_stop_id) yang ditentukan. Nilai yang valid untuk kolom ini adalah:
• 1: jalur pejalan kaki
• 2: tangga
• 3: jalur pejalan kaki bergerak/travelator
• 4: eskalator
• 5: lift
• 6: gerbang tiket (atau gerbang pembayaran): Jalur yang melintasi area stasiun tempat bukti pembayaran diperlukan (biasanya melalui gerbang pembayaran fisik).
Gerbang tiket dapat memisahkan area berbayar dari area yang tidak berbayar di stasiun tersebut, atau memisahkan area pembayaran yang berbeda-beda dalam stasiun yang sama dari satu sama lain. Informasi ini dapat digunakan agar penumpang tidak diarahkan melalui stasiun menggunakan jalan pintas yang akan mengharuskan penumpang melakukan pembayaran yang tidak perlu, seperti mengarahkan penumpang untuk berjalan melalui platform kereta bawah tanah untuk mencapai jalur bus.
• 7: gerbang keluar: Menunjukkan jalur yang keluar dari area yang mewajibkan bukti pembayaran ke area yang tidak lagi mewajibkan bukti pembayaran.
is_bidirectional Enum Wajib Menunjukkan arah jalur yang dapat digunakan:
• 0: Jalur searah, hanya dapat digunakan dari from_stop_id ke to_stop_id.
• 1: Jalur dua arah, dapat digunakan dalam dua arah.

Gerbang tiket (pathway_mode=6) dan gerbang keluar (pathway_mode=7) tidak dapat bersifat dua arah.
length Bilangan Mengambang Non-negatif Opsional Panjang horizontal jalur dalam meter dari lokasi asal (ditentukan dalam from_stop_id) ke lokasi tujuan (ditentukan dalam to_stop_id).

Kolom ini direkomendasikan untuk jalur pejalan kaki (pathway_mode=1), gerbang tiket (pathway_mode=6), dan gerbang keluar (pathway_mode=7).
traversal_time Bilangan Bulat Positif Opsional Waktu rata-rata dalam detik yang diperlukan untuk berjalan kaki melalui jalur dari lokasi asal (ditentukan dalam from_stop_id) ke lokasi tujuan (ditentukan dalam to_stop_id).

Kolom ini direkomendasikan untuk jalur pejalan kaki bergerak (pathway_mode=3), eskalator (pathway_mode=4), dan lift (pathway_mode=5).
stair_count Bilangan Bulat Bukan Nol Opsional Jumlah tangga di jalur.

Praktik Terbaik: Perkiraan 1 lantai = 15 tangga dapat digunakan untuk menghasilkan nilai perkiraan.

stair_count positif berarti bahwa penumpang berjalan naik dari from_stop_id ke to_stop_id. stair_count negatif berarti bahwa penumpang berjalan turun dari from_stop_id ke to_stop_id.

Kolom ini direkomendasikan untuk tangga (pathway_mode=2).
max_slope Bilangan Mengambang Opsional Rasio kemiringan maksimum jalur. Nilai yang valid untuk kolom ini adalah:
• 0 atau (kosong): tidak ada kemiringan.
• Bilangan mengambang: rasio kemiringan jalur, positif untuk naik, negatif untuk turun.

Kolom ini harus digunakan hanya dengan jalur pejalan kaki (pathway_type=1) dan jalur pejalan kaki bergerak (pathway_type=3).

Contoh: Di AS, 0,083 (juga ditulis 8,3%) adalah rasio kemiringan maksimum untuk kursi roda yang digerakkan tangan, artinya ada peningkatan sebesar 0,083 m (8,3 cm) untuk setiap 1 m.
min_width Bilangan Mengambang Positif Opsional Lebar minimum jalur dalam meter.

Kolom ini sangat direkomendasikan jika lebar minimum kurang dari 1 meter.
signposted_as Teks Opsional String teks dari tanda fisik yang terlihat oleh penumpang transportasi umum. String ini dapat digunakan untuk memberikan teks petunjuk arah kepada pengguna, seperti 'ikuti tanda ke'. Teks bahasa harus muncul di kolom ini persis seperti yang dicetak pada tanda - teks ini tidak boleh diterjemahkan.
reversed_signposted_as Teks Opsional Sama dengan kolom signposted_as, tetapi saat jalur digunakan dalam arah mundur, yaitu dari to_stop_id ke from_stop_id.

levels.txt

File: Opsional

Mendeskripsikan tingkat stasiun yang berbeda-beda. Sangat berguna jika digunakan bersama dengan pathways.txt, dan wajib ada untuk lift (pathway_mode=5) untuk meminta pengguna naik lift ke tingkat “Mezanin” atau “Platform”.

Nama Kolom Jenis Wajib Deskripsi
level_id ID Wajib ID tingkat yang dapat dirujuk dari stops.txt.
level_index Bilangan Mengambang Wajib Indeks angka untuk tingkat yang menunjukkan posisi relatif tingkat ini sehubungan dengan tingkat lain (tingkat dengan indeks lebih tinggi dianggap berada di atas tingkat dengan indeks lebih rendah).

Tingkat lantai dasar harus memiliki indeks 0, dengan tingkat di atas lantai dasar ditunjukkan oleh indeks positif dan tingkat di bawah lantai dasar ditunjukkan oleh indeks negatif.
level_name Teks Opsional Nama opsional tingkat (yang cocok dengan huruf/nomor tingkat yang digunakan di dalam gedung atau stasiun). Berguna untuk perutean lift (mis. naik lift ke tingkat "Mezanin" atau "Platform" atau "-1").

feed_info.txt

File: Wajib bersyarat

File ini berisi informasi tentang set data itu sendiri, bukan layanan yang dideskripsikan oleh set data. Dalam beberapa kasus, penayang set data tersebut berbeda dari perusahaan transportasi umum. Jika translations.txt diberikan, file ini diperlukan.

Nama Kolom Jenis Wajib Deskripsi
feed_publisher_name Teks Wajib Nama lengkap organisasi yang memublikasikan set data. Hal ini mungkin sama dengan salah satu nilai agency.agency_name.
feed_publisher_url URL Wajib URL situs organisasi penayang set data. Kolom ini mungkin sama dengan salah satu nilai agency.agency_url.
feed_lang Kode bahasa Wajib Bahasa default untuk teks dalam set data ini. Setelan ini membantu konsumen GTFS memilih aturan penggunaan huruf besar dan setelan spesifik per bahasa lainnya untuk set data.

Untuk menentukan bahasa lain, gunakan kolom language di translations.txt.

Set data multibahasa mungkin merupakan bahasa default dengan teks asli dalam beberapa bahasa. Dalam kasus tersebut, gunakan kode bahasa ISO 639-2 mul di kolom feed_lang. Berikan terjemahan untuk setiap bahasa yang digunakan dalam set data di translations.txt. Jika semua teks asli dalam set data menggunakan bahasa yang sama, jangan gunakan mul.

Misalnya, set data di Swiss mungkin menetapkan kolom stops.stop_name asli yang diisi dengan nama perhentian dalam berbagai bahasa. Setiap nama perhentian ditulis sesuai dengan bahasa utama di lokasi geografis perhentian tersebut. Nama perhentian mencakup Genève untuk kota Jenewa berbahasa Prancis, Zürich untuk kota Zurich berbahasa Jerman, dan Biel/Bienne untuk kota dwibahasa Biel/Bienne. Tetapkan feed_lang=mul dan berikan terjemahan berikut di translations.txt:
  • Jerman: "Genf", "Zürich", dan "Biel"
  • Prancis: "Genève", "Zurich", dan "Bienne"
  • Italia: "Ginevra", "Zurigo", dan "Bienna"
  • Inggris: "Geneva", "Zurich", dan "Biel/Bienne"
default_lang Kode bahasa Opsional Menentukan bahasa yang digunakan saat konsumen data tidak mengetahui bahasa penumpang. Kode ini sering ditentukan sebagai en, Inggris.
feed_start_date Tanggal Opsional Set data ini menyediakan informasi jadwal yang lengkap dan tepercaya untuk layanan dalam periode dari awal hari feed_start_date hingga akhir hari feed_end_date. Kedua hari tersebut dapat dikosongkan jika tidak tersedia. Tanggal feed_end_date tidak boleh sebelum tanggal feed_start_date jika keduanya diberikan. Penyedia set data disarankan untuk memberikan data jadwal di luar periode ini untuk memberitahukan kemungkinan layanan di masa mendatang, tetapi pengguna set data harus menanganinya dengan hati-hati terkait status non-otoritatifnya. Jika feed_start_date atau feed_end_date melampaui tanggal kalender aktif yang ditentukan di calendar.txt dan calendar_dates.txt, set data membuat pernyataan eksplisit bahwa tidak ada layanan untuk tanggal dalam rentang feed_start_date hingga feed_end_date, tetapi tidak disertakan dalam tanggal kalender aktif.
feed_end_date Tanggal Opsional Lihat baris feed_start_date dalam tabel ini.
feed_version Teks Opsional String yang menunjukkan versi set data GTFS saat ini dari penayang set data. Aplikasi yang menggunakan GTFS dapat menampilkan nilai ini untuk membantu penayang set data mengetahui apakah set data terbaru telah diterapkan.
feed_contact_email Email Opsional Alamat email untuk komunikasi tentang set data GTFS dan praktik publikasi data. feed_contact_email adalah kontak teknis untuk aplikasi yang menggunakan GTFS. Masukkan informasi kontak layanan pelanggan melalui agency.txt.
feed_contact_url URL Opsional URL untuk informasi kontak, formulir web, staf dukungan, atau alat lain untuk komunikasi tentang set data GTFS dan praktik publikasi data. feed_contact_url adalah kontak teknis untuk aplikasi yang menggunakan GTFS. Masukkan informasi kontak layanan pelanggan melalui agency.txt.

translations.txt

File: Opsional

Nama Kolom Jenis Wajib Deskripsi
table_name Enum Wajib

Menentukan tabel set data yang berisi kolom yang akan diterjemahkan. Nilai berikut diizinkan:

  • agency
  • stops
  • routes
  • trips
  • stop_times
  • feed_info
  • pathways
  • levels
  • attributions
field_name Teks Wajib

Memberikan nama kolom yang akan diterjemahkan. Kolom dengan jenis "Text" dapat diterjemahkan, sedangkan kolom dengan jenis "URL", "Email", dan "Phone number" dapat disertakan di sini agar referensi tersebut diberikan dalam bahasa yang benar.
language Kode bahasa Wajib

Memberikan bahasa terjemahan.

Jika bahasa ini sama dengan salah satu bahasa dari feed_lang di feed_info.txt nilai asli kolom ini adalah nilai default yang digunakan dalam bahasa tanpa terjemahan spesifik.

Misalnya, di Swiss, sebuah kota di kanton dwibahasa secara resmi disebut "Biel/Bienne," tetapi cukup disebut "Bienne" dalam bahasa Prancis dan "Biel" dalam bahasa Jerman.
translation Teks, URL, Email, atau Nomor telepon Wajib Memberikan nilai terjemahan untuk field_name yang ditentukan.
record_id ID Wajib Bersyarat

Menentukan data yang sesuai dengan kolom yang akan diterjemahkan. Nilai dalam record_id harus merupakan ID utama dari tabel set data, seperti yang ditentukan dalam tabel berikut:

table_name record_id
agency agency_id
stops stop_id
routes route_id
trips trip_id
stop_times trip_id
pathways pathway_id
levels level_id
attributions attribution_id

Ketentuan berikut menentukan cara kolom ini dapat digunakan:

  • Dilarang jika table_name sama dengan feed_info.
  • Dilarang jika field_value ditentukan.
  • Wajib jika field_value kosong.
record_sub_id ID Wajib Bersyarat

Membantu menerjemahkan data yang berisi kolom jika tabel yang dirujuk dalam record_id tidak memiliki ID unik. Nilai dalam record_sub_id adalah ID sekunder tabel set data, seperti yang ditentukan dalam tabel berikut:

table_name record_sub_id
agency NONE
stops NONE
routes NONE
trips NONE
stop_times stop_sequence
pathways NONE
levels NONE
attributions NONE

Ketentuan berikut menentukan cara kolom ini dapat digunakan:

  • Dilarang jika table_name sama dengan feed_info.
  • Dilarang jika field_value ditentukan.
  • Wajib jika table_name sama dengan stop_times dan record_id ditentukan.
field_value Teks, URL, Email, atau Nomor telepon Wajib Bersyarat

Daripada menggunakan record_id dan record_sub_id untuk menentukan catatan yang perlu diterjemahkan, field_value dapat digunakan untuk menentukan nilai untuk terjemahan. JIka digunakan, terjemahan diterapkan jika kolom yang diidentifikasi oleh table_name dan field_name berisi nilai yang sama persis yang ditentukan dalam field_value.

Kolom harus sama persis dengan nilai yang ditentukan dalam field_value. Jika hanya subset nilai yang cocok dengan field_value, terjemahan tidak diterapkan.

Jika dua aturan terjemahan cocok dengan catatan yang sama, satu aturan dengan field_value dan aturan lainnya dengan record_id, maka aturan dengan record_id yang perlu digunakan.

Ketentuan berikut menentukan cara kolom ini dapat digunakan:

  • Dilarang jika table_name sama dengan feed_info.
  • Dilarang jika record_id ditentukan.
  • Wajib jika record_id kosong.

attributions.txt

File: Opsional

Nama Kolom Jenis Wajib Deskripsi
attribution_id ID Opsional Mengidentifikasi atribusi untuk set data, atau subsetnya. Kolom ini berguna untuk terjemahan.
agency_id ID yang merujuk Opsional Perusahaan transportasi umum yang padanya atribusi berlaku. Jika satu atribusi agency_id, route_id, atau trip_id ditentukan, kolom lainnya harus kosong. Jika tidak ada yang ditentukan, atribusi berlaku untuk keseluruhan set data.
route_id ID yang merujuk Opsional Kolom ini berfungsi dengan cara yang sama seperti agency_id, tetapi atribusinya berlaku untuk rute. Beberapa atribusi dapat berlaku untuk rute yang sama.
trip_id ID yang merujuk Opsional Kolom ini berfungsi dengan cara yang sama seperti agency_id, tetapi atribusinya berlaku untuk perjalanan. Beberapa atribusi dapat berlaku untuk perjalanan yang sama.
organization_name Teks Wajib Nama organisasi yang padanya set data diatribusikan.
is_producer Enum Opsional Peran organisasi adalah pembuat. Nilai yang diizinkan mencakup hal berikut:
• 0 atau kosong: Organisasi tidak memiliki peran ini.
• 1: Organisasi memiliki peran ini.
Setidaknya salah satu kolom, baik is_producer, is_operator, maupun is_authority, harus ditetapkan ke 1.
is_operator Enum Opsional Berfungsi dengan cara yang sama seperti is_producer, tetapi peran organisasi adalah operator.
is_authority Enum Opsional Berfungsi dengan cara yang sama seperti is_producer, tetapi peran organisasi adalah otoritas.
attribution_url URL Opsional URL organisasi.
attribution_email Email Opsional Email organisasi.
attribution_phone Nomor telepon Opsional Nomor telepon organisasi.