تحدد هذه الصفحة مجموعة فرعية من مواصفات تذاكر GTFS، وهي في مرحلة تقديم العرض أثناء إنشاء هذا المستند. تتضمّن هذه الصفحة أيضًا العديد من القيود الإضافية التي تفرضها Google.
المتطلّبات
يجب ملء الحقل departure_time
في stop_times.txt
.
أنواع الحقول الإضافية
يوضح هذا القسم أنواع الحقول الإضافية وتلك التي تحتوي على إضافات من Google. وتتطلّب بعض الحقول قيمًا على شكل معرّف موارد منتظم (URI).
- معرّف الموارد المنتظم (URI): معرّف موارد منتظم (URI) مؤهل بالكامل يتضمن المخطط. ويجب أن تستخدم أي أحرف خاصة في معرّف الموارد المنتظم (URI) أحرف الإلغاء الصحيحة. وللحصول على وصف لكيفية إنشاء قيم معرّف الموارد المنتظم (URI) المؤهَّلة بالكامل، يُرجى الاطّلاع على معرّف الموارد المنتظم (URI) لمعيار RFC 3986: البنية العامة.
امتدادات أو إضافات الملفات
الملفات النصية التي لها الحالة الإضافة هي ملفات متوفرة مسبقًا وتحتاج إلى تمديدها. يجب إضافة الحقول الجديدة التي نعرّفها في الجدول التالي.
الملفات النصية التي تحمل الحالة إضافة هي ملفات جديدة تقدّمها إضافات تذاكر Google Transit. يجب إنشاء هذه الملفات وفقًا لتعريفات الحقول الواردة بعد الجدول التالي. تأكَّد من تضمين هذه الملفات في خلاصتك.
اسم الملف | الحالة | التعريف |
---|---|---|
agency.txt |
الإضافة | إضافة agency.ticketing_deep_link_id . |
routes.txt |
الإضافة | إضافة routes.ticketing_deep_link_id . |
trips.txt |
الإضافة | إضافة trips.trip_ticketing_id وtrips.ticketing_type |
stop_times.txt |
الإضافة | إضافة stop_times.ticketing_type . |
ticketing_identifiers.txt |
الجمع | ملف جديد لمعرفة مزيد من التفاصيل، يُرجى الاطّلاع على تعريفات الحقول. |
ticketing_deep_links.txt |
الجمع | ملف جديد لمعرفة مزيد من التفاصيل، يُرجى الاطّلاع على تعريفات الحقول. |
تعريفات الحقول
agency.txt
(تم تمديد الملف)
اسم الحقل | التواجد في المنزل | التفاصيل |
---|---|---|
ticketing_deep_link_id |
إجراء اختياري |
(رقم التعريف من |
routes.txt
(تم تمديد الملف)
اسم الحقل | التواجد في المنزل | التفاصيل |
---|---|---|
ticketing_deep_link_id |
إجراء اختياري | (رقم التعريف من ticketing_deep_links.txt ) تحدّد رابط الصفحة في التطبيق المطلوب استخدامه لهذا
المسار. في حال توفّره، يستبدل الحقل في agency.txt . |
trips.txt
(تم تمديد الملف)
اسم الحقل | التواجد في المنزل | التفاصيل |
---|---|---|
ticketing_trip_id |
إجراء اختياري |
(رقم التعريف) هو المعرّف المطلوب تمريره في الرابط لصفحة معيّنة. ولا يجب أن تكون فريدة. إذا كانت السمة |
ticketing_type |
إجراء اختياري |
(العدد) حدِّد ما إذا كانت تذاكر هذه الرحلة متوفّرة من خلال رابط لصفحة في التطبيق:
|
stop_times.txt
(تم تمديد الملف)
اسم الحقل | التواجد في المنزل | التفاصيل |
---|---|---|
ticketing_type |
إجراء اختياري |
(التعداد) تحدد ما إذا كانت التذاكر من خلال رابط لصفحة في التطبيق متاحة لوقت التوقف هذا. في حال تحديد
|
ticketing_identifiers.txt
(تمت إضافة الملف)
تتمثل الحالة الأكثر شيوعًا في شراء التذاكر في أن كل محطة يكون لها معرّف لمعالجة الفوترة. قد تستخدم وكالات مختلفة المعرّف نفسه لأي محطة توقف. عندما تخدم عدة وكالات محطة التوقف نفسها، كرِّر عملية الربط هذه لكل وكالة.
اسم الحقل | التواجد في المنزل | التفاصيل |
---|---|---|
ticketing_stop_id |
مطلوب | (رقم التعريف) تحدّد رقم تعريف تلقائيًا لحجز التذاكر لهذه المحطة. |
stop_id |
مطلوب | (رقم التعريف من stops.txt ) المحطة التي يتم تحديد
ticketing_stop_id التلقائي لها. |
agency_id |
مطلوب | (رقم التعريف من agency.txt ) وكالة المحطة التي تم تحديد
ticketing_stop_id التلقائي لها. |
ticketing_deep_links.txt
(تمت إضافة الملف)
اسم الحقل | التواجد في المنزل | التفاصيل |
---|---|---|
ticketing_deep_link_id |
مطلوب | (رقم التعريف) تحدد رقم تعريف لرابط الصفحة في التطبيق. |
web_url |
إجراء اختياري |
(عنوان URL) عنوان URL المطلوب الانتقال إليه للربط بصفحة معيّنة. لا يمكن ترجمة هذا الحقل من خلال |
android_intent_uri |
إجراء اختياري |
(معرّف الموارد المنتظم (URI)) معرّف الموارد المنتظم (URI) المطلوب تمريره إلى تطبيق Android أصلي لغرض
إذا كانت فارغة، يعني ذلك أنّه لا يمكنك إنشاء رابط لصفحة معيّنة في تطبيق Android أصلي. لمزيد من المعلومات عن الروابط لمواضع معيّنة على Android، يُرجى الاطّلاع على إنشاء روابط لصفحات معيّنة في محتوى التطبيق. لا يمكن ترجمة هذا الحقل من خلال |
ios_universal_link_url |
إجراء اختياري |
(عنوان URL) عنوان URL للرابط العام المطلوب استدعاءه على نظام التشغيل iOS. إذا كان هذا الحقل فارغًا، لا يظهر الربط بصفحة معيّنة على نظام التشغيل iOS. لمزيد من المعلومات، يُرجى الاطّلاع على الروابط العامة على نظام التشغيل iOS. لا يمكن ترجمة هذا الحقل من خلال |
العناصر النائبة للحقل في طلب بيانات من واجهة برمجة التطبيقات
يستدعي محرّك بحث Google عناوين URL المحدّدة في ticketing_deep_links.txt
باستخدام المعلَمات التالية:
اسم الحقل | التفاصيل |
---|---|
service_date |
(التاريخ، قابل للتكرار) يوم الخدمة الخاص بالرحلة. استخدِم هذا الحقل لاختيار تاريخ انطلاق الرحلة من محطتها الأولى. يتم تنسيق هذا الحقل كمصفوفة JSON. |
ticketing_trip_id |
(رقم التعريف من يتم تنسيق هذا الحقل كمصفوفة JSON. |
from_ticketing_stop_time_id |
(قابل للتكرار) معرّف بالنسبة إلى وقت التوقف، تكون القيمة على النحو التالي:
يتم تنسيق هذا الحقل كمصفوفة JSON. |
|
(قابل للتكرار) معرّف للحصول على شرح عن اشتقاق القيمة، يُرجى الاطّلاع على يتم تنسيق هذا الحقل كمصفوفة JSON. |
boarding_time |
(معيار ISO 8601، قابل للتكرار) وقت المغادرة، استخدِم هذا الحقل لعرض التاريخ والوقت الفعليَين عندما يركب الراكب المركبة. تتوافق القيمة الزمنية لهذا الحقل مع ISO 8601 مع تنسيق السلسلة التالي:
جميع الأوقات التالية هي نفسها في مناطق زمنية مختلفة:
يتم تنسيق هذا الحقل كمصفوفة JSON. |
arrival_time |
(بتنسيق ISO 8601، قابل للتكرار) وقت الوصول، وقت الوصول، وقت التوقف الذي تنتهي عنده محطة الساق. تتوافق القيمة الزمنية لهذا الحقل مع ISO 8601 مع تنسيق السلسلة التالي:
جميع الأوقات التالية هي نفسها في مناطق زمنية مختلفة:
يتم تنسيق هذا الحقل كمصفوفة JSON. |
أمثلة
في هذا المثال، في ما يلي مقدمة رحلة الراكب:
- في تاريخ الخدمة
20190716
، يبدأ رقم تعريف إصدار التذاكر للرحلةti1
من رقم تعريف حجز تذاكر وقت التوقّف11
إلى رقم تعريف حجز تذكرة الوقت12
. يمكن للركّاب الصعود إلى الطائرة الساعة 2:00 بعد الظهر بالتوقيت العالمي المنسّق، والوصول في الساعة 2:50 بعد الظهر بالتوقيت العالمي المُنسّق. - في تاريخ الخدمة
20190716
، يبدأ رقم تعريف إصدار التذاكر للرحلةti2
من رقم تعريف حجز تذاكر وقت التوقّف21
إلى رقم تعريف حجز تذكرة الوقت22
. وقت الصعود إلى الطائرة في الساعة 3:00 بعد الظهر بالتوقيت العالمي المنسّق (UTC) ويصل عند الساعة 3:50 بعد الظهر بالتوقيت العالمي المنسَّق.
في هذا المثال، قيمة السمة web_url
هي https://examplepetstore.com
.
بناءً على كل هذه المعلومات، استخدِم القيم التالية لمَعلمات الخلاصة لهذه الرحلة:
اسم الحقل | التفاصيل |
---|---|
service_date |
["20190716" ، "20190716"] |
ticketing_trip_id |
["ti1" ، "ti2"] |
from_ticketing_stop_time_id |
["11" ، "21"] |
to_ticketing_stop_time_id |
["12" ، "22"] |
boarding_time |
["2019-07-16T14:00:00+00:00" ، "2019-07-16T15:00:00+00:00"] |
arrival_time |
["2019-07-16T14:50:00+00:00" ، "2019-07-16T15:50:00+00:00"] |
في ما يلي معرّف الموارد المنتظم (URI) النهائي بعد التشفير:
https://examplepetstore.com?service_date=%5B%2220190716%22,%2220190716%22%5D
&ticketing_trip_id=%5B%22ti1%22,%22ti2%22%5D&from_ticketing_stop_time_id=%5B%2211%22,%2221%22%5D
&to_ticketing_stop_time_id=%5B%2212%22,%2222%22%5D&boarding_time=%5B%222019-07-16T14:00:00%2B00:00
%22,%222019-07-16T15:00:00%2B00:00%22%5D&arrival_time=%5B%222019-07-16T14:50:00%2B00:00 %22,%222019-07-16T15:50:00%2B00:00%22%5D
أمثلة على قيم ticketing_stop_id
المختلفة
يمكن أن تتضمّن محطات التوقف أرقام تعريف مختلفة لأغراض بيع التذاكر باستخدام
الحقل ticketing_identifiers.txt
. والقيم التي تظهر بالخط الغامق هي القيم التي يمكن العثور عليها في مكالمة الويب الموضّحة بعد الملفات.
stop.txt |
---|
|
routes.txt |
---|
|
trips.txt |
---|
ti1,everyday,ri1,"TGV INOUI 6603",FR_SNCF_6603 ti2,Everyday,ri1,"TGV INOUI 6681",FR_SNCF_6681 ti3,everyday,ri1,"TGV INOUI 6607",FR_SNCF_6607 |
stop_times.txt |
---|
ti1,1,si1,06:59:00,06:59:00 ti1,2,si2,08:56:00,08:56:00 ti2,1,si1,07:53:00,07:53:00 ti2,2,si2,10:00:00,10:00:00 ti3,1,si1,08:59:00,08:59:00 ti3,2,si2,10:56:00,10:56:00 |
ticketing_identifiers.txt |
---|
si1,وكالة1,4924 si2,وكالة1,4676 |
ticketing_deep_links.txt |
---|
tdl1, https://examplepetstore.com/api/gtfs/web, https://examplepetstore.com/api/gtfs/android, https://examplepetstore.com/api/gtfs/ios |
إذا تم تقديم الطلب في 2019-07-19 وكانت أوقات GTFS حسب المنطقة الزمنية UTC+1، في ما يلي نداء على الويب:
https://examplepetstore.com/api/gtfs/web?service_date=%5B%2220190719%22%5D&ticketing_trip_id=
%5B%22FR_SNCF_6603%22%5D&from_ticketing_stop_time_id=%5B%224924%22%5D&to_ticketing_stop_time_id=
%5B%224676%22%5D&boarding_time=%5B%222019-07-19T05:59:00%2B00:00%22%5&arrival_time=%5B%222019-07-19T07:56:00%2B00:00%22%5D
الممارسات المقترَحة
اتّبِع هذه الاقتراحات لتطبيق إضافات التذاكر في Google Transit:
الإرشادات | |
---|---|
شارِك روابط لصفحات معيّنة بين الوكالات أو المسارات، كلما أمكن ذلك. |
في الخلاصة الثابتة، عندما يكون لوكالات أو مسارات متعدّدة عناوين URL نفسها لروابط صفحات التطبيق، يجب أن تشترك هذه الوكالات أو المسارات في قيمة واحدة للحقل |
ضبط قيم متسقة لـ ticketing_type |
يجب أن تكون القيمة |
عليك ربط ticketing_stop_id لكلّ من المحطات الرئيسية والفرعية. |
نفِّذ عملية الربط لجميع المحطات الرئيسية والفرعية التي تتطلّب بيع التذاكر. في الملف ticketing_identifiers.txt ، لا يتم نشر قيم ticketing_stop_id بين نقطة توقف رئيسية وعناصر فرعية لها. |
يجب ربط ticketing_stop_id لكل وكالة تستخدم المحطة نفسها في الخلاصة. |
في الخلاصة الثابتة، إذا كانت هناك وكالات متعدّدة تتيح بيع التذاكر تشترك في المحطة نفسها، يجب أن تظهر عملية الربط لكل وكالة من الوكالات. لمزيد من التفاصيل، يُرجى الرجوع إلى قسم تعريفات الحقول
للسمة |
استخدِم Android App Links عند الحاجة إلى رابط لصفحة معيّنة في تطبيق Android. |
إذا أراد الشريك فتح تطبيق Android من خلال رابط لصفحة معيّنة، يجب إعداد الرابط لصفحة معيّنة في التطبيق على أنّه رابط تطبيق Android. |
استخدِم الروابط العامة في iOS عندما يكون رابط لصفحة معيّنة في تطبيق iOS مطلوبًا. | إذا أراد الشريك فتح تطبيق iOS من خلال رابط لصفحة معيّنة في التطبيق، يجب إعداده كرابط عام على iOS. |