停止專用整合

總覽

如果您不是 Google 地圖的 GTFS 動態饋給供應商，則整合作業為「僅停靠站」。針對這項整合，我們需要瞭解您如何識別不同的火車或公車站。

一般動態饋給規格

開始整合時，我們會為每個整合建立專屬 ID，例如：ch_google_test (國家/地區代碼、合作夥伴名稱、整合) 或 eu_google (區域代碼、合作夥伴名稱)。

合作夥伴可以提供包含 CSV 格式文字檔的 ZIP 檔案，以便在全球或個別整合中套用：

範例 1：

  • ch_google_test_stops.txt
  • ch_google_test_markets.txt

範例 2：

  • stops.txt (套用至所有整合)
  • eu_google_integration1_markets.txt
  • eu_google_integration2_markets.txt

停止動態饋給規格 (必填)

停用檔案應包含下列欄：

欄位名稱 類型 (請參閱「GTFS」) 說明
stop_id ID (必填) 用於識別停靠站或車站的專屬 ID。較大的車站應只包含單一項目。這個值會用於呼叫合作夥伴伺服器 API 和票務深層連結。
stop_name 文字 (必填) 用於偵錯停靠站對應、快取填補和價格準確度資料的易讀名稱。
stop_lat 緯度 (必填) 停靠站的緯度。
stop_lon 經度 (必填) 停靠站的經度。

我們會使用自動擷取程序，讓合作夥伴在其中所含資訊有變更時，持續提供更新的 ZIP 檔案。舉例來說，合作夥伴可以擴大提供的廣告空間，方法是擴充停靠站清單。不過，與 GTFS 類似，stop_ids 應保持穩定。

市場集合動態饋給規格 (選填)

我們會根據已對應的停靠站，產生此整合作業的市場集合 (包含熱門原點 / 目的地組合的清單)。接著，您可以提供市場集合動態饋給，藉此減少這組市場。

市場集合會做為許可清單：如果未提供市場集合，整合作業會啟用所有市場。如果提供市場集合，系統會停用不在清單中的任何市場。

市場集合檔案應包含下列欄：

欄位名稱 類型 (請參閱「GTFS」) 說明
origin_stop_id ID (必填) 市場的來源 stop_id。
destination_stop_id ID (必填) 市場的目的地 stop_id。

合作夥伴設定

使用「僅停留」整合時，我們需要額外的合作夥伴靜態設定資訊，如「合作夥伴設定」一節所述。

深層連結的格式和參數會在票務連結中定義

合作夥伴 API 參數

Partner API (GetBulkTripOptionsRequest) 的 SegmentKeys 參數是根據深層連結規格而定。我們使用 SegmentKeys，僅包含 from_ticketing_stop_time_id、to_ticketing_stop_time_id、service_date、boarding_time 和 arrival_time，ticketing_trip_id 則留空。我們會指定多個 SegmentKey (每個路段一個)，完整指定路線，包括所有轉乘。