يشرح هذا الدليل كيفية الدمج مع Google لتوفير تجربة سلسة للمستخدمين في البحث عن وسائل النقل على مساحات عرض مختلفة من Google، بما في ذلك "خرائط Google" و"بحث Google". على مستوى عالٍ، تشمل مواصفات الدمج الرئيسية ما يلي:
- يتوفّر خياران لتقديم البيانات الثابتة:
- عمليات الدمج المستندة إلى مواصفات الخلاصة العامة للنقل العام (GTFS): توفير خلاصة GTFS مع إضافات التذاكر، وذلك في الحالات التي تكون فيها مزوّد بيانات الجدول الزمني. لدينا بعض المتطلبات الإضافية لعملية الدمج المستندة إلى GTFS.
- عملية الدمج التي تتضمّن محطات توقّف فقط: يتم تقديم قائمة بمحطات التوقّف فقط في الحالات التي تتوفّر فيها بيانات الجدول الزمني لدى Google من مصدر آخر.
- مواصفات Partner API لتوفير بيانات ديناميكية:
- إعدادات الشريك: توفير معلومات الشريك، مثل العلامة التجارية وتفاصيل الاتصال
- خادم الشريك: يشير إلى الخوادم التي تتوافق مع واجهات برمجة التطبيقات الخاصة بخادم الشريك.
خطوات الدمج مع Travel Transport
في ما يلي نظرة عامة على الخطوات اللازمة لإنشاء نظام شامل واختباره من أجل توفير ميزات النقل من Google. هناك ثلاث خطوات رئيسية لعملية الدمج:
- مراجعة متطلبات المشاركة
- توفير خلاصة بيانات ثابتة إلى Google
- إتاحة واجهة برمجة التطبيقات Travel Transport API لتفعيل طلبات بحث ديناميكية عن بيانات تتغيّر بسرعة، مثل الأسعار ومعلومات التوفّر تستخدم واجهة برمجة التطبيقات المعرّفات المقدَّمة من خلاصة البيانات الثابتة من الخطوة 1، مثل
ticketing_stop_idلتحديد المحطات.
1. متطلبات المشاركة
تعرض وحدة ميزات النقل من Google برامج الرحلات وخيارات الحجز مع الأسعار. لعرض عرضك في القائمة، يجب توفير رابط بجودة جيدة وسعر نهائي مطابق. لمزيد من التفاصيل، يُرجى مراجعة متطلبات المشاركة.
2. توفير خلاصة بيانات ثابتة
يتوفّر خياران لتقديم البيانات الثابتة، وينطبق كلّ منهما في ظروف معيّنة. المعيار الرئيسي لتحديد الخيار الذي يجب استخدامه هو ما إذا كنت مقدّم بيانات الجدول الزمني لوسائل النقل التي تريد توفير وظيفة الحجز لها. أسهل طريقة لمعرفة ما إذا كان محرّك بحث Google يتضمّن بيانات الجداول الزمنية هي محاولة العثور على رحلات ربط لمشغّل معيّن على "خرائط Google".
| الميزة | الدمج المستند إلى مواصفات الخلاصة العامة للنقل العام | Stop-only integration |
|---|---|---|
| حالة الاستخدام | أنّك تقدّم حاليًا مواصفات الخلاصة العامة للنقل العام (GTFS) مع معلومات الجداول الزمنية والتذاكر. | لدى Google بيانات الجدول الزمني للمشغّل من مصدر آخر. |
| البيانات المطلوبة | معرّفات GTFS | قائمة بمعرّفات المحطات، مع إحداثياتها الجغرافية |
| الجهد | منخفض | متوسط |
ينطبق الخيار 1 إذا كنت مقدّم خلاصة GTFS لمشغّل. في هذه الحالة، عليك أيضًا إعداد خلاصة GTFS لتزويد Google بمعلومات الجدول الزمني أولاً. بعد ذلك، اتّبِع التعليمات الواردة في قسم عملية الدمج المستندة إلى GTFS.
ينطبق الخيار 2 إذا كانت Google تتلقّى بيانات الجدول الزمني للمشغّل من مصدر مختلف. في هذه الحالة، لا نحتاج إلى معلومات الجدول الزمني الكاملة، ولكننا نحتاج إلى قائمة بأرقام تعريف المحطات التي يمكننا استخدامها في Travel Transport API (انظر أدناه). لتقديم قائمة المحطات، اتّبِع التعليمات الواردة في قسم الدمج الخاص بالمحطات فقط.
3- توافق Travel Transport API
لكي يتم إدراجك كشريك حجز مع عرض الأسعار في "وحدة النقل"، يجب أن يتمكّن Google من استرداد أحدث المعلومات حول الأسعار ومدى التوفّر من الشركاء. لتفعيل هذه الميزة، على الشركاء تقديم خدمة تنفّذ واجهات برمجة التطبيقات الخاصة بخادم الشريك.
3.1. تنفيذ Partner Server API
يمكنك الاطّلاع على تفاصيل حول كيفية تنفيذ Partner Server API في مرجع واجهة برمجة التطبيقات وفي دليل خادم الشريك. تتيح واجهة برمجة التطبيقات لـ Google الحصول على أحدث المعلومات المتعلّقة بالأسعار ومدى التوفّر من الشركاء، وستستعين بها Google لإجراء ما يلي:
- إنشاء ذاكرة تخزين مؤقت لعرض الأسعار بسرعة
- الحصول على أحدث الأسعار عندما ينقر المستخدم على برنامج رحلة محدّد
يجب تنفيذ واجهة برمجة التطبيقات Partner Server API إذا كان الشريك يريد أن تعرض Google الأسعار.
3.2. التحقّق من صحة واجهة برمجة التطبيقات واختبارها
بعد أن تقترب عملية تنفيذ واجهة برمجة التطبيقات من الاكتمال وتصبح الخدمة التي تنفّذها جاهزة للعمل، يُرجى التواصل مع transport-help@google.com وإرسال معلومات الخادم إلينا لنتمكّن من بدء عملية التحقّق من صحة عملية التنفيذ.
في المستقبل، نخطّط لتوفير أدوات آلية للتحقّق من صحة تنفيذ واجهة برمجة التطبيقات، ولكنّها غير متاحة بعد.