الاختلافات بين جدول 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 أيضًا استخدام أي من الحقول المحدّدة في هذه الملفات.

الجدول 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 عدد عائم
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 قيم التعداد

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

على الرغم من أنّ Transit تقبل حقول معيّنة محدّدة من خلال GTFS، يفسّرها Transit بشكل مختلف عن حقول 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 المتوافقة مع خدمة Google Transit في الخلاصات الثابتة

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

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

تتوفر إضافة 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 على المعرّف من ملف GTFS agency.txt.
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.