مرجع واختلافات مواصفات GTFS في الوقت الفعلي لوسائل النقل العام من Google

توضّح هذه الصفحة الاختلافات الرئيسية بين تنسيق GTFS Realtime الرسمي وتطبيق Google Transit للمواصفات في الجوانب التالية:

  • المواصفات الرسمية التي تم تجاهلها: هذه الحقول هي جزء من ملف GTFS الرسمي. تُستخدَم هذه البيانات في تطبيق "النقل العام من Google" بدون أي خطأ، ولكن لا يتم استخدامها بشكل استباقي.

  • تفسير مختلف: تتضمّن هذه الحقول أجزاءً من ملف GTFS الرسمي يفسّرها تطبيق "النقل العام في Google" بشكلٍ مختلف عن تعريف GTFS لهذه الأجزاء.

  • الميزات التجريبية: هذه الحقول تجريبية في عملية تنفيذ "النقل العام من Google". إذا كنت تريد تنفيذ حقل تجريبي جديد، يُرجى التواصل مع فريق Google Transit.

  • إضافة متوافقة مع "النقل العام من Google": لا تشكّل هذه الإضافة جزءًا من مواصفات GTFS الرسمية. تتضمّن الإضافة المتوافقة مع "النقل العام" كلّ من الإضافات العامة والإضافات الخاصة بخدمة "النقل العام من Google". يمكن لأي شريك إرسال هذه المعلومات إلى Transit في خلاصته.

معلومات النقل العام في الوقت الفعلي

توثّق الأقسام التالية الاختلافات الرئيسية بين معيار GTFS الرسمي وطريقة Google Transit في تنفيذ خلاصة النقل العام في الوقت الفعلي.

تجاهل المواصفات الرسمية في خلاصات الوقت الفعلي

بعض المواصفات التي يتم تجاهلها هي مواصفات تجريبية. لمزيد من المعلومات، يُرجى الانتقال إلى gtfs.org.

يسرد الجدول 1 الحقول المحدّدة في GTFS والتي يتجاهلها Transit في الخلاصات في الوقت الفعلي.

الجدول 1: الحقول الرسمية التي تم تجاهلها في خلاصات الوقت الفعلي
الرسالة حقل تم تجاهله محدّد في GTFS نوع الحقل
رسالة Alert image TranslatedImage
رسالة Alert image_alternative_text TranslatedString
رسالة Alert severity_level Enum
رسالة 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 سلسلة
الرسالة StopTimeUpdate (في TripUpdate) arrival.uncertainty int32
الرسالة StopTimeUpdate (في TripUpdate) stop_time_properties Proto
رسالة TripUpdate trip_properties Proto
رسالة TripUpdate vehicle VehicleDescriptor
رسالة VehicleDescriptor license_plate سلسلة
رسالة VehicleDescriptor wheelchair_accessible WheelchairAccessible
رسالة VehiclePosition congestion_level Enum
رسالة VehiclePosition current_status VehicleStopStatus
رسالة VehiclePosition current_stop_sequence uint32
رسالة VehiclePosition multi_carriage_details.id سلسلة
رسالة VehiclePosition occupancy_percentage uint32
رسالة VehiclePosition stop_id سلسلة

تفسير مختلف في خلاصات الوقت الفعلي

على الرغم من أنّ Transit تقبل حقولًا معيّنة من GTFS، إلا أنّها تفسّرها بطريقة مختلفة عن GTFS.

يسرد الجدول 2 الحقول المحدّدة في GTFS في خلاصات الوقت الفعلي التي تكون إما اختيارية أو مطلوبة بشكل مشروط من خلال Transit. بالنسبة إلى الحقول الاختيارية، يُظهر الجدول ما إذا كانت قيم التعداد متوافقة مع Transit أم لا.

الجدول 2: حقول الخلاصة في الوقت الفعلي التي يتم تفسيرها بشكلٍ مختلف
اسم الملف الحقل المحدّد في GTFS نوع الحقل هل هذا مطلوب من Google Transit؟ تفاصيل تنفيذ "النقل العام من Google"
الرسالة StopTimeUpdate (في TripUpdate) stop_id سلسلة مطلوبة بشروط

عند تقديم سلسلة stop_id، يجب أن تستوفي أحد الشروط التالية:

  • يجب أن تكون سلسلة stop_id مطابقة للسلسلة الواردة في ملف stops.txt في خلاصة GTFS المقابلة.
  • في حال استخدام سلسلة stop_id مختلفة، يجب أن تكون سلسلة stop_id المقدَّمة سلسلة أخ أو سلسلة فرعية من سلسلة stop_id الأصلية المقدَّمة فيملف GTFS static. يجب أيضًا توفير حقل stop_sequence المقابل.
رسالة StopTimeUpdate schedule_relationship Enum اختياري

تتيح خدمة Google Transit قيم النطاق المحدّد التالية:

  • SCHEDULED
  • SKIPPED
  • NO_DATA
رسالة TripDescriptor schedule_relationship Enum اختياري

لا تتيح خدمة "النقل العام من Google" قيم النطاق المحدّد التالية:

  • DUPLICATED
  • CANCELED—عندما لا يكون مخصّصًا لتسجيل TripUpdate

تتيح Google استخدام قيم enum التالية:

  • SCHEDULED
  • UNSCHEDULED
  • ADDED
  • ‫CANCELED: يمكن استخدامها مع سجلّات TripUpdate فقط

إتاحة ميزة تجريبية في خلاصات الوقت الفعلي

إذا كنت بحاجة إلى دعم لدمج الحقول التجريبية الجديدة، يُرجى التواصل مع Google Transit.

الإضافات المتوافقة مع "النقل العام من Google" في خلاصات الوقت الفعلي

في وقت نشر هذه المقالة، لم تكن هناك حقول تنتمي إلى هذه الفئة. إذا كنت بحاجة إلى أي مساعدة، يُرجى التواصل مع فريق Google Transit.