این راهنما نحوه ادغام با گوگل را توضیح میدهد تا کاربران بتوانند یک تجربه جستجوی یکپارچه حمل و نقل را در سطوح مختلف گوگل، از جمله گوگل مپ و جستجوی گوگل، تجربه کنند. در سطح بالا، مشخصات اصلی ادغام عبارتند از:
- دو گزینه برای ارائه دادههای استاتیک:
- یکپارچهسازی مبتنی بر GTFS : ارائه یک فید GTFS با افزونههای تیکتینگ، برای مواردی که شما ارائهدهنده دادههای زمانبندی هستید. ما الزامات اضافی برای یکپارچهسازی مبتنی بر GTFS داریم.
- ادغام فقط توقف : ارائه فقط لیستی از توقفها، برای مواردی که گوگل از قبل دادههای زمانبندی را از منبع دیگری دارد.
- مشخصات API شریک برای ارائه دادههای پویا:
- پیکربندی شریک : ارائه اطلاعات شریک مانند نام تجاری و اطلاعات تماس.
- سرور همکار : سرورهای پیادهسازی که از APIهای سرور همکار پشتیبانی میکنند.
مراحل ادغام با Travel Transport
در ادامه، مروری بر مراحل مورد نیاز برای ساخت و آزمایش یک سیستم جامع برای پشتیبانی از ویژگیهای حمل و نقل گوگل ارائه شده است. سه مرحله اصلی برای ادغام وجود دارد:
- بررسی الزامات مشارکت
- ارائه فیدی از دادههای استاتیک به گوگل.
- پشتیبانی از API حمل و نقل مسافرتی برای فعال کردن پرسوجوهای پویا از دادههای با تغییر سریع مانند قیمتها و موجودی. این API از شناسههای ارائه شده توسط فید داده استاتیک از مرحله 1، به عنوان مثال
ticketing_stop_idبرای شناسایی ایستگاهها، استفاده میکند.
۱. الزامات مشارکت
واحد ویژگیهای حمل و نقل گوگل، برنامههای سفر و گزینههای رزرو را به همراه قیمتها نمایش میدهد. برای نمایش پیشنهاد شما در لیست، یک لینک با کیفیت خوب و قیمت نهایی مطابق با آن مورد انتظار است. برای جزئیات بیشتر، شرایط مشارکت ما را بررسی کنید.
۲. ارائه فید دادههای استاتیک
دو گزینه برای ارائه دادههای استاتیک وجود دارد که هر کدام در شرایط خاص قابل اجرا هستند. معیار اصلی برای تصمیمگیری در مورد اینکه از کدام گزینه استفاده کنید این است که آیا شما ارائهدهنده دادههای زمانبندی برای اتصالات حملونقلی هستید که میخواهید قابلیت رزرو را برای آنها ارائه دهید. سادهترین راه برای بررسی اینکه آیا گوگل از قبل دادههای زمانبندی دارد یا خیر، تلاش برای یافتن اتصالات برای یک اپراتور خاص در نقشههای گوگل است.
| ویژگی | یکپارچهسازی مبتنی بر GTFS | ادغام فقط در صورت توقف |
|---|---|---|
| مورد استفاده | شما از قبل برنامهها و اطلاعات بلیطفروشی را در اختیار GTFS قرار دادهاید. | گوگل در حال حاضر دادههای برنامه زمانی اپراتور را از منبع دیگری دارد. |
| دادههای مورد نیاز | شناسههای GTFS. | فهرستی از شناسههای توقف شما، به همراه مختصات جغرافیایی آنها. |
| تلاش | کم | متوسط |
گزینه ۱ در صورتی اعمال میشود که شما ارائهدهنده فید GTFS برای یک اپراتور باشید. در این صورت، ابتدا باید یک فید GTFS راهاندازی کنید تا اطلاعات زمانبندی را برای گوگل ارائه دهد. سپس دستورالعملهای موجود در بخش ادغام مبتنی بر GTFS را دنبال کنید.
گزینه ۲ در صورتی اعمال میشود که گوگل از قبل دادههای برنامه زمانی اپراتور را از منبع دیگری دریافت کند. در این حالت، ما به اطلاعات کامل برنامه زمانی نیاز نداریم، اما همچنان به لیستی از شناسههای ایستگاه شما نیاز داریم که میتوانیم در API حمل و نقل مسافرتی (به زیر مراجعه کنید) از آنها استفاده کنیم. برای ارائه لیست ایستگاهها، دستورالعملهای بخش «یکپارچهسازی فقط ایستگاه » را دنبال کنید.
۳. پشتیبانی از API حمل و نقل مسافرتی
برای اینکه گوگل به عنوان شریک رزرو با قیمتهای واحد حمل و نقل فهرست شود، باید بتواند آخرین اطلاعات قیمتگذاری و موجودی را از شرکا دریافت کند. برای فعال کردن این قابلیت، شرکا ملزم به ارائه سرویسی هستند که APIهای سرور شریک را پیادهسازی کند.
۳.۱. پیادهسازی API سرور همکار
جزئیات نحوه پیادهسازی API سرور همکار را میتوانید در مرجع API و در راهنمای سرور همکار بیابید. این API به گوگل اجازه میدهد تا بهروزترین اطلاعات قیمتگذاری و موجودی را از شرکا دریافت کند و توسط گوگل برای موارد زیر فراخوانی خواهد شد:
- برای بازگرداندن سریع قیمتها، یک حافظه پنهان ایجاد کنید.
- وقتی کاربری مسیری را در تاریخ خاصی جستجو میکند که برنامههای سفر را بدون قیمت در حافظه پنهان ما نشان میدهد، آخرین قیمتها را دریافت کنید.
اگر شریک بخواهد قیمتها توسط گوگل نمایش داده شوند، پیادهسازی API سرور شریک الزامی است.
۳.۲. اعتبارسنجی و آزمایش API
به محض اینکه پیادهسازی API شما تقریباً تکمیل شد و سرویس پیادهسازی آن راهاندازی و اجرا شد، لطفاً اطلاعات سرور را به transport-help@google.com ارسال کنید تا بتوانیم اعتبارسنجی پیادهسازی شما را آغاز کنیم.
در آینده، ما قصد داریم ابزارهای خودکاری برای اعتبارسنجی پیادهسازی API شما ارائه دهیم، اما این هنوز در دسترس نیست.