واژه نامه

این واژه نامه اصطلاحات کلیدی مورد استفاده در مستندات یکپارچه سازی شریک حمل و نقل را تعریف می کند.

نشانه رزرو: یک رشته اختیاری و ایجاد شده توسط شریک که می تواند در پیوند عمیق بلیط ارسال شود تا به حفظ ثبات قیمت و برنامه سفر بین نتایج جستجوی Google و صفحه رزرو شریک کمک کند.

Canonical JSON Mapping: مجموعه خاصی از قوانین تعریف شده توسط Protocol Buffers برای تبدیل یک پیام پروتو به یک شی JSON. این یکپارچه سازی مستلزم استفاده از این نقشه برداری با گزینه های خاص است تا درخواست ها و پاسخ ها به درستی قالب بندی شوند.

GTFS (General Transit Feed Specification): فرمت استاندارد داده ای است که آژانس های حمل و نقل عمومی برای ارائه اطلاعات برنامه، مسیر و کرایه به سواران استفاده می کنند. در این ادغام، یکی از دو روش ارائه داده های ثابت به گوگل است.

یکپارچه سازی مبتنی بر GTFS: یک روش یکپارچه سازی برای شرکای که داده های برنامه زمانی خود را در فید GTFS در اختیار Google قرار می دهند. این زمانی استفاده می شود که گوگل از قبل برنامه های اپراتور را نداشته باشد.

known_itineraries : گزینه ای در پیکربندی شریک که به شرکا اجازه می دهد فهرستی از برنامه های سفر شناخته شده را از Google دریافت کنند تا پاسخ خود را بهینه کنند.

مجموعه بازار: (برای ادغام فقط توقف) یک فید اختیاری ارائه شده توسط شریک برای تعریف لیست خاصی از جفت‌های مبدا-مقصد (بازارها) که برای آن قیمت‌گذاری می‌کنند. در صورت ارائه، به عنوان یک لیست مجاز عمل می کند.

Partner API / Partner Server API: مجموعه‌ای از APIهایی که شرکا باید برای ارائه داده‌های پویا به Google، مانند قیمت‌گذاری و در دسترس بودن هم‌زمان، پیاده‌سازی کنند.

تست کیفیت قیمت: فرآیندی در حال انجام که در آن خزنده‌های Google از برنامه‌های سفر در وب‌سایت شریک نمونه‌برداری می‌کنند تا تأیید کنند که قیمت‌های نشان‌داده‌شده به کاربران با قیمت‌های ارائه‌شده از طریق Partner API مطابقت دارند.

QPS (پرسش‌ها در هر ثانیه): میانگین نرخی که Google با آن درخواست‌ها را به سرور API شریک ارسال می‌کند (یک درخواست، یک درخواست). این نرخ ممکن است نوسان داشته باشد، با دوره‌هایی که ترافیک کمی بیشتر یا کمتر است.

SegmentKey: شیء مورد استفاده در Partner API برای شناسایی منحصر به فرد یک مرحله از سفر، از جمله مبدا، مقصد، و تاریخ/زمان خدمات.

service_date : تاریخ خاصی که سرویس حمل و نقل در آن کار می کند، با قالب YYYYMMDD . این در ترکیب با سایر شناسه ها برای تعیین یک نمونه سفر منحصر به فرد استفاده می شود.

یکپارچه سازی فقط توقف: یک روش یکپارچه سازی برای شرکای که منبع داده های زمان بندی نیستند. زمانی استفاده می‌شود که Google برنامه‌های اپراتور را از منبع دیگری دریافت کند. شرکا فقط باید فهرستی از شناسه های توقف خود را ارائه دهند.

ticketing_stop_id : شناسه منحصر به فرد شریک برای یک ایستگاه یا ایستگاه. این شناسه در فید داده ایستا (یا GTFS یا Stop-only) ارائه می‌شود و در API شریک و پیوندهای عمیق تهیه بلیط استفاده می‌شود.

ticketing_trip_id : (برای ادغام مبتنی بر GTFS) شناسه منحصر به فرد شریک برای یک سفر خاص، ارائه شده در فایل trips.txt فید GTFS آنها. فقط ادغام های مبتنی بر GTFS.

Ticketing Deep Link: نشانی اینترنتی که کاربر را از نتایج جستجوی Google به وب سایت شریک هدایت می کند تا یک برنامه سفر خاص را رزرو کند. URL حاوی جزئیات رمزگذاری شده درباره سفر انتخابی است.

TripOptionsErrorType : مجموعه خاصی از انواع خطا که می تواند در Partner API برگردانده شود تا اطلاعات دقیق تری در مورد علت شکست یک درخواست ارائه دهد.

مقدار Enum UNSPECIFIED : اولین مقدار مورد نیاز (با مقدار عددی 0) در هر تعریف enum هنگام استفاده از بافرهای پروتکل. این به عنوان مقدار پیش فرض عمل می کند و در صورت دریافت در یک درخواست، عموماً باید به عنوان یک خطا در نظر گرفته شود.