ข้อมูลอ้างอิงและความแตกต่างของตารางเวลา GTFS ของ Google Transit

หน้านี้อธิบายความแตกต่างที่สำคัญระหว่างกำหนดการ GTFS อย่างเป็นทางการกับการใช้งานข้อกำหนดของ Google Transit ในด้านต่อไปนี้

  • ข้อกำหนดอย่างเป็นทางการที่ละเว้น: ฟิลด์เหล่านี้เป็นส่วนหนึ่งของ GTFS อย่างเป็นทางการ Google Transit จะนำเข้าข้อมูลนี้โดยไม่มีข้อผิดพลาด แต่จะไม่ใช้ข้อมูลดังกล่าวในเชิงรุก

  • การตีความที่ต่างกัน: ช่องเหล่านี้มีข้อมูลบางส่วนของ GTFS อย่างเป็นทางการที่ Google Transit ตีความต่างจากคำจำกัดความของ GTFS สำหรับข้อมูลส่วนนั้นๆ

  • การสนับสนุนแบบทดลอง: ช่องเหล่านี้เป็นช่องทดลองในการใช้งาน Google Transit หากต้องการใช้ช่องทดสอบใหม่ โปรดติดต่อทีม Google Transit

  • ส่วนขยายที่ Google Transit รองรับ: ส่วนขยายนี้ไม่ได้เป็นส่วนหนึ่งของ GTFS อย่างเป็นทางการ ส่วนขยายที่รองรับระบบขนส่งสาธารณะมีทั้งส่วนขยายสาธารณะและส่วนขยายเฉพาะ Google Transit พาร์ทเนอร์ทุกรายสามารถส่งข้อมูลนี้ไปยังฟีด Transit ได้

ขนส่งสาธารณะแบบคงที่

ส่วนต่อไปนี้จะอธิบายความแตกต่างที่สำคัญระหว่าง GTFS อย่างเป็นทางการกับการใช้งานฟีดแบบคงที่ของ Google Transit

ละเว้นข้อกำหนดอย่างเป็นทางการในฟีดแบบคงที่

ข้อกำหนดอย่างเป็นทางการบางรายการที่ Transit ละเว้นอยู่นั้นยังอยู่ในขั้นทดลอง ดูข้อมูลเพิ่มเติมได้ที่ gtfs.org

ตารางที่ 1 แสดงไฟล์ GTFS ที่ Transit ไม่รองรับในฟีดแบบคงที่ นอกจากนี้ Transit ยังไม่รองรับฟิลด์ใดๆ ที่กําหนดไว้ในไฟล์เหล่านี้

ตารางที่ 1 ไฟล์ GTFS ที่ไม่รองรับในฟีดแบบคงที่
areas.txt
fare_leg_rules.txt
fare_products.txt
fare_transfer_rules.txt
levels.txt
stop_areas.txt

ตารางที่ 2 แสดงรายการช่องทั้งหมดที่ GTFS กำหนดไว้ซึ่ง Transit จะไม่สนใจในฟีดแบบคงที่

ตารางที่ 2 ช่อง GTFS ที่ละเว้นในฟีดแบบคงที่
ชื่อไฟล์ ฟิลด์ที่ละเว้นซึ่งกำหนดไว้ใน GTFS ประเภทช่อง
fare_attributes.txt payment_method ค่าแจกแจง
feed_info.txt default_lang รหัสภาษา
feed_info.txt feed_publisher_name ข้อความ
pathways.txt max_slope ทศนิยม
routes.txt continuous_drop_off ค่าแจกแจง
routes.txt continuous_pickup ค่าแจกแจง
routes.txt network_id รหัส
routes.txt route_desc ข้อความ
routes.txt route_sort_order จํานวนเต็มที่ไม่เป็นลบ
stops.txt level_id รหัส
stops.txt stop_desc ข้อความ
stops.txt stop_url URL
stops.txt tts_stop_name ข้อความ
trips.txt bikes_allowed ค่าแจกแจง

การตีความที่แตกต่างกันในฟีดแบบคงที่

