一般大眾運輸動態饋給規格 (GTFS) 是大眾運輸時間表和相關地理資訊的現有格式。以 GTFS 為基礎的整合會使用 GTFS 和 Google 大眾運輸票務擴充功能,完成旅遊大眾運輸整合的步驟 1,並提供靜態資料的動態饋給。
Partner Server API 會使用 GTFS 提供的 ticketing_trip_id
等 ID,因此必須先具備有效的 GTFS 動態饋給,才能使用 API。請按照下列步驟提供有效的 GTFS 動態饋給。
建立 GTFS Static 動態饋給
為了讓使用者透過 GTFS 整合來搜尋及尋找城際旅遊的路線和時間表,合作夥伴需要提供 GTFS 動態饋給。GTFS 動態饋給資料包含時間表、路線和票務資訊的靜態資訊,Google 隨後會使用這些資訊連結合作夥伴 API。
1. 建立 Google 大眾運輸帳戶
如果尚未完成,請前往開始使用 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 品質確保審查。凡是在品質確保審查程序中發現的問題,都會在資訊主頁中顯示。解決所有待處理的問題後,GTFS 就能開始發布。
7. 啟動動態消息
如要瞭解如何公開動態饋給,請參閱「啟動動態饋給」一文。