مسرد المصطلحات

يحدّد مسرد المصطلحات هذا المصطلحات الرئيسية المستخدَمة في مستندات "دمج شركاء النقل".

رمز الحجز: هو سلسلة اختيارية ينشئها الشريك ويمكن تمريرها في رابط التذاكر لضمان اتّساق السعر وبرنامج الرحلة بين نتائج البحث على Google وصفحة الحجز الخاصة بالشريك.

ربط JSON الأساسي: مجموعة معيّنة من القواعد التي تحدّدها Protocol Buffers لتحويل رسالة proto إلى كائن JSON. يتطلّب هذا الدمج استخدام عملية الربط هذه مع خيارات معيّنة لضمان تنسيق الطلبات والردود بشكل صحيح.

مواصفات الخلاصة العامة للنقل العام (GTFS): هي تنسيق بيانات عادي تستخدمه مؤسسات النقل العام لتوفير معلومات حول الجداول الزمنية والمسارات وأسعار التذاكر للمستخدمين. في عملية الدمج هذه، تُعدّ هذه الطريقة إحدى الطريقتَين المتاحتَين لتزويد Google بالبيانات الثابتة.

التكامل المستند إلى GTFS: طريقة تكامل للشركاء الذين يقدّمون بيانات جداولهم الزمنية إلى Google في خلاصة GTFS. يتم استخدام هذا الحقل عندما لا تتوفّر لدى Google جداول المشغّل.

known_itineraries: هو خيار في "إعدادات الشريك" يتيح للشركاء تلقّي قائمة بالرحلات المعروفة من Google لتحسين استجابتهم.

مجموعة الأسواق: (لعمليات الدمج التي تتضمّن محطات توقّف فقط) هي خلاصة اختيارية يقدّمها الشريك لتحديد قائمة معيّنة بأزواج المصدر والوجهة (الأسواق) التي سيقدّم أسعارًا لها. وفي حال توفيرها، تعمل كقائمة مسموح بها.

Partner API / Partner Server API: هي مجموعة واجهات برمجة التطبيقات التي يجب أن يستخدمها الشركاء لتزويد Google بالبيانات الديناميكية، مثل الأسعار ومدى التوفّر في الوقت الفعلي.

اختبار جودة الأسعار: هي عملية مستمرة يجمع فيها زاحف Google عيّنات من برامج الرحلات على الموقع الإلكتروني للشريك للتأكّد من أنّ الأسعار المعروضة للمستخدمين تتطابق مع الأسعار المقدَّمة من خلال Partner API.

عدد طلبات البحث في الثانية (QPS): هو متوسط المعدّل الذي ترسل به Google الطلبات (طلب البحث الواحد هو طلب واحد) إلى خادم Partner API. وقد يتقلب هذا المعدل، مع فترات زيادة أو انخفاض طفيف في عدد الزيارات.

SegmentKey: عنصر مستخدَم في Partner API لتحديد جزء واحد من رحلة بشكل فريد، بما في ذلك نقطة المغادرة والوجهة وتواريخ/أوقات الخدمة.

service_date: يمثّل هذا النوع التاريخ المحدّد الذي تعمل فيه خدمة النقل العام، ويجب تنسيقه على النحو التالي: YYYYMMDD. ويتم استخدامه مع معرّفات أخرى لتحديد مثيل فريد للرحلة.

التكامل مع إيقاف التشغيل فقط: طريقة تكامل للشركاء الذين ليسوا مصدر بيانات الجدول الزمني. يتم استخدام هذه الطريقة عندما تتلقّى Google جداول المشغّل من مصدر آخر. على الشركاء تقديم قائمة بمعرّفات المحطات فقط.

استبدِل ticketing_stop_id: بالمعرّف الفريد الذي يحدّده الشريك لمحطة توقّف أو محطة نقل. يتم توفير هذا المعرّف في خلاصة البيانات الثابتة (إما GTFS أو خلاصة المحطات فقط)، ويتم استخدامه في Partner API وروابط الصفحات في التطبيق الخاصة بالتذاكر.

استبدِل ticketing_trip_id بما يلي: (لعمليات الدمج المستندة إلى GTFS) المعرّف الفريد الذي يحدّده الشريك لرحلة معيّنة، والذي يتم توفيره في ملف trips.txt الخاص بخلاصة GTFS. عمليات الدمج المستندة إلى مواصفات الخلاصة العامة للنقل العام فقط

رابط لصفحة معيّنة في موقع بيع التذاكر: هو عنوان URL يوجّه المستخدم من نتائج البحث على Google إلى الموقع الإلكتروني للشريك لحجز برنامج رحلة محدّد. يحتوي عنوان URL على تفاصيل مُرمّزة حول الرحلة المحدّدة.

TripOptionsErrorType: مجموعة محدّدة من أنواع الأخطاء التي يمكن عرضها في Partner API لتقديم معلومات أكثر تفصيلاً عن سبب تعذُّر تنفيذ الطلب.

UNSPECIFIED قيمة التعداد: هي القيمة الأولى المطلوبة (بقيمة عددية تساوي 0) في أي تعريف للتعداد عند استخدام Protocol Buffers. وهي تعمل كقيمة تلقائية، ويجب التعامل معها بشكل عام على أنّها خطأ إذا تم تلقّيها في طلب.