แม้ว่า Transit จะยอมรับช่องที่ GTFS กำหนดไว้บางช่อง แต่ Transit จะตีความช่องเหล่านั้นต่างจาก GTFS

ตารางที่ 3 แสดงช่องในฟีดแบบคงที่ที่ Transit ใช้แตกต่างจากที่อธิบายไว้ใน GTFS

ตารางที่ 3 ช่องฟีดแบบคงที่ที่ติดตั้งใช้งานต่างกัน
ชื่อไฟล์ ฟิลด์ที่กําหนดไว้ใน GTFS ประเภทช่อง Google Transit กำหนดให้ต้องระบุหรือไม่ รายละเอียดการใช้งาน Google Transit
fare_attributes.txt transfers ค่าแจกแจง ต้องระบุ

ส่วนขยาย Google Transit

GTFS สาธารณะจะจำกัดค่าให้อยู่ในช่วง 0 ถึง 2 Google Transit ยอมรับค่าตั้งแต่ 0 ถึง 5

ใช้ช่องนี้เพื่อกำหนดจำนวนครั้งที่โอนได้สูงสุดสำหรับค่าโดยสาร ซึ่งไม่รวมการโอนบล็อกหรือที่เรียกว่าการโอนที่นั่ง หากไม่ต้องการจำกัดจำนวนครั้งที่โอนสำหรับค่าโดยสาร ให้ปล่อยช่อง transfers ว่างไว้
pathways.txt pathway_mode ค่าแจกแจง ไม่บังคับ เมื่อระบุช่อง pathway_mode แล้ว หากปล่อยว่างไว้ Google Transit จะยอมรับและถือว่าไม่รู้จัก
stop_times.txt arrival_time เวลา ต้องระบุแบบมีเงื่อนไข ระบบจะจำกัดจำนวนชั่วโมงไว้ที่ 00 ถึง 99 ซึ่งมากเกินพอสำหรับการเดินทาง 3 วัน
transfers.txt transfer_type ค่าแจกแจง ต้องระบุ

ระบบจะไม่รองรับค่า 4 และ 5 และจะละเว้นค่าดังกล่าว

Google Transit รองรับค่า 0, 1, 2 และ 3
trips.txt block_id รหัส ไม่บังคับ ดูข้อมูลเพิ่มเติมได้ที่ตัวอย่างการโอนบล็อก

การรองรับเวอร์ชันทดลองในฟีดแบบคงที่

หากต้องการการสนับสนุนในการผสานรวมช่องทดลองใหม่ในหมวดหมู่นี้ โปรดติดต่อ Google Transit

ส่วนขยายที่ Google Transit รองรับในฟีดแบบคงที่

ตารางที่ 4 ให้ข้อมูลเกี่ยวกับส่วนขยาย Google Transit ฟิลด์เหล่านี้ไม่ได้เป็นส่วนหนึ่งของ GTFS อย่างเป็นทางการ

ตารางที่ 4 ส่วนขยายฟีดแบบคงที่ที่รองรับ
ชื่อไฟล์ ช่อง ประเภทช่อง Google Transit กำหนดให้ต้องระบุหรือไม่ รายละเอียดการใช้งาน Google Transit
fare_attributes.txt ic_price ทศนิยม ไม่บังคับ

ส่วนขยาย Google Transit นี้พร้อมให้บริการแก่พาร์ทเนอร์ในญี่ปุ่นเท่านั้น

ฟิลด์ ic_price แสดงจํานวนเงินหลังหักส่วนลดที่ต้องชําระสำหรับค่าโดยสารนี้ด้วยสมาร์ทการ์ด หากไม่มีส่วนลดสำหรับค่าโดยสารนี้หรือไม่รองรับสมาร์ทการ์ด ค่าของช่อง ic_price ต้องเป็น -1
fare_rules.txt contains_route_id รหัส ไม่บังคับ

ส่วนขยาย Google Transit

ค่าโดยสารนี้ใช้ได้กับการเดินทางที่ไปยังชุดเส้นทางที่ตรงกันทั้งหมดซึ่งระบุโดยค่า route_id ในแถวทั้งหมดสำหรับชุดค่าผสมนี้ของคอลัมน์ fare_id, origin_id และ destination_id

