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

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

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

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

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

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

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

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

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

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

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

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

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

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

ตารางที่ 2 แสดงช่องที่ GTFS กำหนดในฟีดแบบเรียลไทม์ซึ่ง Transit กำหนดว่าไม่บังคับหรือต้องระบุตามเงื่อนไข สําหรับฟิลด์ที่ไม่บังคับ ตารางจะแสดงว่า Transit รองรับค่า Enum หรือไม่

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

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

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

Google Transit รองรับค่า enum ต่อไปนี้

  • SCHEDULED
  • SKIPPED
  • NO_DATA
message TripDescriptor schedule_relationship ค่าแจกแจง ไม่บังคับ

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

  • DUPLICATED
  • CANCELED - ในกรณีที่ไม่ใช่สำหรับบันทึก TripUpdate

Google รองรับค่า enum ต่อไปนี้

  • SCHEDULED
  • UNSCHEDULED
  • ADDED
  • CANCELED - รองรับเฉพาะTripUpdate

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

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

ชิ้นงานที่ Google Transit รองรับในฟีดแบบเรียลไทม์

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