تنسيق رابط البحث

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

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

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

قيم stop_id لمحطات المغادرة
to_stop_id

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

تمثّل هذه السمة قيم stop_id لمحطات الوجهة.
search_date

(التاريخ) يوم تقديم الخدمة خلال الرحلة

يحتوي هذا الحقل على التاريخ بالتنسيق التالي:

YYYYMMDD
lang

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

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

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

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

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

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

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

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

يتم تحديد جميع المَعلمات القابلة للتكرار كمصفوفة JSON. بالنسبة إلى from_stop_id وto_stop_id، تمثّل القيم المتعددة محطات متعددة في المواقع الجغرافية للمصدر والوجهة.

أمثلة

في هذا المثال، يبحث المستخدم عن قطارات من locality1 إلى locality2:

  • locality1 خرائط لمحطات تتضمّن stop_id f1 وf2.
  • locality2 خرائط لمحطات تتضمّن stop_id t1 وt2.
  • تاريخ الخدمة هو 20190716.

في هذا المثال، يكون عنوان URL الأساسي هو https://example.com.

بناءً على كل هذه المعلومات، استخدِم القيم التالية للمَعلمات:

اسم الحقل التفاصيل
from_stop_id ‫["f1"، "f2"]
to_stop_id ‫["t1"، "t2"]
service_date 20190716

في ما يلي عنوان URI النهائي بعد الترميز:

https://example.com?from_stop_id=%5B%22f1%22,%22f2%22%5D&to_stop_id=%5B%22t1%22,%22t2%22%5D&search_date=20190716

في الصفحة المقصودة، سيتمكّن المستخدم من الاطّلاع على برامج الرحلات المغادرة من المحطتَين f1 وf2 في 20190716 والوصول إلى t1 وt2. تتوفّر جميع مجموعات المحطات:

  • من f1 إلى t1
  • من f1 إلى t2
  • من f2 إلى t1
  • من f2 إلى t2