本指南說明如何與 Google 整合,在各種 Google 服務 (包括 Google 地圖和 Google 搜尋) 中,為使用者提供流暢的交通運輸搜尋體驗。大致來說,主要的整合規格包括:
- 提供靜態資料的兩種方式:
- 以 GTFS 為基礎的整合:提供含票務擴充功能的 GTFS 動態饋給,適用於你是時刻表資料供應商的情況。我們對以 GTFS 為基礎的整合方式有其他規定。
- 僅提供停靠站整合:僅提供停靠站清單,適用於 Google 已從其他來源取得時刻表資料的情況。
- 提供動態資料的 Partner API 規格:
- 合作夥伴設定: 提供合作夥伴資訊,例如品牌宣傳和聯絡詳細資料。
- 合作夥伴伺服器: 實作支援合作夥伴伺服器 API 的伺服器。
整合 Travel Transport 的步驟
以下簡要說明如何建構及測試端對端系統,以支援 Google 的交通運輸功能。整合程序主要分為三個步驟:
- 查看參與規定。
- 向 Google 提供靜態資料動態饋給。
- 支援 Travel Transport API,可動態查詢價格和供應情形等快速變動的資料。API 會使用步驟 1 中靜態資料動態饋給提供的 ID (例如
ticketing_stop_id
) 來識別停靠站。
1. 參與規定
Google 的交通運輸功能單元會顯示行程和預訂選項,以及價格。如要在清單中顯示商品,連結品質必須良好,且最終價格相符。詳情請參閱參與規定。
2. 提供靜態資料動態饋給
提供靜態資料的方法有兩種,適用於特定情況。決定使用哪種選項的主要依據是,您是否為要提供預訂功能的交通轉乘服務提供時刻表資料。如要確認 Google 是否已有時刻表資料,最簡單的方法是在 Google 地圖上搜尋特定營運商的路線。
功能 | 以 GTFS 為基礎的整合 | 僅整合停止功能 |
---|---|---|
用途 | 你已提供 GTFS,其中包含時刻表和票務資訊。 | Google 已從其他來源取得該營運商的時刻表資料。 |
必要資料 | GTFS ID。 | 停靠站 ID 清單,以及相應的地理座標。 |
努力 | 低 | 中 |
如果您是營運機構的 GTFS 動態饋給供應商,請採用方法 1。 在這種情況下,你還必須先設定 GTFS 動態饋給,向 Google 提供時刻表資訊。然後按照「以 GTFS 為基礎的整合」一節中的操作說明執行。
如果 Google 已從其他來源收到營運商的時刻表資料,則適用選項 2。在這種情況下,我們不需要完整的時刻表資訊,但仍需要一份停靠站 ID 清單,以便在 Travel Transport API 中使用 (請參閱下文)。如要提供停靠站清單,請按照僅停靠站整合部分的操作說明進行。
3. 支援 Travel Transport API
如要在交通運輸單元中列為預訂合作夥伴並顯示價格,Google 必須能從合作夥伴處擷取最新的價格和供應情形資訊。如要啟用這項功能,合作夥伴必須提供實作 Partner Server API 的服務。
3.1. 實作 Partner Server API
如要瞭解如何實作 Partner Server API,請參閱 API 參考資料和合作夥伴伺服器指南。Google 可透過 API 向合作夥伴取得最新的價格和供應情形資訊,並呼叫 API 執行下列操作:
- 產生快取,快速傳回價格。
- 使用者點選特定行程時,系統會顯示最新價格。
如果合作夥伴希望 Google 顯示價格,就必須導入 Partner Server API。
3.2. API 驗證與測試
API 導入作業即將完成,且導入 API 的服務已開始運作後,請傳送電子郵件至 transport-help@google.com,並附上伺服器資訊,以便我們開始驗證導入作業。
我們計畫在日後提供自動化工具,用於驗證 API 實作項目,但目前尚未推出。