TfL London Transit_知识管理 skill-PHP中文网

首页专区 Skill 文章专题 AI工具学习编程手册

立刻MV 低成本歌曲 MV、视频生成 Laper 剧本策划到成片协作 AniShort AI短剧协同制作平台 updream 一键生成高质量推广成片

PHP MySQL jquery HTML CSS

TfL London Transit

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

伦敦TfL交通——实时地铁到站、公交预测、线路状态、服务中断、行程规划及伦敦地铁路线信息等

TfL London Transit.

功能概述

TfL London Transit.是一项面向实际任务的技能，主要用于Real-time London TfL transit data - 接驳到达,公交车预测,线路状况,中断,行程规划,以及线路信息.；TfL使用统一 REST API 的单机.。

核心要点

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；

结果检查与注意事项

涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

TfL 伦敦公共交通

实时伦敦 TfL 公共交通数据 — 地铁（Tube）到站信息、巴士预计到达时间、线路运行状态、服务中断通知、行程规划及路线详情。所有交通方式均通过 TfL 的**统一 REST API** 提供支持。API 密钥为可选项（免费注册，推荐使用以获取更高请求配额）。

适用场景

用户询问有关地铁（Tube）、伦敦地铁（London Underground）、TfL 或伦敦公共交通的问题
用户提及具体地铁线路（Bakerloo、Central、Circle、District、Hammersmith & City、Jubilee、Metropolitan、Northern、Piccadilly、Victoria、Waterloo & City）
用户提问“Northern 线是否正常运行”或“下一班地铁什么时候到”
用户提及伦敦车站（如 King's Cross、Oxford Circus、Waterloo、Victoria、Paddington 等）
用户询问伦敦巴士、DLR、Overground、Elizabeth line 或有轨电车（trams）相关信息
用户询问 TfL 服务状态、延误、中断或计划性停运情况
用户询问 Oyster 卡、非接触式支付（contactless）或 TfL 票价
用户询问伦敦地区的行程规划

数据来源

TfL 提供一个统一的 REST API（api.tfl.gov.uk），以 JSON 格式返回所有交通方式的数据 — 包括地铁（Tube）、巴士、DLR、Overground、Elizabeth line、有轨电车（trams）、泰晤士河渡轮（river bus）和缆车（cable car）。不使用 Protocol Buffers、SIRI 或多种数据格式；仅提供一个简洁、一致的 REST API，响应均为结构化 JSON。

API 密钥：请在 https://api-portal.tfl.gov.uk/ 免费注册获取 app_key；请求时需在 URL 后附加 ?app_key={KEY}。未提供密钥时 API 仍可使用（基础功能），但受速率限制；启用密钥后配额提升至每分钟 500 次请求。

核心端点

端点	说明
`/Line/Mode/tube/Status`	所有地铁线路当前状态
`/Line/{lineId}/Status`	指定线路当前状态
`/StopPoint/{naptanId}/Arrivals`	某站点的到站信息
`/Line/{lineId}/Arrivals/{stopPointId}`	按线路筛选的到站信息
`/StopPoint/Search/{query}`	按名称搜索站点
`/StopPoint?lat=&lon=&radius=`	按地理位置（经纬度 + 半径）搜索附近站点
`/Line/{lineId}/StopPoints`	某条线路上的所有站点
`/Line/{lineId}/Route/Sequence/{dir}`	线路行驶路径中的站点顺序
`/Line/{lineId}/Disruption`	某条线路的服务中断信息
`/Journey/JourneyResults/{from}/to/{to}`	行程规划
`/Line/Mode/bus`	所有巴士线路

所有端点均返回 JSON 数据。认证请求需附加 ?app_key={KEY} 参数。

实现说明

快速开始：使用辅助脚本

本技能 scripts/ 目录下的脚本负责 TfL 数据的获取、解析与呈现。

脚本：`scripts/tfl.mjs`

主入口脚本，支持以下命令：

# 地铁线路状态
node scripts/tfl.mjs status
node scripts/tfl.mjs status --all
node scripts/tfl.mjs status --line victoria

# 车站到站信息
node scripts/tfl.mjs arrivals --station "Oxford Circus"
node scripts/tfl.mjs arrivals --stop 940GZZLUOXC
node scripts/tfl.mjs arrivals --stop-search "kings cross"
node scripts/tfl.mjs arrivals --stop-search "kings cross" --line piccadilly

# 巴士到站信息
node scripts/tfl.mjs bus-arrivals --stop 490005183E
node scripts/tfl.mjs bus-arrivals --stop-search "oxford circus"
node scripts/tfl.mjs bus-arrivals --stop-search "oxford circus" --route 24

# 服务中断信息
node scripts/tfl.mjs disruptions
node scripts/tfl.mjs disruptions --line northern

# 线路与站点信息
node scripts/tfl.mjs routes
node scripts/tfl.mjs routes --all
node scripts/tfl.mjs bus-routes
node scripts/tfl.mjs stops --search "waterloo"
node scripts/tfl.mjs stops --near 51.5074,-0.1278 --radius 500
node scripts/tfl.mjs stops --line victoria
node scripts/tfl.mjs route-info --line bakerloo
node scripts/tfl.mjs route-info --route 24

# 行程规划
node scripts/tfl.mjs journey --from "waterloo" --to "kings cross"
node scripts/tfl.mjs journey --from "51.5031,-0.1132" --to "51.5308,-0.1238"

配置：API 密钥（可选，推荐）

