مرجع جدول GTFS للنقل العام من Google والاختلافات

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

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

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

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

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

معلومات النقل العام الثابتة

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

تم تجاهل المواصفات الرسمية في الخلاصات الثابتة

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

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

الجدول 1: ملفات GTFS غير المتوافقة في الخلاصات الثابتة
areas.txt
fare_leg_rules.txt
fare_products.txt
fare_transfer_rules.txt
levels.txt
stop_areas.txt

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

الجدول 2: حقول GTFS التي تم تجاهلها في الخلاصات الثابتة
اسم الملف حقل تم تجاهله محدّد في GTFS نوع الحقل
fare_attributes.txt payment_method Enum
feed_info.txt default_lang رمز اللغة
feed_info.txt feed_publisher_name نص
pathways.txt max_slope عدد عائم
routes.txt continuous_drop_off Enum
routes.txt continuous_pickup Enum
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 Enum

تفسير مختلف في الخلاصات الثابتة

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

يعرض الجدول 3 الحقول في الخلاصات الثابتة التي تنفّذها Transit بشكل مختلف عن الوصف الواردة في GTFS.

الجدول 3: حقول الخلاصة الثابتة التي تم تنفيذها بشكل مختلف
اسم الملف الحقل المحدّد في GTFS نوع الحقل هل هذا مطلوب من Google Transit؟ تفاصيل تنفيذ "النقل العام من Google"
fare_attributes.txt transfers Enum مطلوب

إضافة Google Transit

تحدّ تنسيق GTFS العام من القيم إلى نطاق يتراوح بين 0 و 2. تقبل خدمة "النقل العام من Google" القيم من 0 إلى 5.

استخدِم هذا الحقل لضبط الحد الأقصى لعدد عمليات النقل المسموح بها باستخدام الأجرة. ولا يشمل ذلك عمليات نقل الوحدات، والتي تُعرف أيضًا باسم عمليات نقل المقاعد. إذا كنت لا تريد وضع حدود لعدد عمليات النقل لرحلة معيّنة، اترك الحقل transfers فارغًا.
pathways.txt pathway_mode Enum اختياري عند تحديد الحقل pathway_mode، إذا تم تركه فارغًا، يقبل محرّك بحث Google Transit هذا الحقل ويتعامل معه على أنّه غير معروف.
stop_times.txt arrival_time الوقت مطلوبة بشروط تقتصر ساعات العمل على القيم من 00 إلى 99، وهي أكثر من كافية للرحلات التي تستغرق ثلاثة أيام.
transfers.txt transfer_type Enum مطلوب

لا يُسمح بقيم 4 و5 ويتم تجاهلها.

تتيح خدمة Google Transit القيم 0 و1 2 و3.
trips.txt block_id رقم التعريف اختياري لمزيد من المعلومات، يُرجى الاطّلاع على مثال على حظر عملية النقل.

إتاحة ميزة تجريبية في الخلاصات الثابتة

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

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

يوفّر الجدول 4 معلومات عن إضافات "النقل العام من Google". هذه الحقول ليست جزءًا من معيار GTFS الرسمي.

الجدول 4: إضافات الخلاصات الثابتة المتوافقة
اسم الملف الحقل نوع الحقل هل هذا مطلوب من Google Transit؟ تفاصيل تنفيذ "النقل العام من Google"
fare_attributes.txt ic_price عدد عائم اختياري

لا تتوفّر إضافة "النقل العام" من Google إلا للشركاء في اليابان.

يمثّل الحقل ic_price المبلغ المخفَّض الذي يجب دفعه مقابل هذه الأجرة باستخدام بطاقة ذكية. إذا لم يتم منح أي خصومات على هذه الأجرة أو إذا لم تكن البطاقة الذكية متوافقة، يجب أن تكون قيمة الحقل ic_price هي -1.
fare_rules.txt contains_route_id رقم التعريف اختياري

إضافة Google Transit

لا تنطبق هذه الأجرة إلا على الرحلات التي تتضمن مجموعة محددة من المسارات التي تم تحديدها من خلال قيمة route_id في جميع الصفوف لهذه المجموعة من أعمدة fare_id وorigin_id و destination_id.

إذا لم يكن عمود contains_route_id متوفّرًا، أو كانت كل قيمه لهذه الأجرة فارغة، لن تكون الأجرة مقيّدة في هذه المَعلمة. إذا تم تقديم حقل contains_route_id لرحلة جوية، يجب أن يكون حقل route_id فارغًا.
routes.txt checkin_duration عدد صحيح اختياري

إضافة Google Transit