หากไม่มีคอลัมน์ contains_route_id หรือค่าทั้งหมดของคอลัมน์นี้สำหรับราคานี้มีค่าว่าง แสดงว่าราคาไม่จํากัดในพารามิเตอร์นี้ หากระบุช่อง contains_route_id สำหรับค่าโดยสาร ช่อง route_id ต้องว่างเปล่า
routes.txt checkin_duration จำนวนเต็ม ไม่บังคับ

ส่วนขยาย Google Transit

ช่อง checkin_duration จะระบุจำนวนวินาทีที่แนะนำให้ผู้โดยสารมาถึงก่อนเวลาออกเดินทางตามกำหนดการเพื่อเช็คอินและขึ้นเครื่อง

หากผู้โดยสารเชื่อมต่อกับจุดออกเดินทางด้วยการเปลี่ยนเครื่อง เวลาเปลี่ยนเครื่องที่กําหนดจะลบล้างค่า checkin_duration

ค่า checkin_duration เป็นเพียงคําแนะนําที่ผู้ให้บริการขนส่งสาธารณะมักจะระบุ ซึ่งอาจไม่ได้แสดงถึงเวลาที่ผู้โดยสารจะมาถึงได้มากที่สุดและยังขึ้นรถได้
routes.txt route_type ค่าแจกแจง ต้องระบุ

ส่วนขยาย Google Transit

ดูวิธีที่ Google Transit ขยายตัวเลือกค่า route_type ที่ GTFS ยอมรับได้ที่ ประเภทเส้นทาง GTFS ที่ขยาย
stop_times.txt stop_direction_name ข้อความ ไม่บังคับ

ส่วนขยาย Google Transit

ช่อง stop_direction_name จะระบุทิศทางของการเดินทางให้แก่ผู้โดยสาร ระบบจะจัดเก็บทิศทางเป็นdirection_name ค่าของจุดออกเดินทางจากป้ายจอดรถนี้

หากช่อง stop_direction_name ว่างเปล่า ระบบจะใช้ช่อง trip_direction_name ที่รองรับขนส่งสาธารณะแทน หากทั้งช่อง trip_direction_name และ stop_direction_nameว่างเปล่า ผู้นำเข้าข้อมูลขนส่งจะปล่อยช่องดังกล่าวว่างไว้ ในกรณีนี้ พาร์ทเนอร์จะใช้ค่า stop_headsign หรือ trip_headsign แทนได้ ค่าของช่อง stop_direction_name จะเปลี่ยนเป็นตัวพิมพ์เล็กทั้งหมด
stops.txt signposted_as ข้อความ ไม่บังคับ

ส่วนขยาย Google Transit

ช่อง signposted_as มีข้อความที่เขียนตามตัวอักษรบนป้ายของแพลตฟอร์ม เช่น "ไปทางเซ็นทรัล" และ "ฝั่งตะวันออกและบรูคลิน"

คุณสามารถตั้งค่าฟิลด์ GTFS platform_code และฟิลด์ signposted_as ที่รองรับขนส่งสาธารณะพร้อมกันได้

ความแตกต่างระหว่างช่อง platform_code และ signposted_as มีดังนี้

  • ความยาว ช่อง platform_code มักจะมีตัวเลขหรือตัวอักษร เช่น 2 หรือ C
  • ภาษา ช่อง platform_code ไม่มีภาษา แต่ค่า signposted_as อาจมีคำแปล
  • ความเสถียร ช่อง platform_code เปลี่ยนแปลงน้อยกว่าช่อง signposted_as มาก
stops.txt vehicle_type จำนวนเต็ม ไม่บังคับ

ส่วนขยาย Google Transit

ช่อง vehicle_type จะระบุประเภทยานพาหนะที่ใช้ในป้ายจอดรถ ฟิลด์นี้ยอมรับประเภทเส้นทางประเภทยานพาหนะตามลําดับชั้น (HVT) ค่า HVT มาจากมาตรฐานของกลุ่มผู้เชี่ยวชาญด้านโปรโตคอลการขนส่งของยุโรป (TPEG)
agency.txt ticketing_deep_link_id รหัส ไม่บังคับ

