对于搜索链接,合作伙伴将提供特定于搜索的基本网址(请参阅合作伙伴配置)。我们支持以下查询参数:
| 字段名称 | 详细信息 |
|---|---|
from_stop_id |
(可重复)行程可能开始的停靠站的标识符。 出发站的 |
to_stop_id |
(可重复)行程可能结束的站点的标识符。 目的地站的 |
search_date |
(日期)旅程的服务日期。 此字段包含采用以下格式字符串的日期:
|
lang |
(IETF BCP 47,可选)用于指示预订网站所选语言的字段。 此字段的值符合 IETF BCP 47,例如 如果所选语言不可用或未传递相应字段,预订网站应使用后备语言。 |
cur |
(ISO 4217,可选)用于指明价格应以何种币种显示。 相应字段的值符合 ISO 4217 标准,例如 如果无法显示所选币种或未传递相应字段,预订网站应使用后备币种。 |
utm_source |
(字符串,可选)用于指示发送流量的高级网站的字段。 可能的值有 |
所有可重复的参数均指定为 JSON 数组。对于 from_stop_id 和 to_stop_id,多个值表示出发地和目的地位置的多个车站。
示例
在此示例中,用户查询从 locality1 到 locality2 的火车:
locality1映射到具有stop_idf1和f2的电台。locality2映射到具有stop_idt1和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