ข้อมูลอ้างอิงและความแตกต่างของกำหนดการ 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 รหัส
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