售票連結格式

如果是深層連結，合作夥伴會提供基本網址 (請參閱「合作夥伴設定」)。我們新增至網址的查詢參數會遵循Google 大眾運輸票務擴充功能，並使用一組經過修改的參數：

欄位名稱 詳細資料
from_ticketing_stop_time_id

(可重複) 路段起點停靠站的 ID。

特定停靠時間的值是出發車站的 stop_id。
to_ticketing_stop_time_id

(可重複) 路段終點停靠站的 ID。

特定停靠時間的值是目的地車站的 stop_id 值。
service_date

(日期、可重複) 行程的服務日。

這個欄位會採用 JSON 陣列的格式，內含的日期格式字串如下：

YYYYMMDD
boarding_time

(ISO 8601，可重複) 路段起點 stop_time 的出發日期和時間 (departure_time)。

這個欄位的時間值符合 ISO 8601，且包含以下格式字串：

YYYY-MM-DDThh:mm:ss±hh:mm
arrival_time

(ISO 8601，可重複) 路段終點 stop_time 的抵達日期和時間 (arrival_time)。

這個欄位的時間值符合 ISO 8601，且包含以下格式字串：

YYYY-MM-DDThh:mm:ss±hh:mm
booking_token

(字串) 用於新增其他資料的選用欄位。這個值來自 Travel Transport API 回應，並附加至票務深層連結。

booking_token 長度上限為 100 個字元。

即使沒有預訂權杖，行程查詢功能仍可正常運作，但預訂權杖可用於確保 Google 搜尋結果和合作夥伴預訂頁面上的價格一致。
lang

(IETF BCP 47，選填) 用於指出預訂網站所選語言的欄位。

這個欄位的值符合 IETF BCP 47，例如 en-US。

如果所選語言不適用或未傳遞欄位，預訂網站應使用備用語言。
cur

(ISO 4217，選用) 這個欄位用於指出價格應顯示的幣別。

這個欄位的值符合 ISO 4217，例如 USD。

如果無法顯示所選貨幣或未傳遞該欄位，預訂網站應使用備用貨幣。
utm_source

(字串，選用) 用於指出傳送流量的頂層網站。

可能的值為 google_search 和 google_maps。

所有可重複的參數都會指定為 JSON 陣列，其中多個值表示轉移停靠點。如需網址編碼範例，請參閱 Google 大眾運輸票務擴充功能的範例。