ข้อมูลอ้างอิงและความแตกต่างแบบเรียลไทม์ของ Google Transit GTFS

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

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

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

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

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

ขนส่งสาธารณะแบบเรียลไทม์

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

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

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

ตารางที่ 1 แสดงช่องที่ GTFS กำหนด ซึ่งระบบขนส่งสาธารณะจะไม่สนใจในฟีดแบบเรียลไทม์

ตารางที่ 1 ละเว้นช่องอย่างเป็นทางการในฟีดแบบเรียลไทม์
ข้อความ ช่องละเว้นที่กำหนดไว้ใน GTFS ประเภทช่อง
ข้อความ Alert image TranslatedImage
ข้อความ Alert image_alternative_text TranslatedString
ข้อความ Alert severity_level ค่าแจกแจง
ข้อความ Alert tts_description_text Proto
ข้อความ Alert tts_header_text Proto
ข้อความ CarriageDetails id สตริง
ข้อความ CarriageDetails occupancy_percentage int32
ข้อความ Position bearing ทศนิยม
ข้อความ Position odometer ดับเบิล
ข้อความ Position speed ทศนิยม
ข้อความ Shape encoded_polyline สตริง
ข้อความ Shape shape_id สตริง
message StopTimeUpdate (ใน TripUpdate) arrival.uncertainty int32
message StopTimeUpdate (ใน TripUpdate) stop_time_properties Proto
ข้อความ TripUpdate trip_properties Proto
ข้อความ TripUpdate vehicle VehicleDescriptor
ข้อความ VehicleDescriptor license_plate สตริง
ข้อความ VehicleDescriptor wheelchair_accessible WheelchairAccessible
ข้อความ VehiclePosition congestion_level ค่าแจกแจง
ข้อความ VehiclePosition current_status VehicleStopStatus
ข้อความ VehiclePosition current_stop_sequence uint32
ข้อความ VehiclePosition multi_carriage_details.id สตริง
ข้อความ VehiclePosition occupancy_percentage uint32
ข้อความ VehiclePosition stop_id สตริง

การตีความที่แตกต่างกันในฟีดแบบเรียลไทม์

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

ตารางที่ 2 แสดงช่องที่ GTFS ในฟีดแบบเรียลไทม์ซึ่งอาจไม่บังคับหรือต้องระบุอย่างมีเงื่อนไขสำหรับขนส่งสาธารณะ สำหรับช่องที่ไม่บังคับ ตารางจะแสดงให้เห็นว่า "ขนส่งสาธารณะ" รองรับค่า enum หรือไม่

ตารางที่ 2 ช่องฟีดแบบเรียลไทม์ที่ตีความต่างกัน
ชื่อไฟล์ ช่องที่กำหนดไว้ใน GTFS ประเภทช่อง จำเป็นสำหรับ Google แผนการเดินทางหรือไม่ รายละเอียดการใช้งาน Google แผนการเดินทาง
message StopTimeUpdate (ใน TripUpdate) stop_id สตริง ต้องระบุแบบมีเงื่อนไข

เมื่อมีการระบุสตริง stop_id สตริงนั้นต้องเป็นไปตามเงื่อนไขใดเงื่อนไขหนึ่งต่อไปนี้

  • สตริง stop_id ต้องเหมือนกับสตริง stops.txt ในฟีด GTFS ที่เกี่ยวข้อง
  • หากใช้สตริง stop_id อื่น สตริง stop_id ที่ระบุต้องเป็นสตริงข้างเคียงหรือสตริงย่อยของสตริง stop_id เดิมที่อยู่ใน GTFS แบบคงที่ ต้องระบุช่อง stop_sequence ที่เกี่ยวข้องด้วย
ข้อความ StopTimeUpdate schedule_relationship ค่าแจกแจง ไม่บังคับ

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

  • SCHEDULED
  • SKIPPED
  • NO_DATA
ข้อความ TripDescriptor schedule_relationship ค่าแจกแจง ไม่บังคับ

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

  • DUPLICATED
  • CANCELED เมื่อไม่ใช่สำหรับระเบียน TripUpdate

Google สนับสนุนค่า enum ต่อไปนี้

  • SCHEDULED
  • UNSCHEDULED
  • ADDED
  • CANCELED—รองรับระเบียน TripUpdate เท่านั้น

การสนับสนุนแบบทดลองในฟีดแบบเรียลไทม์

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

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

ไม่มีช่องที่อยู่ในหมวดหมู่นี้ ณ เวลาที่เผยแพร่บทความนี้ หากคุณต้องการความช่วยเหลือ โปรดติดต่อ Google แผนการเดินทาง