地面交通 API
面向旅行社的交通 API：接送、铁路与渡轮，门到门全覆盖
飞机落地并不意味着行程结束。借助交通 API，您的网站可以销售机场接送、火车、巴士和渡轮，把旅客从到达大厅送到酒店门口。本页说明各类地面交通 API 需要什么信息、彼此有何差异，以及 PHPTRAVELS 如何把每一段作为一次行程来销售。
- 机场接送
- 铁路、巴士与渡轮
- 航班联动接送
- 一次行程，一次支付
门到门
六个环节，六种不同的 API 问题
跟随一位旅客，从落地到入住。每个环节都是不同的产品，对应不同的供应商，而每家供应商的 API 在报价之前要求的信息也各不相同。
01
航班落地
行程的起点。航班号、机场、航站楼和到达时间决定了后面每一段的安排。
02
机场接送
API 所需信息
上车机场或地址、下车地址、日期和时间、乘客人数、行李以及航班号。
03
火车
API 所需信息
出发站和到达站、日期、出发时间段、乘客年龄以及持有的铁路通票。
04
巴士
API 所需信息
出发和到达的城市或站点、出行日期、乘客人数，然后根据座位图选择上车点和座位。
05
渡轮
API 所需信息
出发港和到达港、航班日期、乘客类型，以及车辆的类型和长度或舱位。
06
酒店门口
酒店地址和入住日期为整条链路收尾，同时也是最后一段的下车点。
多数旅行社已经在销售机票和客房。中间这些环节，旅客往往会去别处预订，而一旦衔接失败，损失也最大。交通 API 可以补上这些缺口，让接送、火车、长途巴士和渡轮都由您来预订、收款并出具凭证。
目前没有一个涵盖所有交通方式的地面交通 API。接送供应商、铁路供应商、巴士运营商和渡轮运营商各自提供自己的接口。旅客眼中的一次行程，在后台其实是多家供应商，需要您的平台一起搜索、定价和确认。接送部分请参阅机场接送技术页面。
交通方式对比
接送、铁路、巴士与渡轮 API 对比
搜索条件、计价单位和旅客收到的凭证，会随交通方式而变化。以下是对接时需要注意的差异。
| 专车接送 | 拼车接送 | 铁路 | 巴士 | 渡轮 | |
|---|---|---|---|---|---|
| 搜索条件 | 上下车地点、日期、时间、乘客人数、行李 | 机场、目的地区域或酒店、日期、时间、乘客人数 | 车站、日期、时间段、乘客年龄、铁路通票 | 城市或站点、日期、乘客人数 | 港口、日期、乘客类型、车辆、舱位 |
| 计价对象 | 按路线或里程计价的整辆车，与人数无关 | 服务多家酒店的班车上的每个座位 | 按票价类型和席别计价的每个座位，分段计价或全程联程票价 | 每个座位，常按站点组合、座位类型或卧铺区分 | 每位乘客及舱等，车辆按类型和长度计价，或按舱位计价 |
| 车票或凭证 | 包含集合地点、司机联系方式和等候时间的凭证 | 包含班车接客时间段和站点的凭证 | 带二维码的电子票，每一段都有车厢和座位 | 含 PNR、座位和上车点的手机票 | 含航次、座位或舱位以及车辆信息的登船牌 |
| 变更 | 时间或地址变更通常可在接客前的截止时间前办理 | 截止时间相近，但接客时间的灵活度较低 | 由票价决定：特价、半灵活或灵活条件 | 按距发车的小时数划分退款档位，因运营商而异 | 由运营商的票价规则及航次的值机截止时间决定 |
| 常见问题 | 航班延误，以及司机在到达大厅找不到旅客 | 等待其他航班，以及多个下车点造成的行程变长 | 换乘时间太紧而赶不上，以及必须预订座位 | 上车点错误，或未锁定座位导致重复售出 | 天气导致取消，以及车辆长度登记错误 |
PHPTRAVELS 为每种交通方式提供独立模块：租车与接送用于接送，铁路用于国际行程与通票，火车用于国内铁路网，巴士用于长途巴士座位，轮渡用于航线。
航班联动接送
航班号是接送预订中最重要的字段
按计划落地时间预订的机场接送，一旦航班晚点就会落空。接送 API 要求提供航班号，正是为了让接客时间跟随实际到达时间。
航班号与到达时间
在预订时获取，或从同一次行程中售出的航班带入，旅客无需重复填写。
接客时间随落地调整
根据航班号获得的到达时间来确定接客时间，延误不会导致错过司机或产生等候费。
免费等候时间
等候时间从实际落地算起，而不是预订的时间。规则会印在凭证上，旅客一目了然。
接机服务
接机牌、集合地点和司机电话会写在凭证和司机的派单上。
接送与机票 API搭配销售效果最好：航班已在订单中，旅客看到时接送表单已经填好一半。
- 09:20接送已预订航班号和计划到达时间随接客一并保存。
- 12:40航班延误收到该航班号的新到达时间。
- 12:41接客时间调整按新时间派出司机，旅客无需任何操作。
- 15:18航班落地免费等候时间从实际落地开始计算。
- 15:34接机服务司机举着接机牌在到达大厅等候。
- 16:22送达酒店行程完成，后台中订单关闭。
时间仅为示意，已作简化
PHPTRAVELS 已就绪
按交通方式分组的地面交通供应商
以下接送、铁路和渡轮供应商已接入 PHPTRAVELS。您与各供应商签约，在后台填写自己的凭据即可上线。列表来自我们实时更新的集成目录。
每种交通方式也支持您自己的库存：您的车辆和固定线路价格、铁路包位、您的航线和巴士。请查看完整的旅游 XML API 供应商名录。
作为一次行程销售
后台是多家供应商，前台是一份订单
旅客不想收到来自五家公司的五份确认。预订平台把每一段合并为一份行程、一次结账和一套凭证，同时各供应商仍会收到各自的订单。
- 航班 · 抵达已确认
- 专车接送 · 机场至车站已确认
- 火车 · 二等座，已订座已确认
- 渡轮 · 甲板座位，一辆汽车已确认
- 酒店 · 三晚已确认
- 一次结账完成支付
- 凭证、车票和发票合并在一封邮件中
- 01
逐段搜索
机票、接送、火车、巴士和渡轮共用同一个网站和同一个结账流程。
- 02
检查衔接
渡轮必须在上一段到达之后出发，铁路换乘遵循每个车站设定的换乘时间。
- 03
一次收款
旅客通过您的支付网关一次付清；代理商从自己的B2B 代理钱包支付。
- 04
向各供应商下单
每一段都在各自的供应商处确认，并保留各自的订单号、条件以及凭证或车票。
- 05
作为一次行程管理
每一段的变更、取消和收入都在同一个后台中跟踪，并可对每一段设置您的加价。
正在开发自己的应用或合作伙伴渠道？在 Enterprise 套餐中，PHPTRAVELS REST API 和 webhook 以统一格式提供所有已接入供应商的订单。可在价格对比套餐，或阅读开发者文档。
交通 API 是地面交通供应商提供的一组网络服务，让旅游网站可以实时搜索、定价并预订接送、火车行程、巴士座位或渡轮航次，并获取给旅客的凭证或车票。
机场接送 API 会返回机场与地址、酒店或区域之间的专车和拼车选项，按车辆或按座位计价。预订后会生成一次接客，包含司机、集合地点和凭证。
没有。接送、铁路、巴士和渡轮通常由不同供应商销售，各有各的 API。预订平台会接入其中多个，并把各段作为一次行程呈现。
如果订单中包含航班号，接客时间可以跟随实际到达时间调整，免费等候时间也从实际落地开始计算。具体政策取决于接送供应商，请在凭证上注明。
专车接送按车辆计价，直接把一组旅客送到其地址。拼车接送按座位计价，同车搭载多组旅客，价格更低，但停靠点更多、耗时更长。
目前已接入 Mozio 和 KiwiTaxi 等接送供应商、铁路供应商 HKINT 以及渡轮供应商 Kikoto Ferries，其他供应商可在集成目录中查看。本页的列表是从该目录实时加载的。
不会。您需要与各供应商签约，并在后台填写自己的凭据。PHPTRAVELS 提供预订平台和现成的连接器。
可以。每个模块除了供应商 API，也支持您自己的库存：您的车辆和固定线路价格、巴士和座位布局、铁路包位以及渡轮航线。
可以。代理商在 B2B 门户中以自己的价格和佣金预订每一段，通过钱包或信用额度付款，并收到相同的凭证和车票。