شروع به کار

این راهنما نحوه ادغام با Google را توضیح می دهد تا به کاربران یک تجربه جستجوی حمل و نقل یکپارچه در سطوح مختلف Google از جمله Google Maps و Google Search ارائه دهد. در سطح بالا، مشخصات اصلی یکپارچه سازی عبارتند از:

  • دو گزینه برای ارائه داده های استاتیک:
    • یکپارچه‌سازی مبتنی بر GTFS : ارائه یک فید GTFS با پسوندهای صدور بلیط، برای مواردی که شما ارائه‌دهنده داده‌های زمان‌بندی هستید. ما برای ادغام مبتنی بر GTFS نیازهای اضافی داریم.
    • یکپارچه‌سازی فقط توقف : ارائه فقط فهرستی از توقف‌ها، برای مواردی که Google قبلاً داده‌های زمان‌بندی را از منبع دیگری دارد.
  • مشخصات API شریک برای ارائه داده های پویا:

مراحل ادغام با حمل و نقل مسافرتی

در زیر مروری بر مراحل مورد نیاز برای ساخت و آزمایش یک سیستم انتها به انتها برای پشتیبانی از ویژگی های حمل و نقل Google ارائه شده است. سه مرحله اصلی برای ادغام وجود دارد:

  1. بررسی شرایط مشارکت
  2. ارائه فید از داده های ثابت به Google.
  3. پشتیبانی از Travel Transport API برای فعال کردن درخواست‌های پویا از داده‌های با تغییر سریع مانند قیمت‌ها و در دسترس بودن. API از شناسه‌هایی استفاده می‌کند که توسط فید داده‌های استاتیک از مرحله 1 ارائه شده است، برای مثال تیکت ticketing_stop_id برای شناسایی توقف‌ها.

1. الزامات مشارکت

واحد ویژگی های حمل و نقل Google، برنامه های سفر و گزینه های رزرو را با قیمت ها نمایش می دهد. برای نمایش پیشنهاد شما در لیست، یک لینک با کیفیت خوب و یک قیمت نهایی مطابق انتظار می رود. برای جزئیات بیشتر، شرایط مشارکت ما را بررسی کنید.

2. ارائه فید از داده های ایستا

دو گزینه برای ارائه داده های استاتیک وجود دارد که هر کدام در شرایط خاص قابل استفاده هستند. معیار اصلی برای تصمیم گیری اینکه از کدام گزینه استفاده شود این است که آیا شما ارائه دهنده داده های زمانبندی برای اتصالات حمل و نقلی هستید که می خواهید عملکرد رزرو را برای آنها ارائه دهید. ساده‌ترین راه برای بررسی اینکه آیا Google قبلاً داده‌های زمان‌بندی دارد یا نه، تلاش برای یافتن اتصالات برای یک اپراتور خاص در Google Maps است.

ویژگی ادغام مبتنی بر GTFS ادغام فقط توقف
مورد استفاده شما قبلاً برنامه ها و اطلاعات مربوط به بلیط را به GTFS ارائه کرده اید. Google قبلاً داده های برنامه زمانی اپراتور را از منبع دیگری در اختیار دارد.
داده های مورد نیاز شناسه های GTFS لیستی از شناسه های توقف شما، با مختصات جغرافیایی آنها.
تلاش پایین متوسط

اگر شما ارائه دهنده فید GTFS برای یک اپراتور هستید، گزینه 1 اعمال می شود. در این مورد، شما همچنین باید یک فید GTFS راه اندازی کنید تا ابتدا اطلاعات برنامه زمانی را برای Google ارائه کند. سپس دستورالعمل‌های بخش ادغام مبتنی بر GTFS را دنبال کنید.

اگر Google قبلاً داده های برنامه زمانی اپراتور را از منبع دیگری دریافت کرده باشد، گزینه 2 اعمال می شود. در این مورد، ما به اطلاعات کامل زمان‌بندی نیاز نداریم، اما همچنان به فهرستی از شناسه‌های توقف شما نیاز داریم که می‌توانیم در Travel Transport API استفاده کنیم (به زیر مراجعه کنید). برای ارائه لیست توقف ها، دستورالعمل های بخش Stop-only Integration را دنبال کنید.

3. پشتیبانی از API حمل و نقل مسافرتی

Google برای اینکه به‌عنوان شریک رزرو با قیمت‌ها در واحد حمل‌ونقل فهرست شود، باید بتواند آخرین اطلاعات قیمت و در دسترس بودن را از شرکا دریافت کند. برای فعال کردن این امر، شرکا باید سرویسی را ارائه دهند که API های سرور شریک را پیاده سازی کند.

3.1. پیاده سازی API سرور شریک

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

  1. یک کش برای بازگشت سریع قیمت ها ایجاد کنید.
  2. وقتی کاربر روی یک برنامه سفر خاص کلیک می کند، آخرین قیمت را دریافت کنید.

اگر شریک بخواهد قیمت‌ها توسط Google نمایش داده شود، اجرای API سرور شریک الزامی است.

3.2. اعتبارسنجی و آزمایش API

هنگامی که اجرای API شما نزدیک به اتمام است و سرویس پیاده‌سازی آن راه‌اندازی و اجرا می‌شود، لطفاً با اطلاعات سرور به transport-help@google.com تماس بگیرید تا بتوانیم اعتبار پیاده‌سازی شما را شروع کنیم.

در آینده، ما قصد داریم ابزار خودکاری را برای تأیید اجرای API شما ارائه دهیم، اما این هنوز در دسترس نیست.