يحدِّد الحقل checkin_duration عدد الثواني التي يُنصح فيها الراكب بالوصول قبل موعد المغادرة المقرر من أجل تسجيل الوصول والصعود إلى الطائرة.

إذا كان المسافر يصل إلى نقطة المغادرة من خلال عملية نقل، سيتم إلغاء قيمة checkin_duration بأي وقت محدد لعملية النقل.

إنّ قيمة checkin_duration هي اقتراح فقط يقدّمه عادةً مشغّل النقل العام. وقد لا يعكس ذلك آخر لحظة ممكنة يمكن فيها للمسافر الوصول إلى المركبة.
routes.txt route_type Enum مطلوب

إضافة Google Transit

للتعرّف على كيفية توسيع نطاق خيارات قيمة route_type المقبولة في GTFS، يمكنك الاطّلاع على أنواع المسارات الموسّعة في GTFS.
stop_times.txt stop_direction_name نص اختياري

إضافة Google Transit

يحدِّد الحقل stop_direction_name اتجاه الرحلة للمسافرين. يتم تخزين الاتجاه كقيمة direction_name لمغادرة هذه المحطة.

إذا كان حقل stop_direction_name فارغًا، يتم استخدام الحقل Transit-supported trip_direction_name بدلاً من ذلك. إذا كان حقلَا trip_direction_name وstop_direction_name فارغَين، يتركهما مستورِد السلع العابرة فارغَين. في هذه الحالة، يمكن للشركاء استخدام القيمة stop_headsign أو trip_headsign بدلاً من ذلك. يتم توحيد حالة أحرف قيم الحقل stop_direction_name.
stops.txt signposted_as نص اختياري

إضافة Google Transit

يحتوي الحقل signposted_as على النص الحرفي المكتوب على لوحة العرض الخاصة بالمنصة. وتشمل الأمثلة "باتجاه وسط المدينة" و "الجانب الشرقي وبروكلينغ".

يمكن ضبط حقل GTFS platform_code وحقل Transit-supported signposted_as في الوقت نفسه.

تشمل الاختلافات بين الحقلَين platform_code signposted_as ما يلي:

  • الطول: يحتوي الحقل platform_code عادةً على رقم أو حرف مثل 2 أو C.
  • اللغة: لا يحتوي الحقل platform_code على لغة، ولكن يمكن أن تحتوي قيم signposted_as على ترجمات.
  • الثبات: يتغيّر الحقل platform_code بمعدل أقل بكثير من الحقل signposted_as.
stops.txt vehicle_type عدد صحيح اختياري

إضافة Google Transit

يحدِّد حقل vehicle_type نوع المركبات التي يتم استخدامها في محطة الحافلات. يقبل هذا الحقل أنواع المسارات التي تندرج ضمن نوع المركبات الهرمي (HVT). يتم اشتقاق قيم HVT من معيار مجموعة الخبراء الأوروبيين في بروتوكول النقل (TPEG).
agency.txt ticketing_deep_link_id رقم التعريف اختياري

إضافة بيع التذاكر في "النقل العام من Google"

في ملف agency.txt، يمثّل الحقل ticketing_deep_link_id الرابط لصفحة في التطبيق الذي يُستخدَم لحجز تذاكر الرحلات في هذه الوكالة.
routes.txt ticketing_deep_link_id رقم التعريف اختياري

إضافة بيع التذاكر في "النقل العام من Google"

في ملف routes.txt، يمثّل الحقل ticketing_deep_link_id الرابط لصفحة في التطبيق الذي يُستخدَم لحجز الرحلات في مسار هذا.
stop_times.txt ticketing_stop_time_id رقم التعريف اختياري

إضافة بيع التذاكر في "النقل العام من Google"

إذا كان الحقل ticketing_stop_time_id متوفّرًا في ملف stop_times.txt، سيحلّ محل المعرّف الذي يمثّل وقت إيقاف بيع التذاكر باستخدام الروابط لصفحات في التطبيق.
stop_times.txt ticketing_type Enum اختياري

إضافة بيع التذاكر في "النقل العام من Google"

يحدِّد الحقل ticketing_type نوع التذاكر التي تنطبق على وقت التوقف هذا.

تقبل خدمة Google Transit القيم التالية:

  • Empty. الإعداد التلقائي: كما هو محدّد في الرحلة.
  • 0: لا يتوفّر هذا الخيار إلا إذا كانت الوكالة أو المسار يتضمّنان رابطًا لصفحة معيّنة في التطبيق مخصّصًا لحجز التذاكر ومفعّلاً.
  • 1: غير متاح.
ticketing_deep_links.txt android_intent_uri معرّف الموارد المنتظم (URI) اختياري

