航班追踪器

使用 AviationStack API 追踪全球任何航班，并以简洁的 Flighty 风格格式显示。

快速开始

通过 IATA 代码追踪航班：

scripts/track_flight.py AA100
scripts/track_flight.py UA2402
scripts/track_flight.py BA123

首次设置

在使用此功能前，您需要一个 API 密钥（一次性设置）：

1. 获取免费 API 密钥在https://aviationstack.com/signup/free（每月 100 次请求）
2. 设置环境变量：

   export AVIATIONSTACK_API_KEY='your-key-here'
   

3. 安装依赖项：

   pip3 install requests
   

有关详细设置说明，请参阅api-setup.md。

输出格式

该功能以简洁、易读的格式显示航班信息，包括：

• ✈️ 航空公司和航班号
• 🛩️ 飞机类型和注册号
• 🛫 出发机场、航站楼、登机口、时间
• 🛬 到达机场、航站楼、登机口、时间
• 📊 带视觉指示器的航班状态
• ⏱️ 延误计算（如适用）
• 🌐 实时位置、高度、速度（飞行中时）

状态指示器：

• 🟢 活动/飞行中/航路中
• ✅ 已降落/已抵达
• 🟡 已计划
• 🟠 延误
• 🔴 已取消

高级用法

获取原始JSON数据：

scripts/track_flight.py AA100 --json

查看帮助：

scripts/track_flight.py --help

工作流程

当用户要求追踪航班时：

1. 从请求中提取航班号
2. 使用该航班号运行追踪脚本
3. 向用户呈现格式化后的输出
4. 如需获取用于进一步处理的数据，请使用--json标志

航班号格式

接受IATA航班代码：

• AA100（美国航空）
• UA2402（美国联合航空）
• BA123（英国航空）
• DL456（达美航空）

脚本自动转换为大写并处理查询。

错误处理

脚本处理常见错误：

• 缺少API密钥 → 显示设置说明
• 航班未找到 → 建议核实信息
• API错误 → 显示错误信息
• 超出速率限制 → 提示已达上限

API限制

免费层级：每月100次请求。请跟踪使用情况以保持在限制内。如需大量使用，请考虑升级或使用替代API（参见 references/api-setup.md）。

注意事项

• 使用AviationStack免费层级（免费计划不提供HTTPS）
• 实时数据频繁更新
• 提供历史航班数据
• 覆盖全球（250多个国家，13,000多家航空公司）