مشخصات عمومی فید حمل و نقل عمومی (GTFS) یک فرمت موجود برای برنامههای حمل و نقل عمومی و اطلاعات جغرافیایی مرتبط است. یکپارچهسازی مبتنی بر GTFS از GTFS و افزونههای بلیطفروشی گوگل ترانزیت برای انجام مرحله 1 یکپارچهسازی حمل و نقل مسافرتی - ارائه فید دادههای استاتیک - استفاده میکند.
API سرور همکار از شناسههایی مانند ticketing_trip_id که توسط GTFS ارائه میشود، استفاده میکند، بنابراین قبل از استفاده از API، باید یک فید GTFS معتبر وجود داشته باشد. لطفاً مراحل زیر را برای ارائه یک فید GTFS معتبر دنبال کنید.
ایجاد فید استاتیک GTFS
برای اینکه کاربران بتوانند با استفاده از یکپارچهسازی مبتنی بر GTFS، مسیرها و برنامههای سفر بین شهری را جستجو و پیدا کنند، به یک فید GTFS از شرکا نیاز است. دادههای فید GTFS حاوی اطلاعات ثابتی در مورد برنامهها، مسیرها و اطلاعات بلیط خواهد بود که سپس توسط گوگل برای اتصال به API شریک استفاده میشود.
۱. ایجاد حساب کاربری ترانزیت
اگر هنوز تکمیل نشده است، لطفاً به «شروع با Google Transit» بروید و از فرم برای درخواست حساب کاربری استفاده کنید. پس از تکمیل بررسی، یک حساب کاربری ایجاد میشود و داشبورد GTFS در دسترس قرار میگیرد. برای جزئیات بیشتر در مورد نحوه دسترسی و پیکربندی داشبورد ، به «دسترسی به داشبورد شریک Transit» مراجعه کنید.
۲. ایجاد فید GTFS با افزونهها
فید GTFS خود را شامل بخشهای مورد نیاز افزونههای بلیطفروشی گوگل ترنسلیت (جزئیات بیشتر در بخش افزونههای GTFS ) ایجاد کنید. برای اطمینان از بهترین تجربه کاربری، لطفاً الزامات کیفی و بهترین شیوههای GTFS را مطالعه و دنبال کنید.
۳. نامگذاری فید شما
قرارداد نامگذاری فید توصیهشده عبارت است از: agency-region-country_code ، مانند gbus-ca-us ، یا agency-country_code اگر منطقه مورد نیاز نباشد، مثلاً gbus-br . برای فیدهای آزمایشی، قرارداد نامگذاری فید توصیهشده عبارت است از: test-agency-country_code ، مانند test-gbus-ca-us یا test-gbus-br .
۴. آپلود و بهروزرسانی فید شما
برای آپلود و بهروزرسانی دادههای GTFS خود، راهنمای «انتشار دادههای فید GTFS» را دنبال کنید. هر بار که دادهها آپلود میشوند، دادهها از طریق اعتبارسنجی خودکار (که تا 30 دقیقه طول میکشد) وارد میشوند و یک گزارش اعتبارسنجی ایجاد میشود. لطفاً قبل از رفتن به مرحله بعدی، هرگونه خطا را برطرف کنید.
۵. درخواست پیشنمایش محیط
پس از اینکه دادههای GTFS با موفقیت از مرحله اعتبارسنجی عبور کردند، دستورالعملهای مربوط به «دادههای فید خود را با استفاده از پیشنمایش خصوصی آزمایش کنید» را دنبال کنید تا محیط پیشنمایش فعال شود. پس از فعالسازی، دادههای فید آپلود شده در نقشههای گوگل کاربران مجاز قابل مشاهده خواهند بود. در این مرحله، اکنون میتوان از دادههای GTFS برای آزمایش با سرور API نیز استفاده کرد.
۶. درخواست بررسی تضمین کیفیت (QA) در زمان راهاندازی
پس از رفع هرگونه هشدار مشکلساز و مشکلات کیفیت داده در محیط پیشنمایش، بررسی نهایی تضمین کیفیت گوگل قبل از راهاندازی عمومی الزامی است. مشکلاتی که از طریق فرآیند بررسی تضمین کیفیت یافت میشوند، در داشبورد قابل مشاهده خواهند بود و پس از رفع تمام مشکلات معوق، GTFS آماده راهاندازی خواهد بود.
۷. راهاندازی فید
برای دستورالعملهای مربوط به نحوهی در دسترس قرار دادن فید برای عموم، به «راهاندازی فید» مراجعه کنید.