فرمت لینک تهیه بلیط

برای پیوندهای عمیق، شرکا URL پایه را ارائه می دهند (به پیکربندی شریک مراجعه کنید). پارامترهای پرس و جو که به URL اضافه می کنیم از برنامه افزودنی بلیط حمل و نقل Google با مجموعه ای از پارامترهای اصلاح شده پیروی می کنند:

نام فیلد جزئیات
from_ticketing_stop_time_id

(تکرار شونده) شناسه توقفی که پا از آن شروع می شود.

برای یک زمان توقف خاص، این مقدار stop_id ایستگاه خروج است.

to_ticketing_stop_time_id

(تکرار شونده) معرف توقفی که پا در آن به پایان می رسد.

برای یک زمان توقف خاص، این مقدار stop_id ایستگاه مقصد است.

service_date

(تاریخ، قابل تکرار) روز خدمات سفر.

این فیلد به عنوان یک آرایه JSON، حاوی تاریخ با رشته فرمت زیر قالب‌بندی می‌شود:

YYYYMMDD

boarding_time

(ISO 8601، قابل تکرار) تاریخ و زمان حرکت (departure_time) از stop_time که در آن پا شروع می شود.

مقدار زمانی این فیلد مطابق با ISO 8601 با رشته فرمت زیر است:

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

arrival_time

(ISO 8601، قابل تکرار) تاریخ و زمان رسیدن (زمان_رسیدن) زمان توقف که در آن پا به پایان می رسد.

مقدار زمانی این فیلد مطابق با 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 پیدا کنید.