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

หมายเหตุ: หากต้องการดูข้อกำหนดฟีดขนส่งสาธารณะทั่วไปซึ่งเป็นที่ยอมรับอย่างเป็นทางการ (GTFS) ให้ไปที่ gtfs.org หน้านี้มีข้อมูลอัปเดตเกี่ยวกับ ข้อกำหนดอย่างเป็นทางการ ณ วันที่ 21 ธันวาคม 2022 การอัปเดตหลังจากวันที่ดังกล่าวไม่ได้ ที่รองรับ

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

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

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

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

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

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

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

หมายเหตุ: เว็บไซต์ GTFS อย่างเป็นทางการ (gtfs.org) หมายถึงเว็บไซต์ เป็น "ตารางเวลา 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	รหัส
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	ค่าแจกแจง

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

แม้ว่าขนส่งสาธารณะจะยอมรับฟิลด์ที่กำหนดโดย 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	รหัส	ไม่บังคับ	ดูข้อมูลเพิ่มเติมได้ที่ตัวอย่างการบล็อกการโอน

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

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

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

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

ตาราง 4 ส่วนขยายฟีดแบบคงที่ที่รองรับ

ชื่อไฟล์	ช่อง	ประเภทช่อง	ต้องใช้กับ Google แผนการเดินทางไหม	รายละเอียดการใช้งาน Google แผนการเดินทาง
fare_attributes.txt	ic_price	ทศนิยม	ไม่บังคับ	ส่วนขยาย Google แผนการเดินทางนี้มีไว้สำหรับพาร์ทเนอร์ในประเทศต่อไปนี้เท่านั้น Japan ฟิลด์ ic_price จะแสดงจำนวนส่วนลดของ เพื่อชำระค่าโดยสารนี้ด้วยสมาร์ทการ์ด หากไม่มีส่วนลด ที่ระบุเป็นค่าโดยสารนี้ หรือไม่รองรับสมาร์ทการ์ด ค่าของช่อง ic_price ต้องเป็น -1
fare_rules.txt	contains_route_id	รหัส	ไม่บังคับ	ส่วนขยายของ Google แผนการเดินทาง ค่าโดยสารนี้ใช้ได้กับการเดินทางที่เข้าชมบางเส้นทางเท่านั้น ที่ระบุด้วยค่า route_id ในทุกแถว ชุดค่าผสมของ fare_id, origin_id และ destination_id คอลัมน์ หากไม่มีคอลัมน์ contains_route_id หรือคอลัมน์ทั้งหมด ค่าโดยสารนี้เป็น Null จึงไม่มีการจำกัดค่าโดยสาร พารามิเตอร์ หากมีช่อง 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 ทั้ง 2 ช่องว่างเปล่า จากนั้นผู้นำเข้าการขนส่งจะปล่อยช่องว่างไว้ ใน ในกรณีนี้ พาร์ทเนอร์สามารถใช้ stop_headsign หรือ trip_headsign แทน ค่าของแอตทริบิวต์ ช่อง stop_direction_name ได้รับการปรับให้เป็นมาตรฐาน
stops.txt	signposted_as	ข้อความ	ไม่บังคับ	ส่วนขยายของ Google แผนการเดินทาง ช่อง signposted_as มีข้อความแบบคำต่อคำ บนป้ายแสดงแพลตฟอร์ม ตัวอย่างเช่น "ไปยัง Central" และ "ด้านตะวันออกและ บรุกลิน" ฟิลด์ 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 แผนการเดินทาง ช่อง vehicle_type ระบุประเภทของยานพาหนะ ใช้เมื่อหยุด ช่องนี้ยอมรับประเภทยานพาหนะแบบลําดับชั้น (HVT) ประเภทเส้นทาง ค่า HVT ได้มาจาก European Transport มาตรฐาน Protocol Experts Group (TPEG)
agency.txt	ticketing_deep_link_id	รหัส	ไม่บังคับ	ส่วนขยายการจำหน่ายตั๋วของ Google แผนการเดินทาง ใน agency.txt ซึ่งก็คือ ticketing_deep_link_id แสดง Deep Link ที่ใช้ในการจองการเดินทางของ เอเจนซี
routes.txt	ticketing_deep_link_id	รหัส	ไม่บังคับ	ส่วนขยายการจำหน่ายตั๋วของ Google แผนการเดินทาง ใน routes.txt ซึ่งก็คือ ticketing_deep_link_id แสดง Deep Link ที่ใช้ในการจองการเดินทางของ เส้นทาง
stop_times.txt	ticketing_stop_time_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	รหัส	ต้องระบุ	ส่วนขยายการจำหน่ายตั๋วของ 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	รหัส	ต้องระบุ	ส่วนขยายการจำหน่ายตั๋วของ Google แผนการเดินทาง เพื่อระบุเอเจนซีของจุดแวะพักที่เป็นค่าเริ่มต้น ticketing_stop_id กำหนดไว้สำหรับ ฟิลด์ agency_id มีรหัส จาก GTFS agency.txt
ticketing_identifiers.txt	stop_id	รหัส	ต้องระบุ	ส่วนขยายการจำหน่ายตั๋วของ Google แผนการเดินทาง เพื่อระบุจุดแวะพักที่เป็นค่าเริ่มต้น ticketing_stop_id กำหนดไว้สำหรับ ฟิลด์ stop_id มีรหัสจาก GTFS stops.txt
ticketing_identifiers.txt	ticketing_stop_id	รหัส	ต้องระบุ	ส่วนขยายการจำหน่ายตั๋วของ Google แผนการเดินทาง ช่อง ticketing_stop_id มีรหัสการจำหน่ายตั๋วที่ จะถูกนำมาใช้กับการหยุด (ไม่บังคับ) เอเจนซีจะมีคุณสมบัติสำหรับรหัสดังกล่าว
trips.txt	exceptional	ค่าแจกแจง	ไม่บังคับ	ฟิลด์นี้จะแสดงการเดินทางที่ยอดเยี่ยม ซึ่งดำเนินการภายนอก ตามกำหนดการปกติหรือเปลี่ยนเส้นทางออกจากเส้นทางปกติเนื่องจากมีกิจกรรมพิเศษ กิจกรรมหรือการหยุดชะงักที่วางแผนไว้ (เช่น การติดตามการทำงาน ฯลฯ) Google ยอมรับตัวเลือกค่าต่อไปนี้ 0 บริการทั่วไป 1 ข้อยกเว้นของบริการ ตัวอย่างเช่น บริการ ที่เพิ่มขึ้นเนื่องจากกิจกรรมหรือบริการพิเศษถูกเปลี่ยนเส้นทางออกจาก เส้นทางปกติเนื่องจากเหตุขัดข้องที่วางแผนไว้
trips.txt	ticketing_trip_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 (an ภาษาที่ไม่ได้กำหนด)
translations.txt	trans_id	รหัส	ไม่บังคับ	ส่วนขยายของ Google แผนการเดินทาง ฟิลด์ trans_id ไม่ได้เป็นส่วนหนึ่งของ GTFS อย่างเป็นทางการ แต่ Google แผนการเดินทางใช้ค่านี้หากมี เพื่อระบุโทเค็นรหัสของวลีที่มีคำแปล ให้ใช้ช่อง trans_id แต่ละแถวของตาราง translations.txt หมายความว่า ภาษา lang วลี trans_id จะแปลงเป็น translation
trips.txt	original_trip_id	รหัส	ไม่บังคับ	ส่วนขยายของ Google แผนการเดินทาง หากแสดงอยู่ใน trips.txt ค่า original_trip_id ลบล้างค่า trip_id ที่จะใช้โดยระบบอื่น CANNOT TRANSLATE คือการจับคู่แบบเรียลไทม์
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	รหัส	ไม่บังคับ	ส่วนขยายของ Google แผนการเดินทาง ใน trips.txt ซึ่งก็คือ vehicle_category_id เพื่อระบุยานพาหนะที่จัดสรรให้กับการเดินทางนี้ เมื่อใด อยู่ในไฟล์ trips.txt ค่าจะลบล้าง vehicle_category_id ในไฟล์ routes.txt

หมายเหตุ: หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับความแตกต่างระหว่าง GTFS แบบเรียลไทม์กับ Google การใช้งานระบบขนส่งสาธารณะ โปรดดูนี้