用途:按 IATA 航班号实时追踪全球航班,展示航班状态、航站楼与登机口、起降时间、延误信息,以及飞行中的位置、高度与速度。
主要能力:输出航空公司与航班号、机型与注册号、出发与到达机场的航站楼/登机口/时间、带视觉指示的航班状态、延误计算、飞行中实时位置。状态指示包括活跃/飞行中、已降落/到达、计划、延误、取消。支持全球范围(250+ 国家、13,000+ 航空公司)。
使用方式:脚本位于 scripts/track_flight.py,按 IATA 代码调用,例如: scripts/track_flight.py AA100 scripts/track_flight.py UA2402 scripts/track_flight.py BA123 获取原始 JSON:scripts/track_flight.py AA100 --json 查看帮助:scripts/track_flight.py --help 脚本会自动将航班号转为大写并查询。
首次设置:需一次性获取 API 密钥,在 https://aviationstack.com/signup/free 免费注册(免费额度 100 次请求/月)。设置环境变量: export AVIATIONSTACK_API_KEY='your-key-here' 安装依赖: pip3 install requests 详细说明见 api-setup.md。
错误处理:缺少 API 密钥会显示设置指引;航班未找到会提示核对;API 错误会显示错误信息;超出速率限制会提示已达上限。
限制:免费层为 100 次请求/月,需自行控制用量,重度使用需升级或考虑替代 API(参见 references/api-setup.md)。免费计划不支持 HTTPS。
适用场景:用户询问追踪某航班、查询航班状态或查找航班信息时使用。若需要进一步处理数据,可使用 --json 输出。