飞驼可视国际铁路跟踪 API
覆盖北美、中欧和中亚铁路的实时跟踪、历史轨迹、班期查询与海铁异常预警。
飞驼可视国际铁路跟踪 API 支持北美 8 家主要铁路公司和中欧、中亚 16 个国家的铁路数据，覆盖集装箱从海港、国境换装到目的站的完整运行链路，为货代、制造业和物流 SaaS 提供统一的铁路数据接口。
应用场景与价值
中欧班列货代运营
掌握班列运行、国境换装和目的站节点，支撑客户交付承诺。
跨境铁路物流追踪
统一查询北美、中欧和中亚铁路全程轨迹与实时位置。
海铁联运衔接管理
衔接海港、铁路和末端配送，提前识别换装与滞留风险。
制造业供应链规划
结合铁路班期与运行时效安排排产、备货和海外仓计划。
物流平台 SaaS 集成
以标准接口将铁路节点嵌入 TMS、ERP 和客户门户。
异常预警与风控
接收延误、甩柜、滞留、拥堵和超期用箱等主动预警。
- 多区域覆盖： 北美 8 家铁路公司，中欧中亚 16 个国家。
- 实时 + 历史： 既可获取当前铁路位置，也可回溯时间范围内的历史轨迹。
- 班期查询： 支持城市中文名或铁路编码查询中欧中亚铁路班期。
- 全链路预警： 覆盖起运港、中转港、目的港和交货地异常节点。
业务覆盖范围
北美铁路覆盖
| 铁路公司 | 中文名称 | 覆盖区域 |
|---|---|---|
| UP | 美国联合太平洋 | 美国 |
| BNSF | 伯灵顿北方圣太菲 | 美国 |
| NS | 诺福克南方 | 美国 |
| KCS | 堪萨斯南方 | 美国/墨西哥 |
| CSX | CSX 铁路 | 美国 |
| CN | 加拿大国家铁路 | 加拿大 |
| CP | 加拿大太平洋铁路 | 加拿大 |
| Ferromex | 墨西哥铁路 | 墨西哥 |
中欧 + 中亚铁路覆盖
| 国家/地区 | 国家/地区 | 国家/地区 |
|---|---|---|
| 俄罗斯 | 白俄罗斯 | 蒙古 |
| 哈萨克斯坦 | 乌兹别克斯坦 | 吉尔吉斯斯坦 |
| 塔吉克斯坦 | 土库曼斯坦 | 乌克兰 |
| 摩尔多瓦 | 阿塞拜疆 | 格鲁吉亚 |
| 拉脱维亚 | 立陶宛 | 爱沙尼亚 |
| 芬兰 | 中国 | 其他线路持续扩展 |
数据时效说明
| 服务 | 反馈时效 | 说明 |
|---|---|---|
| 北美实时跟踪 | 实时/准实时 | 以铁路公司官方授权数据为准 |
| 北美历史跟踪 | 按查询时间范围 | 用于审计与轨迹回溯 |
| 中欧中亚铁路 | 约 10 分钟 | 每天持续反馈 2-30 条信息 |
| 铁路班期 | 计划数据 | 支持城市中文名或铁路编码 |
海铁节点状态码
运单总状态
| statusCategory | statusDescription | 业务状态说明 |
|---|---|---|
| START | Shipment loading | 订阅中 |
| PROCESS | Shipment updating | 跟踪进行中 |
| COMPLETE | Shipment completed | 跟踪已结束 |
| COMPLETE | Booking cancelled | 订舱取消 |
| NODATA | Official no results | 船司无数据 |
| ABNORMAL | Shipment no results for 30days | 30 天无结果 |
订舱状态节点
| 状态名称 | 状态描述 |
|---|---|
| Booking | 订舱中 |
| Confirmed | 订舱确认 |
| Cancelled | 订舱取消 |
运输节点
| 地点类型 | 抵达/离开 | 节点说明 |
|---|---|---|
| 1 | ETD / ATD | 起始地预计/实际离开 |
| 2 | ETD / ATD | 起运港预计/实际离开 |
| 3 | ETA/ATA/ETD/ATD | 中转港抵达与离开 |
| 4 | ETA/ATA/ETD/ATD | 目的港抵达与离开 |
| 5 | ETA / ATA | 目的地预计/实际抵达 |
集装箱动态节点
| 状态码 | 中文说明 | 英文说明 | 发生地 |
|---|---|---|---|
| STSP | 提空箱 | Pick-up Empty | 起始地 |
| STUF | 装箱 | Container Stuffing | 起始地 |
| GITM | 进场 | Received | 起始地 |
| LOBD | 装船 | Loaded | 起运港 |
| DLPT | 离港 | Vessel Departed | 起运港 |
| TSBA | 中转抵港 | T/S Vessel Arrived | 中转港 |
| TSDP | 中转离港 | T/S Vessel Departed | 中转港 |
| BDAR | 抵港 | Vessel Arrived | 目的港 |
| DSCH | 卸船 | Vessel Discharged | 目的港 |
| PCAB | 可提货 | Available | 目的地 |
| STCS | 提柜（货） | Gate Out for Delivery | 目的地 |
| RCVE | 还空箱 | Empty Returned | 目的地 |
异常预警节点（推送接口）
| eventCode | eventCategory | 说明 |
|---|---|---|
| WGITM | DELAY | 起运港进港延误 |
| WDLPT | DELAY | 起运港离港延误 |
| WDUMP | DUMPING | 起运港甩柜 |
| WTSBA | DETENTION | 中转滞留 |
| WPCGI | DETENTION | 目的港码头拥堵 |
| WBDAR | DELAY | 目的港抵达延误 |
| WGTOT | DETENTION | 目的港滞留 |
| WETA | DELAY | 交货地抵达延误 |
| WSTCS | OVERDUE | 滞港超期 |
| WRCVE | OVERDUE | 用箱超期 |
北美铁运实时跟踪（查询）
通过箱号查询集装箱当前铁运位置，返回全程跟踪信息、运单信息与实时事件。
tripTraces
运输周期与全程跟踪事件列表
waybill
运单号、提单号、货重/皮重和起讫点
events
铁路实时事件、报告铁路和发生地点
roadEta
铁路预计抵达时间
Query 参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| businessNumber | string | 是 | 箱号 | OOCU8948913 |
curl --location 'http://openapi.freightower.com/rail/us/current/trip?businessNumber=OOCU8948913' \ --header 'Authorization: Bearer <token>'
北美铁运历史跟踪（查询）
通过箱号和时间范围查询铁运途径地点与历史轨迹，用于事后审计、路径核查与轨迹回溯。
返回结构与实时跟踪接口基本一致，data 为数组，包含多个时间周期的 tripTraces 历史记录。
Query 参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| businessNumber | string | 是 | 箱号 | OOCU8948913 |
| start | string | 是 | 开始时间，yyyy-MM-dd HH:mm:ss | 2023-04-20 09:00:00 |
| end | string | 是 | 结束时间，yyyy-MM-dd HH:mm:ss | 2023-05-23 12:11:00 |
curl --location 'http://openapi.freightower.com/rail/us/history/trip?businessNumber=OOCU8948913&start=2023-04-20%2009%3A00%3A00&end=2023-05-23%2012%3A11%3A00' \ --header 'Authorization: Bearer <token>'
中欧 + 中亚铁路跟踪（查询）
支持 16 个国家的铁路跟踪，返回车号/箱号、当前站、事件、坐标、距离目的站距离等字段。
currentStationName
当前站名称与站编
operation
当前发生事件
operatingTime
事件发生时间
distanceEnd
距离目的站距离（km）
arrive
是否抵达目的站：N/Y
Query 参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| containerNo | string | 是 | 集装箱号 | HNKU6236308 |
| start | string | 是 | 查询开始时间 | 2024-09-29 |
| end | string | 是 | 查询结束时间 | 2024-10-07 |
curl --location 'http://openapi.freightower.com/rail/eu/tracks?containerNo=HNKU6236308&start=2024-09-29&end=2024-10-07' \ --header 'Authorization: Bearer <token>'
中欧 + 中亚铁路班期查询
根据出发城市与抵达城市查询班期信息，支持城市中文名或铁路编码。
routeEtd
计划班期，MON-SUN 或 TBD
exitPort
出境口岸
distance
距离（km）
transitTime
计划航程（天）
Body 参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| startStation | string | 否 | 出发城市中文名或铁路编码 | 上海 |
| endStation | string | 否 | 抵达城市中文名或铁路编码 | 明斯克 |
curl --location 'http://openapi.freightower.com/rail/eu/schedule' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"startStation": "上海",
"endStation": "明斯克"
}'FAQ
常见问题
北美铁路跟踪覆盖哪些铁路公司？
覆盖 UP、BNSF、NS、KCS、CSX、CN、CP 和 Ferromex 8 家铁路公司，覆盖美国、加拿大和墨西哥。
中欧中亚铁路跟踪覆盖哪些国家？
覆盖俄罗斯、白俄罗斯、蒙古、哈萨克斯坦等 16 个国家，并持续扩展。
中欧中亚铁路跟踪的数据反馈频率如何？
反馈时间约 10 分钟，运踪结果一般每天持续反馈 2-30 条信息，跟踪周期覆盖出境换装至目的站。
如何查询北美铁路集装箱实时位置？
调用 GET /rail/us/current/trip，传入 businessNumber 箱号即可查询。北美铁运接口需官方授权，请联系商务开通。
北美铁运实时与历史跟踪接口有什么区别？
实时接口查询当前铁运位置，历史接口额外传入 start/end 时间范围，用于审计与路径核查。
中欧中亚铁路跟踪支持哪些查询参数？
支持 containerNo 配合 start、end 查询，返回当前站、事件、坐标、距离和是否抵达等字段。
中欧中亚铁路班期查询如何输入城市？
支持城市中文名或铁路编码，返回计划班期、出境口岸、距离与计划航程。
海铁联运有哪些异常预警节点？
包括起运港延误、甩柜、中转滞留、目的港拥堵、交货地延误、滞港超期和用箱超期等 10 类预警。
从蒙古、乌兹别克斯坦、土库曼斯坦始发的货物如何查询？
需使用换装后的车皮号进行查询，建议在业务系统中做好车皮号映射管理。
