نظرة عامة على واجهة برمجة التطبيقات لخادم الشركاء

يقدّم هذا القسم مزيدًا من التفاصيل حول Partner Server API الذي ستحتاج إليه كجزء من عملية الدمج مع Google Transport.

لدمج معلومات الأسعار ومدى التوفّر، على الشركاء تنفيذ Partner API، وتحديدًا طريقة GetBulkTripOptions.

تستخدم واجهة برمجة التطبيقات هذه المفاهيم التالية:

فئة الخدمة

تشير فئة الخدمة إلى مستوى الخدمة العادي المقدَّم لمجموعة من المقاعد أو التذاكر المختلفة. يجب أن تقدّم خيارات السفر التي تتضمّن فئة الخدمة نفسها تجربة مماثلة إلى حد كبير (أنواع المقاعد ووسائل الراحة وما إلى ذلك)، ولكن قد تكون هناك بعض الاختلافات الصغيرة لكل مقعد (مثل مساحة إضافية للأرجل أو مقعد بجانب النافذة أو غير ذلك). سيتم استخدام فئات الخدمات لتزويد المستخدمين بمعلومات حول خيارات السفر المختلفة في رحلة معيّنة.

تقسيم

يصف المقطع جزءًا من رحلة المستخدم يحدث على مركبة واحدة، بما في ذلك جميع السمات ذات الصلة (مثل فئة الخدمة لهذا المقطع).

تحدّد السمة SegmentKey التوقيت الدقيق للمقطع والمركبة، ولكنّها لا تتضمّن أي سمات إضافية تصف الرحلة على متن تلك المركبة.

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