ส่วนขยายการจำหน่ายตั๋วของ Google Transit

ในไฟล์ agency.txt ช่อง ticketing_deep_link_id จะแสดง Deep Link ที่ใช้ในการจองตั๋วเดินทางของเอเจนซีนี้
routes.txt ticketing_deep_link_id รหัส ไม่บังคับ

ส่วนขยายการจำหน่ายตั๋วของ Google Transit

ในไฟล์ routes.txt ช่อง ticketing_deep_link_id จะแสดง Deep Link ที่ใช้เพื่อออกตั๋วสำหรับการเดินทางของเส้นทางนี้
stop_times.txt ticketing_stop_time_id รหัส ไม่บังคับ

ส่วนขยายการจำหน่ายตั๋วของ Google Transit

หากมีอยู่ในไฟล์ stop_times.txt ช่อง ticketing_stop_time_id จะลบล้างตัวระบุที่แสดงถึงเวลาหยุดจำหน่ายตั๋วด้วย Deep Link
stop_times.txt ticketing_type ค่าแจกแจง ไม่บังคับ

ส่วนขยายการจำหน่ายตั๋วของ Google Transit

ฟิลด์ ticketing_type จะระบุประเภทตั๋วที่ใช้กับเวลาหยุดนี้

Google Transit ยอมรับค่าต่อไปนี้

  • Empty ค่าเริ่มต้น - ตามที่กำหนดโดยการเดินทาง
  • 0 พร้อมใช้งานเฉพาะในกรณีที่เอเจนซีหรือเส้นทางมี Deep Link สำหรับการซื้อตั๋วที่เปิดใช้
  • 1 ไม่พร้อมใช้งาน
ticketing_deep_links.txt android_intent_uri URI ไม่บังคับ

ส่วนขยายการจำหน่ายตั๋วของ Google Transit

ช่อง android_intent_uri แสดง URI ของ Intent ที่ใช้ในการทํา Deep Link ใน Android
ticketing_deep_links.txt ios_universal_link_url URL ไม่บังคับ

ส่วนขยายการจำหน่ายตั๋วของ Google Transit

ช่อง ios_universal_link_url แสดง URL ของ Universal Link ที่ใช้สำหรับ Deep Link ใน iOS
ticketing_deep_links.txt ticketing_deep_link_id รหัส ต้องระบุ

ส่วนขยายการจำหน่ายตั๋วของ Google Transit

ช่อง ticketing_deep_link_id แสดงตัวระบุของ Deep Link
ticketing_deep_links.txt web_url URL ไม่บังคับ

ส่วนขยายการจำหน่ายตั๋วของ Google Transit

ช่อง web_url แสดง URL ที่ใช้สำหรับ Deep Link บนเว็บ
ticketing_identifiers.txt agency_id รหัส ต้องระบุ

ส่วนขยายการจำหน่ายตั๋วของ Google Transit

หากต้องการระบุบริษัทขนส่งของป้ายจอดรถที่กำหนดค่าช่อง ticketing_stop_id เริ่มต้นไว้ ให้ช่อง agency_id มีรหัสจากไฟล์ GTFS agency.txt
ticketing_identifiers.txt stop_id รหัส ต้องระบุ

ส่วนขยายการจำหน่ายตั๋วของ Google Transit

หากต้องการระบุป้ายจอดรถที่กำหนดค่าให้กับช่อง ticketing_stop_id เริ่มต้น ช่อง stop_id จะต้องมีรหัสจากไฟล์ GTFS stops.txt
ticketing_identifiers.txt ticketing_stop_id รหัส ต้องระบุ

ส่วนขยายการจำหน่ายตั๋วของ Google Transit

ฟิลด์ ticketing_stop_id มีรหัสตั๋วที่ใช้กับป้ายจอดรถ หน่วยงานจะรับรองบัตรหรือไม่ก็ได้
trips.txt exceptional ค่าแจกแจง ไม่บังคับ

