搜索链接格式

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

字段名称 详细信息
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_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