概览
如果您不是 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_id
、to_ticketing_stop_time_id
、service_date
、boarding_time
和 arrival_time
的 SegmentKeys,并将 ticketing_trip_id
留空。我们将通过指定多个 SegmentKey(每个路段一个)来完整指定路线,包括所有转接。