إضافة بيع التذاكر في "النقل العام من Google"

يمثّل الحقل android_intent_uri معرّف الموارد المنتظم للهدف الذي يُستخدَم لإنشاء روابط لصفحات في التطبيق على Android.
ticketing_deep_links.txt ios_universal_link_url عنوان URL اختياري

إضافة بيع التذاكر في "النقل العام من Google"

يمثّل الحقل ios_universal_link_url عنوان URL لرابط عالمي يتم استخدامه للربط بصفحة معيّنة في التطبيق على نظام التشغيل iOS.
ticketing_deep_links.txt ticketing_deep_link_id رقم التعريف مطلوب

إضافة بيع التذاكر في "النقل العام من Google"

يمثّل الحقل ticketing_deep_link_id المعرّف للرابط لصفحة معيّنة في التطبيق.
ticketing_deep_links.txt web_url عنوان URL اختياري

إضافة بيع التذاكر في "النقل العام من Google"

يمثّل الحقل web_url عنوان URL المستخدَم لربط صفحة معيّنة على الويب.
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 Enum اختياري

يشير هذا الحقل إلى الرحلات الاستثنائية. تعمل هذه الخدمات خارج الجدول الزمني المعتاد أو يتم تحويلها عن المسار المعتاد بسبب أحداث خاصة أو انقطاعات مخططة (مثل أعمال صيانة السكك الحديدية وما إلى ذلك).

تقبل Google خيارات القيمة التالية:

  • 0. الخدمات العادية
  • 1. استثناء الخدمة على سبيل المثال، الخدمات التي تتم إضافتها بسبب أحداث خاصة أو خدمات يتم توجيهها بعيدًا عن المسار المعتاد بسبب انقطاعات مخطّط لها.
trips.txt ticketing_trip_id رقم التعريف اختياري

إضافة بيع التذاكر في "النقل العام من Google"

إذا كان حقل ticketing_trip_id متوفّرًا، تُلغي قيمته حقل trip_id لتحديد الرحلة التي يتم شراء تذاكرها باستخدام الروابط لصفحات في التطبيق.
trips.txt ticketing_type Enum اختياري

إضافة بيع التذاكر في "النقل العام من Google"

يحدّد حقل ticketing_type نوع التذاكر السارية لهذه الرحلة.

تقبل خدمة Google Transit القيم التالية:

  • 0: الإعداد التلقائي. لا يتوفّر إلا إذا كانت الوكالة أو المسار يتضمّنان رابطًا لصفحة معيّنة في التطبيق مفعّلاً لحجز التذاكر.
  • 1: غير متاح.
translations.txt lang رمز اللغة اختياري

إضافة Google Transit

لا يُعدّ الحقل lang جزءًا من معيار GTFS الرسمي، ولكن تستخدم خدمة Google Transit هذه القيمة عند توفّرها.

لتحديد ترجمة عبارة، استخدِم الحقل lang. يجب ألّا تكون قيمته فارغة أو und (لغة غير محدّدة).
translations.txt trans_id رقم التعريف اختياري

إضافة Google Transit

لا يُعدّ الحقل trans_id جزءًا من معيار GTFS الرسمي، ولكن تستخدم خدمة "النقل العام في Google" هذه القيمة عند توفّرها.

لتحديد رمز تعريف العبارة التي يتم تقديم الترجمة لها، استخدِم الحقل trans_id. يشير كل صف من جدول translations.txt إلى أنّه في اللغة lang، تتم ترجمة العبارة trans_id إلى translation.
trips.txt original_trip_id رقم التعريف اختياري

إضافة Google Transit

إذا كانت القيمة original_trip_id متوفرة في ملف trips.txt، سيتم إلغاء القيمة trip_id ليستخدمها أنظمة أخرى. ومن الأمثلة على ذلك المطابقة في الوقت الفعلي.
trips.txt trip_direction_name نص اختياري

إضافة Google Transit

يحدِّد الحقل trip_direction_name اتجاه الرحلة للمسافرين. يتم تخزين القيمة في هذا الحقل كقيمة direction_name لكل رحلة.

إذا تغيّرت قيمة stop_direction_name في جدول stop_times أثناء الرحلة، قد يتم إلغاء قيمة trip_direction_name.

يتم تسويت حالة الأحرف في القيم في حقل trip_direction_name.
trips.txt vehicle_category_id رقم التعريف اختياري

إضافة Google Transit

في ملف trips.txt، يحدّد الحقل vehicle_category_id المركبة المخصّصة لهذه الرحلة. عندما يكون حقل هذا في ملف trips.txt، تلغي قيمته قيمة vehicle_category_id في ملف routes.txt.