"مواصفات الخلاصة العامة للنقل العام" (GTFS) هي تنسيق حالي لجداول النقل العام والمعلومات الجغرافية المرتبطة بها. تستخدم عمليات الدمج المستندة إلى GTFS إضافات "خدمة النقل العام" (GTFS) وإضافات تذاكر النقل العام من Google لإنجاز الخطوة 1 من عملية دمج خدمات نقل السفر، أي توفير خلاصة للبيانات الثابتة.
ستستخدم Partner Server API معرّفات مثل ticketing_trip_id التي يتم توفيرها من خلال GTFS، لذلك يجب توفير خلاصة GTFS صالحة قبل استخدام واجهة برمجة التطبيقات.
يُرجى اتّباع الخطوات أدناه لتوفير خلاصة GTFS صالحة.
إنشاء الخلاصة الثابتة GTFS
ليتمكّن المستخدمون من البحث عن المسارات والجداول الزمنية للسفر بين المدن والعثور عليها، يجب توفّر خلاصة GTFS من الشركاء. ستحتوي بيانات خلاصة GTFS على معلومات ثابتة حول الجداول الزمنية والمسارات ومعلومات التذاكر والتي تستخدمها Google بعد ذلك للربط بـ واجهة برمجة التطبيقات الشريكة.
1- إنشاء حساب النقل العام
إذا لم يسبق لك إكمال هذه العملية، يُرجى الانتقال إلى بدء استخدام Google Transit واستخدام النموذج لطلب حساب. بعد اكتمال المراجعة، سيتم إنشاء حساب وستتوفر لوحة بيانات GTFS. للحصول على مزيد من التفاصيل حول كيفية الوصول إلى لوحة البيانات وإعدادها، يُرجى الاطّلاع على الوصول إلى لوحة بيانات شركاء Transit.
2. إنشاء خلاصة GTFS باستخدام الإضافات
أنشِئ خلاصة GTFS، بما في ذلك الأقسام المطلوبة في إضافات تذاكر النقل العام من Google (يمكنك الاطّلاع على مزيد من التفاصيل في قسم إضافات 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. فتح الخلاصة
راجع إطلاق الخلاصة للحصول على تعليمات حول كيفية إتاحة الخلاصة للجمهور.