تنسيق رابط بيع التذاكر

بالنسبة إلى الروابط لصفحات معيّنة، سيقدّم الشركاء عنوان URL الأساسي (راجِع إعدادات الشريك). ستتّبع مَعلمات طلب البحث التي نضيفها إلى عنوان URL إضافة تذاكر Google Transit مع مجموعة معدَّلة من المَعلمات:

اسم الحقل التفاصيل
from_ticketing_stop_time_id

(يمكن تكراره) معرّف المحطة التي تبدأ منها الرحلة.

بالنسبة إلى وقت توقّف معيّن، هذه هي قيمة stop_id لمحطة المغادرة.
to_ticketing_stop_time_id

(يمكن تكراره) معرّف المحطة التي تنتهي فيها الرحلة الفرعية.

بالنسبة إلى وقت توقّف معيّن، هذه هي قيمة stop_id لمحطة الوجهة.
service_date

(تاريخ، قابل للتكرار) يوم الخدمة في الرحلة

يتم تنسيق هذا الحقل كمصفوفة JSON تحتوي على التاريخ بالتنسيق التالي:

YYYYMMDD
boarding_time

(ISO 8601، قابلة للتكرار) تمثّل هذه السمة تاريخ ووقت المغادرة (departure_time) لوقت التوقف الذي تبدأ فيه الرحلة.

تتوافق قيمة الوقت في هذا الحقل مع ISO 8601، مع سلسلة التنسيق التالية:

YYYY-MM-DDThh:mm:ss±hh:mm
arrival_time

(ISO 8601، قابلة للتكرار) تمثّل هذه السمة تاريخ ووقت الوصول (arrival_time) إلى محطة stop_time التي تنتهي فيها الرحلة.

تتوافق قيمة الوقت في هذا الحقل مع ISO 8601، مع سلسلة التنسيق التالية:

YYYY-MM-DDThh:mm:ss±hh:mm
booking_token

(سلسلة) حقل اختياري يُستخدَم لإضافة بيانات إضافية. تأتي هذه القيمة من الردّ الذي تقدّمه واجهة Travel Transport API ويتم إلحاقها بالرابط لصفحة معيّنة في ما يتعلّق ببيع التذاكر.

يجب ألا يتجاوز الحد الأقصى لطول booking_token 100 حرف.

من المفترض أن تظل عملية البحث عن الرحلات تعمل بدون رمز الحجز، ولكن يمكن استخدام هذا الرمز للحفاظ على اتساق الأسعار بين نتائج البحث على Google وصفحة الحجز الخاصة بالشريك.
lang

(اختياري، IETF BCP 47) حقل يُستخدم للإشارة إلى اللغة المحدّدة لموقع الحجز الإلكتروني.

تتوافق قيمة هذا الحقل مع معيار IETF BCP 47، مثل en-US.

إذا لم تكن اللغة المحدّدة متاحة أو لم يتم تمرير الحقل، يجب أن يستخدم موقع الحجز لغة احتياطية.
cur

(ISO 4217، اختياري) حقل يُستخدم للإشارة إلى العملة التي يجب عرض الأسعار بها.

تتوافق قيمة هذا الحقل مع معيار ISO 4217، مثل USD.

إذا تعذّر عرض العملة المحدّدة أو لم يتم تمرير الحقل، يجب أن يستخدم موقع الحجز عملة احتياطية.
utm_source

(سلسلة، اختياري) حقل يُستخدَم للإشارة إلى الموقع الإلكتروني الأعلى مستوى الذي أرسل الزيارات.

القيم المحتمَلة هي google_search وgoogle_maps.

يتم تحديد جميع المَعلمات القابلة للتكرار كمصفوفة JSON، حيث تشير القيم المتعددة إلى محطات النقل. يمكنك العثور على أمثلة على ترميز عناوين URL في أمثلة إضافة Google Transit Ticketing.