مرجع والاختلافات في الوقت الفعلي لـ Google Transit GTFS

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

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

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

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

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

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

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

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

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

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

الجدول 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 سلسلة
الرسالة 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 قيم التعداد
رسالة VehiclePosition current_status VehicleStopStatus
رسالة VehiclePosition current_stop_sequence uint32
رسالة VehiclePosition multi_carriage_details.id سلسلة
رسالة VehiclePosition occupancy_percentage uint32
رسالة VehiclePosition stop_id سلسلة

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

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

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

الجدول 2. حقول خلاصة الوقت الفعلي في تفسير مختلف
اسم الملف الحقل المحدَّد في GTFS نوع الحقل هل تريد الإضافة إلى Google Transit؟ تفاصيل تنفيذ Google Transit
الرسالة StopTimeUpdate (في TripUpdate) stop_id سلسلة مطلوب بشروط

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

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

يتيح Google Transit قيم التعداد التالية:

  • SCHEDULED
  • SKIPPED
  • NO_DATA
رسالة TripDescriptor schedule_relationship قيم التعداد إجراء اختياري

لا تتوافق خدمة Google Transit مع قيم التعداد التالية:

  • DUPLICATED
  • CANCELED: عندما لا تتوفّر هذه الميزة في سجلّات TripUpdate

يتيح محرّك بحث Google استخدام قيم التعداد التالية:

  • SCHEDULED
  • UNSCHEDULED
  • ADDED
  • CANCELED: غير متاح إلا لسجلات TripUpdate

الدعم التجريبي في خلاصات الوقت الفعلي

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

إضافات Google Transit المتوافقة مع الخدمة في خلاصات الوقت الفعلي

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