ช่องนี้ระบุการเดินทางที่ไม่ปกติ รถไฟดังกล่าวจะออกนอกกำหนดการปกติหรือเปลี่ยนเส้นทางจากเส้นทางปกติเนื่องจากมีกิจกรรมพิเศษหรือการหยุดชะงักตามแผน (เช่น มีการซ่อมราง ฯลฯ)

Google ยอมรับตัวเลือกค่าต่อไปนี้

  • 0 บริการปกติ
  • 1 ข้อยกเว้นของบริการ เช่น บริการที่เพิ่มเนื่องจากกิจกรรมพิเศษหรือบริการที่เปลี่ยนเส้นทางจากเส้นทางปกติเนื่องจากมีการหยุดชะงักตามแผน
trips.txt ticketing_trip_id รหัส ไม่บังคับ

ส่วนขยายการจำหน่ายตั๋วของ Google Transit

หากมีฟิลด์ ticketing_trip_id ค่าของฟิลด์จะลบล้างฟิลด์ trip_id เพื่อระบุการเดินทางสำหรับการจำหน่ายตั๋วด้วย Deep Link
trips.txt ticketing_type ค่าแจกแจง ไม่บังคับ

ส่วนขยายการจำหน่ายตั๋วของ Google Transit

ฟิลด์ ticketing_type จะระบุประเภทตั๋วที่ใช้กับการเดินทางนี้

Google Transit ยอมรับค่าต่อไปนี้

  • 0 ค่าเริ่มต้น ใช้ได้ก็ต่อเมื่อเอเจนซีหรือเส้นทางมี Deep Link สำหรับการจองตั๋วที่เปิดใช้อยู่
  • 1 ไม่พร้อมใช้งาน
translations.txt lang รหัสภาษา ไม่บังคับ

ส่วนขยาย Google Transit

ฟิลด์ lang ไม่ได้เป็นส่วนหนึ่งของ GTFS อย่างเป็นทางการ แต่ Google Transit จะใช้ค่านี้เมื่อมี

หากต้องการระบุคำแปลของวลี ให้ใช้ช่อง lang ค่าต้องไม่ว่างเปล่าหรือเป็น und (ภาษาที่ไม่ระบุ)
translations.txt trans_id รหัส ไม่บังคับ

ส่วนขยาย Google Transit

ฟิลด์ trans_id ไม่ได้เป็นส่วนหนึ่งของ GTFS อย่างเป็นทางการ แต่ Google Transit จะใช้ค่านี้หากมี

หากต้องการระบุโทเค็นระบุตัวตนของวลีที่มีคำแปล ให้ใช้ช่อง trans_id แต่ละแถวของตาราง translations.txt หมายความว่าในภาษา lang วลี trans_id จะแปลเป็น translation
trips.txt original_trip_id รหัส ไม่บังคับ

ส่วนขยาย Google Transit

หากมีอยู่ในไฟล์ trips.txt ค่า original_trip_id จะลบล้างค่า trip_id สำหรับระบบอื่นๆ ตัวอย่างหนึ่งคือการจับคู่แบบเรียลไทม์
trips.txt trip_direction_name ข้อความ ไม่บังคับ

ส่วนขยาย Google Transit

ช่อง trip_direction_name จะระบุทิศทางของการเดินทางให้แก่ผู้โดยสาร ระบบจะจัดเก็บค่าในช่องนี้เป็นค่า direction_name ของการเดินทางแต่ละครั้ง

หากค่า stop_direction_name ในตาราง stop_times มีการเปลี่ยนแปลงตลอดการเดินทาง ค่าดังกล่าวอาจลบล้างค่า trip_direction_name

ค่าในช่อง trip_direction_name จะแปลงให้เป็นอักษรตัวพิมพ์เล็ก
trips.txt vehicle_category_id รหัส ไม่บังคับ

ส่วนขยาย Google Transit

ในไฟล์ trips.txt ฟิลด์ vehicle_category_id จะระบุยานพาหนะที่กําหนดไว้สําหรับการเดินทางนี้ เมื่อช่องนี้อยู่ในไฟล์ trips.txt ค่าของช่องจะลบล้างค่า vehicle_category_id ในไฟล์ routes.txt