仅停止集成

概览

如果您不是 Google 地图的 GTFS Feed 提供方,则您的集成是仅限经停点。为了完成此集成,我们需要了解您如何识别不同的火车或公交车站。

常规 Feed 规范

开始集成时,我们会为每个集成创建一个唯一标识符,例如:ch_google_test(国家/地区代码、合作伙伴名称、集成)或 eu_google(地区代码、合作伙伴名称)。

合作伙伴可以提供一个 ZIP 文件,其中包含 CSV 格式的文本文件,这些文件要么全局应用,要么按集成应用:

示例 1

  • ch_google_test_stops.txt
  • ch_google_test_markets.txt

示例 2

  • stops.txt(应用于所有集成)
  • eu_google_integration1_markets.txt
  • eu_google_integration2_markets.txt

停止 Feed 规范(必填)

经停点文件应包含以下列:

字段名称 类型(请参阅 GTFS 说明
stop_id ID(必需) 用于标识经停点或车站的唯一标识符。较大的充电站应仅包含一个条目。在调用合作伙伴服务器 API 时以及在票务深层链接中使用此 ID。
stop_name 文字(必需) 用于调试经停点映射、缓存填充和价格准确性数据的可读取名称。
stop_lat 纬度(必填) 相应经停点的纬度。
stop_lon 经度(必需) 相应经停点的经度。

我们将采用自动提取流程,合作伙伴可以在其中包含的信息发生变化时持续提供更新后的 ZIP 文件。例如,合作伙伴可以通过扩展经停点列表来扩展所提供的广告资源。不过,与 GTFS 类似,stop_ids 应保持稳定。

市场集 Feed 规范(可选)

有了映射的停靠点,我们便可为此集成生成市场集(包含热门始发地 / 目的地对的列表)。然后,您可以通过提供市场集 Feed 来缩减这组市场。

市场集群可用作许可名单:如果未提供市场集群,集成中将启用所有市场。如果提供了市场集,则会停用列表中未包含的所有市场。

市场集文件应包含以下列:

字段名称 类型(请参阅 GTFS 说明
origin_stop_id ID(必需) 市场的来源 stop_id
destination_stop_id ID(必需) 市场的目标 stop_id

合作伙伴配置

使用仅限停止的集成时,我们需要静态合作伙伴配置的额外信息,如合作伙伴配置部分中所述。

深层链接的格式和参数在票务链接中定义

Partner API 参数

合作伙伴 API (GetBulkTripOptionsRequest) 的 SegmentKeys 参数基于深层链接规范。我们使用仅包含 from_ticketing_stop_time_idto_ticketing_stop_time_idservice_dateboarding_timearrival_timeSegmentKeys,并将 ticketing_trip_id 留空。我们将通过指定多个 SegmentKey(每个路段一个)来完整指定路线,包括所有转接。