開始使用

本指南說明如何與 Google 整合,在各種 Google 服務 (包括 Google 地圖和 Google 搜尋) 中,為使用者提供流暢的交通運輸搜尋體驗。大致來說,主要的整合規格包括:

整合 Travel Transport 的步驟

以下簡要說明建構及測試端對端系統的必要步驟,以便支援 Google 的交通運輸功能。整合程序主要分為三個步驟:

  1. 查看參與規定
  2. 向 Google 提供靜態資料動態饋給。
  3. 支援 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 執行下列操作:

  1. 產生快取,快速傳回價格。
  2. 當使用者搜尋特定日期的路線,但我們的快取中顯示的行程沒有價格時,系統會提供最新價格。

如果合作夥伴希望 Google 顯示價格,就必須導入 Partner Server API。

3.2. API 驗證與測試

API 導入作業即將完成,且導入 API 的服務已開始運作後,請傳送電子郵件至 transport-help@google.com,並附上伺服器資訊,我們會開始驗證您的導入作業。

我們計畫在日後提供自動化工具,驗證 API 實作項目,但目前尚未推出。