什么是air-train-ev
air-train-ev 是一个集成多模态出行信息的 Python 工具包，专为需要同时处理航班、火车和电动汽车充电站数据的开发者设计。它通过调用 Amadeus 的航班 API、Navitia 的交通网络接口以及 Open Charge Map 的充电桩数据库，提供一站式的出行规划支持。该工具包强调环境变量配置，避免密钥硬编码，确保安全性与灵活性。用户可通过简单的命令行参数快速获取实时票价、列车时刻表及附近充电点信息，适用于构建智能旅行应用或自动化行程管理工具。
核心优势在于其模块化结构，每个服务（航班、火车、EV）均有独立脚本，便于单独使用或组合调用。例如，可先查询从苏黎世到伊斯坦布尔的非直飞经济舱航班，再结合 Navitia 获取斯特拉斯堡至雷恩的高铁班次，最后用 Open Charge Map 查找出发地附近的充电桩分布。所有输出均经过标准化格式化，包括日期时间统一为 DD/MM/YY HH:MM 格式，价格以欧元符号标注，提升数据可读性。
此外，工具支持自定义参数如最大返回结果数、出发时间、覆盖区域等，满足不同场景下的精细化需求。虽然默认使用沙盒环境进行测试，但生产部署时可切换至正式 API 端点。整体设计注重轻量化与易用性，无需复杂依赖即可集成到现有项目中，特别适合需要跨交通方式协同调度的应用场景。
核心功能特点
- 集成 Amadeus 航班 API，支持查询全球航班价格与舱位信息
- 接入 Navitia 公共运输系统，提供欧洲境内火车及公共交通路线规划
- 对接 Open Charge Map 数据库，实时检索附近电动汽车充电站详情
- 使用环境变量管理敏感凭证，保障 API 密钥安全且便于部署
- 命令行交互友好，支持灵活参数设置如出发地、目的地、时间范围等
- 输出数据统一格式化，包含标准化时间、货币符号及地理坐标
适用场景
air-train-ev 特别适合需要整合多种交通方式的实际出行场景。例如，一位计划自驾电动车穿越欧洲的旅行者，可在出发前先用该工具查询沿途高铁换乘节点（如从法国斯特拉斯堡前往雷恩），同时标记途经城市周边的充电桩位置，确保长途驾驶无续航焦虑。这种跨模态协同规划能力使其成为电动出行者的实用助手。
对于旅游平台或企业差旅管理系统而言，该工具能显著提升行程自动化程度。开发团队可通过调用航班脚本批量获取多个航司的经济舱报价，结合火车时刻表筛选最优衔接方案，并自动附加充电站信息供司机参考，从而减少人工干预，提高调度效率。
此外，在智慧城市或共享出行项目中，air-train-ev 可用于构建动态交通信息服务。比如，当用户输入起点和终点后，系统不仅返回航班与列车选项，还能叠加周边充电设施密度图，帮助决策是否选择电动车接驳段，实现绿色出行优化。其轻量级特性也适合嵌入移动端应用后台，满足即时查询需求。