id: idfm-journey-skill
名称： IDFM 行程查询
描述： 查询法兰西岛交通局（IDFM）的 PRIM/Navitia 接口，获取巴黎及郊区（法兰西岛地区）的公共交通信息——包括地点解析、行程规划和中断/事件检查。
env: ['IDFM_PRIM_API_KEY']
许可证： MIT
元数据：
author: anthonymq
category: "交通"
tags: ["idfm", "navitia", "巴黎", "交通"]

IDFM 行程查询（PRIM/Navitia）

使用内置脚本调用 PRIM/Navitia 接口，无需额外依赖。

前提条件 / 安全须知

• 必需密钥： IDFM_PRIM_API_KEY（请视为机密信息，切勿提交到代码库）。
• 限制作用域： 仅在运行命令的 shell/会话中设置该密钥。
• 切勿随意覆盖 --base-url： 除非你完全信任目标端点。
  脚本会将 apikey: <IDFM_PRIM_API_KEY> 发送到你提供的任何基础 URL，恶意 URL 可能导致密钥泄露。

快速命令

可在任意位置运行（脚本路径位于技能文件夹内）：

• 解析地点（最佳匹配 + 列表）：

• python3 scripts/idfm.py places "Ivry-sur-Seine" --count 5

• 行程规划（自由文本起点/终点；先解析地点 ID）：

• python3 scripts/idfm.py journeys --from "Ivry-sur-Seine" --to "Boulainvilliers" --count 3

• 事件 / 中断（按线路 ID 或过滤器）：

• python3 scripts/idfm.py incidents --line-id line:IDFM:C01727
• python3 scripts/idfm.py incidents --filter 'disruption.status=active'

添加 --json 参数可打印原始 API 输出。

注意事项

• 若地点解析结果不明确，可增加 --count 值并选择正确的 stop_area ID。
• 有关 API 详情和示例，请阅读：references/idfm-prim.md。