用途
Flight Tracker 用于实时追踪全球航班,适合需要查询航班状态、登机口信息、延误情况以及飞行中实时位置的场景。当用户提出追踪航班、检查航班状态或查询航班信息时,可使用该技能。
主要能力
- 通过 IATA 航班号追踪任意航班,例如 AA100、UA2402、BA123、DL456。
- 输出航空公司与航班号、机型与注册号、出发机场(航站楼、登机口、时间)、到达机场(航站楼、登机口、时间)。
- 显示航班状态,并使用视觉指示符区分:🟢 活跃/飞行中/在途、✅ 已降落/已到达、🟡 已计划、🟠 延误、🔴 取消。
- 计算延误时间(如适用)。
- 飞行中显示实时位置、高度和速度。
- 支持通过
--json参数获取原始 JSON 数据,便于进一步处理。
使用方式
快速开始:使用 IATA 代码追踪航班。
scripts/track_flight.py AA100
scripts/track_flight.py UA2402
scripts/track_flight.py BA123
首次设置(一次性):
- 在 https://aviationstack.com/signup/free 获取免费 API 密钥(每月 100 次请求)。
- 设置环境变量:
export AVIATIONSTACK_API_KEY='your-key-here'
- 安装依赖:
pip3 install requests
详细设置说明见 api-setup.md。
高级用法:
获取原始 JSON 数据:
scripts/track_flight.py AA100 --json
查看帮助:
scripts/track_flight.py --help
工作流程:当用户要求追踪航班时,从请求中提取航班号,使用航班号运行追踪脚本,将格式化输出呈现给用户;如需进一步处理数据,使用 --json 参数。
航班号格式:接受 IATA 航班代码,脚本会自动转换为大写并处理查询。
适用场景
- 查询特定航班的实时状态、登机口和延误信息。
- 需要以清晰可读的格式展示航班详情。
- 需要原始 JSON 数据用于后续处理或集成。
- 覆盖全球 250 多个国家和 13,000 多家航空公司,并提供历史航班数据。
限制
- 依赖 AviationStack API,免费版每月 100 次请求,需注意用量;重度使用可考虑升级或替代 API(见 references/api-setup.md)。
- 免费版不支持 HTTPS。
- 需要一次性配置 API 密钥并安装 requests 依赖。
- 脚本处理常见错误:缺少 API 密钥时显示设置说明;航班未找到时建议核实;API 错误时显示错误消息;超出速率限制时提示已达上限。