一般大眾運輸動態饋給規格 (GTFS) 是現有的大眾運輸時間表和相關地理資訊格式。以 GTFS 為基礎的整合作業會使用 GTFS 和 Google 大眾運輸票務擴充功能,完成旅遊運輸整合的步驟 1,也就是提供靜態資料動態饋給。
Partner Server API 會使用 GTFS 提供的 ticketing_trip_id 等 ID,因此必須先有有效的 GTFS 動態饋給,才能使用 API。請按照下列步驟提供有效的 GTFS 動態饋給。
建立 GTFS Static 動態饋給
如要讓使用者透過以 GTFS 為基礎的整合功能,搜尋及查詢城際旅行的路線和時間表,合作夥伴必須提供 GTFS 動態饋給。GTFS 動態饋給資料會包含時刻表、路線和售票服務等靜態資訊,Google 會使用這些資訊連線至合作夥伴 API。
1. 建立 Transit 帳戶
如果尚未完成,請前往「開始使用 Google 大眾運輸」,並使用表單申請帳戶。審查完成後,系統會建立帳戶,並提供 GTFS 資訊主頁。如要瞭解如何存取及設定資訊主頁,請參閱「存取大眾運輸合作夥伴資訊主頁」。
2. 建立含擴充功能的 GTFS 動態饋給
建立 GTFS 動態饋給,其中包含 Google 大眾運輸票務擴充功能的必要部分 (詳情請參閱 GTFS 擴充功能部分)。為確保最佳使用者體驗,請詳閱並遵循 GTFS 品質規定和最佳做法。
3. 為動態饋給命名
建議的動態饋給命名慣例為:
agency-region-country_code,例如 gbus-ca-us,或
agency-country_code (如果不需要區域),例如
gbus-br。測試動態饋給建議採用的命名慣例如下:
test-agency-country_code,例如 test-gbus-ca-us 或
test-gbus-br。
4. 上傳及更新動態消息
請按照「發布 GTFS 動態饋給資料」指南上傳及更新 GTFS 資料。每次上傳資料時,系統都會自動驗證資料 (最多需要 30 分鐘),並產生驗證報告。請先修正所有錯誤,再繼續進行下一個步驟。
5. 要求預覽環境
GTFS 資料通過驗證後,請按照「使用私人預覽功能測試動態饋給資料」一文中的操作說明,啟用預覽環境。啟用後,允許的使用者就能在 Google 地圖中看到上傳的動態消息資料。此時,GTFS 資料也可用於透過 API 伺服器進行測試。
6. 要求進行發布前品質確保審查
在預覽環境中解決所有有問題的警告和資料品質問題後,必須通過 Google 的最終品質保證審查,才能公開發布。透過 QA 審查程序發現的問題會顯示在資訊主頁中,解決所有待處理問題後,GTFS 即可發布。
7. 啟動動態消息
如要瞭解如何公開動態消息,請參閱「發布動態消息」一文。