مواصفات الخلاصة العامة للنقل العام (GTFS) هي تنسيق حالي لجداول النقل العام والمعلومات الجغرافية المرتبطة بها. يستخدِم التكامل المستند إلى GTFS كلاً من GTFS وإضافات Google Transit Ticketing لإكمال الخطوة 1 من عملية تكامل Travel Transport، أي توفير خلاصة بيانات ثابتة.
ستستخدِم Partner Server API معرّفات مثل
ticketing_trip_id التي يوفّرها نظام GTFS، لذا يجب توفُّر خلاصة GTFS صالحة
قبل استخدام واجهة برمجة التطبيقات.
يُرجى اتّباع الخطوات التالية لتقديم خلاصة GTFS صالحة.
إنشاء خلاصة "مواصفات الخلاصة العامة غير المتغيّرة للنقل العام"
للسماح للمستخدمين بالبحث عن الطرق والجداول الزمنية الخاصة بالسفر بين المدن والعثور عليها باستخدام عملية الدمج المستندة إلى GTFS، يجب أن يقدّم الشركاء خلاصة GTFS. ستتضمّن بيانات خلاصة GTFS معلومات ثابتة حول الجداول الزمنية والمسارات ومعلومات التذاكر التي تستخدمها Google بعد ذلك للربط بواجهة برمجة التطبيقات الخاصة بالشريك.
1. إنشاء حساب Transit
إذا لم تكن قد أكملت هذه الخطوة، يُرجى الانتقال إلى البدء باستخدام Google Transit واستخدام النموذج لطلب إنشاء حساب. بعد اكتمال المراجعة، سيتم إنشاء حساب وإتاحة لوحة بيانات GTFS. اطّلِع على مقالة الوصول إلى لوحة تحكّم شركاء Transit لمزيد من التفاصيل حول كيفية الوصول إلى لوحة التحكّم وضبطها.
2. إنشاء خلاصة GTFS مع إضافات
أنشئ خلاصة GTFS تتضمّن الأقسام المطلوبة من إضافات Google Transit Ticketing (يمكنك الاطّلاع على مزيد من التفاصيل في قسم إضافات GTFS). لضمان توفير أفضل تجربة للمستخدمين، يُرجى قراءة متطلبات الجودة وأفضل الممارسات في ما يخص نظام GTFS واتّباعها.
3- تسمية الخلاصة
إنّ اصطلاح التسمية المقترَح للخلاصة هو:
agency-region-country_code، مثل gbus-ca-us، أو
agency-country_code إذا لم تكن المنطقة مطلوبة، مثل
gbus-br. بالنسبة إلى الخلاصات التجريبية، اصطلاح التسمية المقترَح للخلاصة هو:
test-agency-country_code، مثل test-gbus-ca-us أو test-gbus-br.
4. تحميل الخلاصة وتعديلها
اتّبِع دليل نشر بيانات خلاصة GTFS لتحميل بيانات GTFS وتعديلها. في كل مرة يتم فيها تحميل البيانات، ستخضع البيانات لعملية إثبات صحة آلية (تستغرق ما يصل إلى 30 دقيقة)، وسيتم إنشاء تقرير إثبات صحة. يُرجى تصحيح أي أخطاء قبل الانتقال إلى الخطوة التالية.
5- طلب بيئة معاينة
بعد أن تجتاز بيانات GTFS عملية التحقّق بنجاح، اتّبِع التعليمات الواردة في اختبار بيانات الخلاصة باستخدام معاينة خاصة لتفعيل بيئة المعاينة. بعد تفعيل هذه الميزة، ستظهر بيانات الخلاصة التي تم تحميلها في "خرائط Google" للمستخدمين المسموح لهم بذلك. في هذه المرحلة، يمكن أيضًا استخدام بيانات GTFS لاختبار خادم واجهة برمجة التطبيقات.
6. طلب إجراء مراجعة لتأكيد الجودة قبل الإطلاق
بعد معالجة أي تحذيرات ومشاكل متعلّقة بجودة البيانات في بيئة المعاينة، يجب إجراء مراجعة نهائية من فريق ضمان الجودة في Google قبل الإطلاق العلني. ستظهر المشاكل التي تم رصدها من خلال عملية مراجعة ضمان الجودة في لوحة البيانات، وبعد حلّ جميع المشاكل المعلّقة، سيصبح ملف GTFS جاهزًا للإطلاق.
7. إطلاق الخلاصة
يمكنك الاطّلاع على مقالة إطلاق خلاصتك للحصول على تعليمات حول كيفية إتاحة الخلاصة للجميع.