基础功能无需密钥（但受速率限制）。如需每分钟 500 次请求配额，请执行以下步骤：

访问 https://api-portal.tfl.gov.uk/ 注册账号
设置环境变量：TFL_API_KEY

地铁线路参考表

线路 ID	线路名称	颜色标识	起讫站
bakerloo	Bakerloo	brown	Harrow & Wealdstone <-> Elephant & Castle
central	Central	red	Epping / Ealing Broadway <-> West Ruislip
circle	Circle	yellow	Hammersmith（经 Liverpool Street 环线）
district	District	green	Richmond / Ealing Broadway <-> Upminster
hammersmith-city	Hammersmith & City	pink	Hammersmith <-> Barking
jubilee	Jubilee	silver	Stanmore <-> Stratford
metropolitan	Metropolitan	magenta	Chesham / Amersham / Uxbridge <-> Aldgate
northern	Northern	black	Edgware / High Barnet <-> Morden / Battersea
piccadilly	Piccadilly	dark blue	Heathrow T5 / Uxbridge <-> Cockfosters
victoria	Victoria	light blue	Walthamstow Central <-> Brixton
waterloo-city	Waterloo & City	teal	Waterloo <-> Bank

其他 TfL 铁路交通方式

线路 ID	名称	类型
dlr	DLR	Docklands Light Railway
liberty	Liberty	Overground（Romford — Upminster）
lioness	Lioness	Overground（Watford — Euston）
mildmay	Mildmay	Overground（Stratford — Richmond/Clapham）
suffragette	Suffragette	Overground（Gospel Oak — Barking）
weaver	Weaver	Overground（Liverpool St — Enfield/Cheshunt/Chingford）
windrush	Windrush	Overground（Highbury — Crystal Palace/Clapham/W Croydon）
elizabeth	Elizabeth line	Crossrail
tram	London Trams	Croydon Tramlink

TfL 票价参考（自 2025 年 3 月起）

票种	价格
地铁 Zone 1（Oyster/contactless，高峰时段）	£2.80
地铁 Zone 1（Oyster/contactless，非高峰时段）	£2.70
地铁 Zones 1–2（高峰时段）	£2.80
地铁 Zones 1–2（非高峰时段）	£2.70
地铁 Zones 1–3（高峰时段）	£3.50
地铁 Zones 1–3（非高峰时段）	£2.80
巴士与有轨电车（任意行程）	£1.75
Hopper 票（1 小时内不限次乘坐巴士/有轨电车）	£1.75 总计
Zones 1–2 日封顶票价	£8.90
Zones 1–2 周封顶票价	£44.70
现金单程票（售票机购买）	£6.70（Zone 1）

高峰时段定义：周一至周五 6:30–9:30 和 16:00–19:00（公共假期除外）。

用户使用提示

NaPTAN ID 是站点唯一标识符 — 地铁站采用 940GZZLU{code} 格式
使用 --station 或 --stop-search 按名称查询；使用 --stop 输入精确的 NaPTAN ID
时间统一采用 24 小时制（符合伦敦惯例）
arrivals 命令基于 TfL API 返回的 timeToStation 字段（单位：秒）计算预计到达时间（ETA）
巴士站点拥有独立的 NaPTAN ID，格式为 490{code}
行程规划结果中若可用，将包含预估票价

错误处理机制

若未设置 TFL_API_KEY，请求仍可执行，但受限于速率限制，并会输出提示信息
收到 HTTP 429（速率超限）响应时，将显示含注册链接的友好提示
无效的站点/停靠点搜索将返回“未找到匹配站点”，并附带建议关键词
网络错误或 API 错误响应均转换为用户友好的提示信息
若站点关闭或无服务，将显示相应说明

响应格式规范

向用户呈现公共交通信息时，请遵循以下规则：

优先展示最实用的信息（如下一班到站时间、线路运行状态）
线路名称前添加对应颜色标识（例如：“🔴 Central：服务正常”）
时间统一采用 24 小时制（符合伦敦惯例）
到站信息中显示线路 + 终点站 + 分钟数（由 timeToStation / 60 计算得出）
若平台信息可用，则一并显示
行程规划结果需分步骤呈现，注明交通方式、线路、耗时及票价
对用户查询的线路，必须同步说明当前是否存在服务中断

外部端点

端点	发送数据	接收数据
`api.tfl.gov.uk/Line/*/Status`	API 密钥（作为查询参数，可选）	线路状态（JSON）
`api.tfl.gov.uk/StopPoint/*/Arrivals`	API 密钥（作为查询参数，可选）	到站信息（JSON）
`api.tfl.gov.uk/StopPoint/Search/*`	API 密钥（作为查询参数，可选）	站点搜索结果（JSON）
`api.tfl.gov.uk/StopPoint?lat=&lon=`	API 密钥（作为查询参数，可选）	附近站点（JSON）
`api.tfl.gov.uk/Line/*/StopPoints`	API 密钥（作为查询参数，可选）	线路站点列表（JSON）
`api.tfl.gov.uk/Line//Route/Sequence/`	API 密钥（作为查询参数，可选）	线路路径序列（JSON）
`api.tfl.gov.uk/Line/*/Disruption`	API 密钥（作为查询参数，可选）	中断信息（JSON）
`api.tfl.gov.uk/Journey/JourneyResults/*`	API 密钥（作为查询参数，可选）	行程规划结果（JSON）
`api.tfl.gov.uk/Line/Mode/bus`	API 密钥（作为查询参数，可选）	巴士线路列表（JSON）