本詞彙表定義了交通運輸合作夥伴整合文件所使用的重要術語。
預訂權杖:合作夥伴產生的選用字串,可傳遞至票務深層連結,有助於確保 Google 搜尋結果和合作夥伴預訂頁面上的價格和行程一致。
標準 JSON 對應:通訊協定緩衝區定義的一組特定規則,用於將 proto 訊息轉換為 JSON 物件。這項整合作業需要使用這項對應和特定選項,才能正確格式化要求和回應。
GTFS (一般大眾運輸動態饋給規格):大眾運輸機構用來向乘客提供時間表、路線和票價資訊的標準資料格式。在這項整合中,這是向 Google 提供靜態資料的兩種方式之一。
以 GTFS 為基礎的整合:合作夥伴可透過這種整合方式,在 GTFS 動態饋給中向 Google 提供自己的時刻表資料。如果 Google 尚未取得營運商的時刻表,就會使用這項功能。
known_itineraries
:合作夥伴設定中的選項,可讓合作夥伴接收 Google 提供的已知行程清單,藉此最佳化回應。
市場組合: (僅適用於停止整合) 合作夥伴提供的選用動態饋給,用於定義特定來源/目的地組合 (市場) 清單,合作夥伴會為這些組合提供價格。如果提供,則會做為許可清單。
合作夥伴 API / 合作夥伴伺服器 API:合作夥伴必須實作這組 API,才能向 Google 提供動態資料,例如即時價格和供應情形。
價格品質測試:Google 檢索器會持續取樣合作夥伴網站上的行程,驗證向使用者顯示的價格是否與透過 Partner API 提供的價格相符。
QPS (每秒查詢次數):Google 向合作夥伴 API 伺服器傳送要求的平均頻率 (一次查詢即為一次要求)。這項比率可能會波動,流量有時會稍微偏高或偏低。
SegmentKey:Partner API 中使用的物件,可專屬識別單一行程,包括出發地、目的地和服務日期/時間。
service_date
:大眾運輸服務的營運日期,格式為 YYYYMMDD
。這個 ID 會與其他 ID 搭配使用,指定不重複的行程執行個體。
僅停止整合:合作夥伴並非節目表資料來源時,可使用這種整合方式。如果 Google 已從其他來源收到營運商的時刻表,就會使用這項功能。合作夥伴只需提供停靠站 ID 清單。
ticketing_stop_id
:合作夥伴為停靠站或車站提供的專屬 ID。
這個 ID 會在靜態資料動態消息 (GTFS 或僅限停靠站) 中提供,並用於合作夥伴 API 和票務深層連結。
ticketing_trip_id
: (適用於以 GTFS 為基礎的整合) 合作夥伴為特定行程提供的專屬 ID,位於 GTFS 動態饋給的 trips.txt
檔案中。僅限以 GTFS 為基礎的整合。
票務深層連結:這類網址會將使用者從 Google 搜尋結果導向合作夥伴網站,預訂特定行程。網址包含所選行程的編碼詳細資料。
TripOptionsErrorType
:Partner API 中可傳回的一組特定錯誤類型,可提供要求失敗原因的詳細資訊。
UNSPECIFIED
列舉值:使用 Protocol Buffers 時,任何列舉定義中都必須有第一個值 (數值為 0)。這是預設值,如果要求中收到這個值,通常應視為錯誤。