本术语表定义了运输合作伙伴集成文档中使用的关键术语。
预订令牌:一个可选的、由合作伙伴生成的字符串,可传递到出票深层链接中,以帮助保持 Google 搜索结果与合作伙伴预订页面之间的价格和行程一致性。
规范 JSON 映射:Protocol Buffers 定义的一组用于将 proto 消息转换为 JSON 对象的特定规则。此集成需要将此映射与特定选项搭配使用,以便正确设置请求和响应的格式。
GTFS(通用公交 Feed 规范):一种标准数据格式,公共交通机构使用该格式向乘客提供时刻表、路线和票价信息。在此集成中,这是向 Google 提供静态数据的两种方式之一。
基于 GTFS 的集成:一种集成方法,适用于以 GTFS Feed 形式向 Google 提供自有时刻表数据的合作伙伴。如果 Google 尚未掌握运营商的赛程,则会使用此文件。
known_itineraries
:合作伙伴配置中的一个选项,可让合作伙伴从 Google 接收已知行程列表,以优化其响应。
市场集:(仅限停止型集成)合作伙伴提供的一项可选 Feed,用于定义他们将提供价格的特定出发地-目的地对(市场)列表。如果提供,则充当许可名单。
Partner API / Partner Server API:合作伙伴必须实现的一组 API,用于向 Google 提供动态数据,例如实时价格和供应情况。
价格质量测试:Google 的抓取工具会持续对合作伙伴网站上的行程进行抽样,以验证向用户显示的价格是否与通过 Partner API 提供的价格一致。
QPS(每秒查询次数):Google 向合作伙伴 API 服务器发送请求(一次查询即一次请求)的平均速率。此比率可能会波动,有时流量会略高,有时会略低。
SegmentKey:在 Partner API 中使用的一个对象,用于唯一标识行程的单个路段,包括出发地、目的地和服务日期/时间。
service_date
:公交服务运营的具体日期,格式为 YYYYMMDD
。它与其他标识符结合使用,用于指定唯一的行程实例。
仅停止集成:一种适用于非节目数据源的合作伙伴的集成方法。当 Google 已从其他来源收到运营商的时刻表时,会使用此值。合作伙伴只需提供其停靠站 ID 的列表。
ticketing_stop_id
:合作伙伴为某个停靠站或车站提供的唯一标识符。
此 ID 在静态数据 Feed(GTFS 或仅包含站点的 Feed)中提供,并用于合作伙伴 API 和票务深层链接。
ticketing_trip_id
:(对于基于 GTFS 的集成)合作伙伴在 GTFS Feed 的 trips.txt
文件中提供的特定行程的唯一标识符。仅限基于 GTFS 的集成。
机票深层链接:一种网址,可将用户从 Google 的搜索结果引导至合作伙伴的网站,以便预订特定行程。该网址包含有关所选行程的编码详细信息。
TripOptionsErrorType
:可在合作伙伴 API 中返回的一组特定错误类型,用于提供有关请求失败原因的更详细信息。
UNSPECIFIED
枚举值:使用 Protocol Buffers 时,任何枚举定义中必需的第一个值(数值为 0)。它用作默认值,如果在请求中收到此值,通常应将其视为错误。