總覽
如果您不是 Google 地圖的 GTFS 動態饋給供應商，您的整合方式就是僅提供停靠站資訊。如要進行這項整合，我們需要瞭解您如何識別不同的火車或公車站。
一般動態饋給規格
開始整合時，我們會為每個整合項目建立專屬 ID，例如：ch_google_test (國家/地區代碼、合作夥伴名稱、整合項目) 或 eu_google (區域代碼、合作夥伴名稱)。
合作夥伴會提供 CSV 格式的文字檔，並套用至每個整合項目。每個 CSV 檔案都必須包含標題列，且欄名須與對應動態饋給規格表中的「欄位名稱」相符。
如要允許合作夥伴上傳新版本的車站和市場檔案，我們的團隊會在新手上路程序中，分享每個檔案類型的 SFTP Dropbox 詳細資料。
停止動態饋給規格 (必填)
停靠站檔案應包含下列資料欄：
| 欄位名稱 | 類型 (請參閱 GTFS) | 說明 |
|---|---|---|
stop_id |
ID (必填) | 用於識別停靠站或車站的專屬 ID。較大的電台應只包含單一項目。這項 ID 會用於呼叫合作夥伴伺服器 API，以及票務深層連結。 |
stop_name |
文字 (必填) | 可供使用者閱讀的名稱，用於偵錯停靠站對應、快取填補和價格準確度資料。 |
stop_lat |
緯度 (必填) | 停靠站的緯度。 |
stop_lon |
經度 (必填) | 停靠站的經度。 |
我們將採用自動擷取程序，合作夥伴可持續提供更新的 ZIP 檔案，以反映檔案內資訊的變更。舉例來說，合作夥伴可以擴充停靠站清單，藉此擴大提供的廣告空間。不過，與 GTFS 類似，stop_id 應保持穩定。
市場組合動態饋給規格 (選填)
我們將根據對應的停靠站，為這項整合功能產生市場組合 (包含熱門起點 / 目的地配對的清單)。您可以在該處選擇提供市場組合動態饋給，減少這組市場。
市場組合會做為快取填入服務的允許清單。根據預設，如果未提供任何市場組合，系統會啟用所有市場。如果您提供市場組合，系統只會查詢清單中的市場。如果使用者查詢不在允許清單中的市場，系統仍會傳送特定市場和日期的即時查詢，但不會主動嘗試快取。
市場組合檔案應包含下列資料欄：
| 欄位名稱 | 類型 (請參閱 GTFS) | 說明 |
|---|---|---|
origin_stop_id |
ID (必填) | 市場的來源 stop_id。 |
destination_stop_id |
ID (必填) | 市場的stop_id目的地。 |
合作夥伴設定
使用僅停止整合時，我們需要靜態合作夥伴設定的額外資訊，如「合作夥伴設定」一節所述。
推薦連結規格
預訂連結 (也稱為 Ticketing link) 的格式和參數定義於「售票連結」
合作夥伴 API 參數
Partner API 的 SegmentKeys 參數 (GetBulkTripOptionsRequest) 是以深層連結規格為準。我們使用
SegmentKeys，包括
僅 from_ticketing_stop_time_id、to_ticketing_stop_time_id、service_date、
boarding_time 和 arrival_time，並將 ticketing_trip_id 留空。我們會指定多個 SegmentKey (每個區段各一個)，完整指定路線，包括所有轉乘。