ข้อมูลอ้างอิงและความแตกต่างของกำหนดการ GTFS ของ Google แผนการเดินทาง

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

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

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

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

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

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

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

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

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

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

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

ตาราง 2 แสดงช่องทั้งหมดที่กําหนดโดย GTFS ซึ่งละเว้นโดยขนส่งสาธารณะในฟีดแบบคงที่

ตารางที่ 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 ID
routes.txt route_desc ข้อความ
routes.txt route_sort_order จำนวนเต็มที่ไม่เป็นลบ
stops.txt level_id ID
stops.txt stop_desc ข้อความ
stops.txt stop_url URL
stops.txt tts_stop_name ข้อความ
stops.txt bikes_allowed ค่าแจกแจง

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

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

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

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

ส่วนขยาย Google แผนการเดินทาง

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

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

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

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

การสนับสนุนแบบทดลองในฟีดแบบคงที่

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

ส่วนขยายที่สนับสนุนโดย Google แผนการเดินทางในฟีดแบบคงที่

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

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

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

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

ส่วนขยาย Google แผนการเดินทาง

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

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

ส่วนขยาย Google แผนการเดินทาง

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

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

ค่า checkin_duration เป็นเพียงคำแนะนำที่ผู้ประกอบการขนส่งเป็นผู้ระบุเท่านั้น ข้อมูลดังกล่าวอาจไม่แสดงถึงช่วงเวลาสุดท้ายที่เป็นไปได้ที่ผู้โดยสารจะมาถึงและยังขึ้นรถได้
routes.txt route_type ค่าแจกแจง จำเป็น

ส่วนขยาย Google แผนการเดินทาง

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

ส่วนขยาย Google แผนการเดินทาง

ช่อง 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 แผนการเดินทาง

ช่อง signposted_as มีข้อความแบบคำต่อคำบนป้ายของแพลตฟอร์ม เช่น "Towards Central" และ "East side & Brooklyn"

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

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

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

ส่วนขยาย Google แผนการเดินทาง

ช่อง vehicle_type ระบุประเภทยานพาหนะที่จะใช้เมื่อหยุดพัก ช่องนี้ยอมรับประเภทเส้นทางยานพาหนะแบบลำดับชั้น (HVT) ค่า HVT ได้มาจากมาตรฐาน Transport Protocol Experts Group (TPEG) ของยุโรป
agency.txt ticketing_deep_link_id ID ไม่บังคับ

ส่วนขยายการจำหน่ายตั๋วของ Google แผนการเดินทาง

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

ส่วนขยายการจำหน่ายตั๋วของ Google แผนการเดินทาง

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

ส่วนขยายการจำหน่ายตั๋วของ Google แผนการเดินทาง

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

ส่วนขยายการจำหน่ายตั๋วของ Google แผนการเดินทาง

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

Google แผนการเดินทางยอมรับค่าต่อไปนี้

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

ส่วนขยายการจำหน่ายตั๋วของ Google แผนการเดินทาง

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

ส่วนขยายการจำหน่ายตั๋วของ Google แผนการเดินทาง

ช่อง ios_universal_link_url แสดง URL ของลิงก์สากลที่ใช้สำหรับการทำ Deep Link ใน iOS
ticketing_deep_links.txt ticketing_deep_link_id ID จำเป็น

ส่วนขยายการจำหน่ายตั๋วของ Google แผนการเดินทาง

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

ส่วนขยายการจำหน่ายตั๋วของ Google แผนการเดินทาง

ช่อง web_url แสดง URL ที่ใช้สำหรับการทำ Deep Link ในเว็บ
ticketing_identifiers.txt agency_id ID จำเป็น

ส่วนขยายการจำหน่ายตั๋วของ Google แผนการเดินทาง

หากต้องการระบุเอเจนซีของจุดแวะพักที่มีการระบุช่อง ticketing_stop_id เริ่มต้น ช่อง agency_id จะมีรหัสจากไฟล์ GTFS agency.txt
ticketing_identifiers.txt stop_id ID จำเป็น

ส่วนขยายการจำหน่ายตั๋วของ Google แผนการเดินทาง

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

ส่วนขยายการจำหน่ายตั๋วของ Google แผนการเดินทาง

ช่อง ticketing_stop_id มีรหัสตั๋วที่ใช้กับป้ายจอดรถ เอเจนซีจะระบุคุณสมบัติการใช้บัตรประจำตัวประชาชน (ไม่บังคับ)
trips.txt exceptional ค่าแจกแจง ไม่บังคับ

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

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

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

ส่วนขยายการจำหน่ายตั๋วของ Google แผนการเดินทาง

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

ส่วนขยายการจำหน่ายตั๋วของ Google แผนการเดินทาง

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

Google แผนการเดินทางยอมรับค่าต่อไปนี้

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

ส่วนขยาย Google แผนการเดินทาง

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

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

ส่วนขยาย Google แผนการเดินทาง

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

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

ส่วนขยาย Google แผนการเดินทาง

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

ส่วนขยาย Google แผนการเดินทาง

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

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

ค่าในช่อง trip_direction_name จะปรับเป็นตัวพิมพ์ใหญ่
trips.txt vehicle_category_id ID ไม่บังคับ

ส่วนขยาย Google แผนการเดินทาง

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