核心功能与用法
idfm-journey 是一个面向巴黎大区（Île-de-France）公共交通的 Python 脚本封装工具，底层对接 Île-de-France Mobilités (IDFM) 的 PRIM/Navitia 平台。它提供三大核心能力：
1. 地点解析（Place Resolution）：将自然语言地址（如 "Ivry-sur-Seine"）解析为系统可识别的 stop_area ID，支持返回多条候选项以处理歧义。
2. 行程规划（Journey Planning）：支持自由文本起终点输入，自动完成地点解析后生成多条路线方案，可指定返回数量（--count）。
3. 实时故障查询（Incidents/Disruptions）：按线路 ID 或状态过滤器（如 disruption.status=active）查询当前运营异常，适用于 RER、地铁、公交等多种交通方式。
显著优点
- 零依赖轻量化：单 Python 脚本实现，无需额外安装库，开箱即用。
- 自然语言友好：起终点支持自由文本，降低用户使用门槛。
- 灵活输出格式：默认人类可读，加
--json可直接获取原始 API 响应，便于二次开发。 - 官方数据源：直接对接 IDFM PRIM/Navitia，数据权威性与实时性有保障。
潜在局限与风险
- API Key 门槛：必须预先配置
IDFM_PRIM_API_KEY环境变量，个人用户需自行申请，有一定准入门槛。 - 地理范围限制：仅覆盖法兰西岛大区，不支持法国其他地区或国际城市。
- 歧义处理依赖人工：若地点解析结果存在多个候选项，需用户手动选择正确的
stop_area，自动化程度有限。 - 无内置缓存：重复查询相同地点时会多次调用解析接口，未优化高频场景。
适合人群
- 需要在巴黎大区进行公共交通路线规划的开发者与终端用户
- 希望集成官方实时故障数据的运维监控或出行提醒应用
- 对 Navitia API 有了解、希望降低调用复杂度的技术用户
常规风险提示
- API Key 属于敏感凭证，请确保环境变量配置安全，避免硬编码或泄露到版本控制。
- 故障查询结果依赖运营商实时上报，可能存在延迟或覆盖不全。
- 路线规划不包含票价与实时拥挤度信息，如需商业决策建议交叉验证。