搜索链接格式

对于搜索链接,合作伙伴将提供特定于搜索的基本网址(请参阅合作伙伴配置)。我们支持以下查询参数:

字段名称 详细信息
from_stop_id

(可重复)行程可能开始的停靠站的标识符。

出发站的 stop_id 值。

to_stop_id

(可重复)行程可能结束的站点的标识符。

目的地站的 stop_id 的值。

search_date

(日期)旅程的服务日期。

此字段包含采用以下格式字符串的日期:

YYYYMMDD

lang

(IETF BCP 47,可选)用于指示预订网站所选语言的字段。

此字段的值符合 IETF BCP 47,例如 en-US

如果所选语言不可用或未传递相应字段,预订网站应使用后备语言。

cur

(ISO 4217,可选)用于指明价格应以何种币种显示。

相应字段的值符合 ISO 4217 标准,例如 USD

如果无法显示所选币种或未传递相应字段,预订网站应使用后备币种。

utm_source

(字符串,可选)用于指示发送流量的高级网站的字段。

可能的值有 google_searchgoogle_maps

所有可重复的参数均指定为 JSON 数组。对于 from_stop_idto_stop_id,多个值表示出发地和目的地位置的多个车站。

示例

在此示例中,用户查询从 locality1locality2 的火车:

  • locality1 映射到具有 stop_id f1f2 的电台。
  • locality2 映射到具有 stop_id t1t2 的电台。
  • 服务日期为 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

在着陆页中,用户将能够查看从 f1f2 站出发、于 20190716 抵达 t1t2 站的行程。支持所有电台组合:

  • f1t1
  • f1t2
  • f2t1
  • f2t2