الاختلافات بين جدول GTFS وتطبيق 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 في الخلاصات الثابتة. ولا يوفّر 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 قيم التعداد
feed_info.txt default_lang رمز اللغة
feed_info.txt feed_publisher_name النص
pathways.txt max_slope Float
routes.txt continuous_drop_off قيم التعداد
routes.txt continuous_pickup قيم التعداد
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 النص
stops.txt bikes_allowed قيم التعداد

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

على الرغم من أنّ ميزة النقل العام تقبل حقولاً معيّنة محدّدة من خلال مواصفات الخلاصة العامة للنقل العام (GTFS)، تفسرها ميزة النقل العام بشكلٍ مختلف عن مواصفات الخلاصة العامة للنقل العام (GTFS).

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

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

إضافة Google Transit.

تحدّد مواصفات الخلاصة العامة للنقل العام (GTFS) القيم حدودًا تتراوح بين 0 و2. تقبل خدمة Google Transit القيم من 0 إلى 5.

يمكنك استخدام هذا الحقل لضبط الحد الأقصى لعدد عمليات التحويل المسموح بها مع السعر. ولا يشمل ذلك عمليات النقل المحظورة، والمعروفة أيضًا باسم عمليات النقل داخل المقعد. إذا لم تكن تريد وضع حدود لعدد عمليات تحويل سعر ما، اترك الحقل transfers فارغًا.

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

لا يمكن استخدام قيمتَي 4 و5 ويتم تجاهلهما.

تتيح خدمة Google Transit القيم التالية: 0 و1 و2 و3.

trips.txt block_id رقم التعريف إجراء اختياري لمزيد من المعلومات، يُرجى الاطّلاع على مثال على حظر النقل.

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

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

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

يقدّم الجدول 4 معلومات عن إضافات Google Transit. هذه الحقول ليست جزءًا من مواصفات الخلاصة العامة للنقل العام (GTFS) الرسمية.

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

تتوفّر إضافة Google Transit هذه للشركاء في اليابان فقط.

يمثّل الحقل 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 قيم التعداد حقل مطلوب

إضافة Google Transit.

للتعرّف على كيفية تمديد خدمة Google Transit لخيارات قيمة route_type التي يقبلها مواصفات الخلاصة العامة للنقل العام (GTFS)، يُرجى الاطّلاع على أنواع مسارات GTFS الموسّعة.

stop_times.txt stop_direction_name النص إجراء اختياري

إضافة Google Transit.

ويحدّد الحقل stop_direction_name اتجاه الرحلة إلى الركاب. ويتم حفظ الاتجاه على أنّه القيمة direction_name للمغادرة من هذه المحطة.

إذا كان الحقل stop_direction_name فارغًا، سيتم استخدام الحقل trip_direction_name المتوافق مع خدمة النقل العام بدلاً من ذلك. إذا كان الحقلان trip_direction_name وstop_direction_name فارغَين، ستتركهما جهة استيراد النقل العام فارغَين. في هذه الحالة، يمكن للشركاء استخدام القيمة stop_headsign أو trip_headsign بدلاً من ذلك. ويتم تسوية قيم الحقل stop_direction_name لحالة الأحرف.

stops.txt signposted_as النص إجراء اختياري

إضافة Google Transit.

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

يمكن ضبط الحقل platform_code GTFS والحقل 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 Transit

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

routes.txt ticketing_deep_link_id رقم التعريف إجراء اختياري

إضافة التذاكر في Google Transit

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

stop_times.txt ticketing_stop_time_id رقم التعريف إجراء اختياري

إضافة التذاكر في Google Transit

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

stop_times.txt ticketing_type قيم التعداد إجراء اختياري

إضافة التذاكر في Google Transit

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

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

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

إضافة التذاكر في Google Transit

يمثّل الحقل android_intent_uri معرّف الموارد المنتظم (URI) للغرض الذي يتم استخدامه للربط بصفحة معيّنة في Android.

ticketing_deep_links.txt ios_universal_link_url عنوان URL إجراء اختياري

إضافة التذاكر في Google Transit

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

ticketing_deep_links.txt ticketing_deep_link_id رقم التعريف حقل مطلوب

إضافة التذاكر في Google Transit

يمثّل الحقل ticketing_deep_link_id معرِّف رابط الصفحة في التطبيق.

ticketing_deep_links.txt web_url عنوان URL إجراء اختياري

إضافة التذاكر في Google Transit

يمثّل الحقل web_url عنوان URL المستخدَم للربط بصفحة معيّنة على الويب.

ticketing_identifiers.txt agency_id رقم التعريف حقل مطلوب

إضافة التذاكر في Google Transit

لتحديد وكالة المحطة التي تم تحديد حقل ticketing_stop_id التلقائي لها، يحتوي الحقل agency_id على المعرّف من ملف agency.txt GTFS.

ticketing_identifiers.txt stop_id رقم التعريف حقل مطلوب

إضافة التذاكر في Google Transit

لتحديد موضع التوقف الذي تم تحديده في حقل ticketing_stop_id التلقائي، يحتوي الحقل stop_id على المعرّف من ملف GTFS stops.txt.

ticketing_identifiers.txt ticketing_stop_id رقم التعريف حقل مطلوب

إضافة التذاكر في Google Transit

يتضمّن الحقل ticketing_stop_id معرّف طلب الدعم الذي يتم تطبيقه على المحطة. اختياريًا، تؤهل الوكالة المعرّف.

trips.txt exceptional قيم التعداد إجراء اختياري

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

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

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

إضافة التذاكر في Google Transit

إذا كان الحقل ticketing_trip_id متوفّرًا، ستلغي قيمته الحقل trip_id لتحديد الرحلة المرتبطة بحجز التذاكر باستخدام الروابط لصفحات معيّنة.

trips.txt ticketing_type قيم التعداد إجراء اختياري

إضافة التذاكر في Google Transit

يحدّد حقل 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 Transit تستخدم هذه القيمة عند توفّرها.

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

trips.txt original_trip_id رقم التعريف إجراء اختياري

إضافة Google Transit.

وإذا كان متوفرًا في ملف trips.txt، ستلغي القيمة original_trip_id القيمة 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.