搜尋連結格式

如果是搜尋連結，合作夥伴會提供搜尋專用的基本網址 (請參閱「合作夥伴設定」)。我們支援下列查詢參數：

欄位名稱 詳細資料
from_stop_id

(可重複) 行程可能起點的停靠站 ID。

出發車站的 stop_id 值。
to_stop_id

(可重複) 行程可能終點的停靠站 ID。

目的地車站的 stop_id 值。
search_date

(日期) 行程的服務日。

這個欄位包含日期，格式字串如下：

YYYYMMDD
lang

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

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

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

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

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

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

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

可能的值為 google_search 和 google_maps。

所有可重複的參數都會指定為 JSON 陣列。對於 from_stop_id 和 to_stop_id，多個值代表出發地和目的地地區的多個車站。

範例

在這個範例中，使用者查詢從 locality1 到 locality2 的火車：

  • locality1對應至有 stop_id 的電台 f1 和 f2。
  • locality2對應至有 stop_id 的電台 t1 和 t2。
  • 服務日期為 20190716。

在本例中，基準網址為 https://example.com。

根據所有上述資訊，將下列值用於參數：

欄位名稱 詳細資料
from_stop_id ["f1", "f2"]
to_stop_id ["t1", "t2"]
service_date 20190716

以下是編碼後的最終 URI：

https://example.com?from_stop_id=%5B%22f1%22,%22f2%22%5D&to_stop_id=%5B%22t1%22,%22t2%22%5D&search_date=20190716

在到達網頁中，使用者可以查看從 f1 和 f2 車站出發，並於 20190716 抵達 t1 和 t2 的行程。系統支援所有電台組合：

  • 從 f1 到 t1
  • 從 f1 到 t2
  • 從 f2 到 t1
  • 從 f2 到 t2