french-services

🗼 法国交通物流天气一站式查询

🥥61总安装量 17评分人数 22
100% 的用户推荐

基于 SNCF、La Poste 等官方 API 的法国本地服务工具,提供火车时刻、包裹追踪、天气预报及巴黎交通实时信息,助力在法生活出行。

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 代码安全规范,无 eval/exec/system/subprocess 等危险函数
  • ✅ 仅使用 Python 标准库,零第三方依赖,无供应链攻击风险
  • ✅ 无动态代码加载及静默数据收集行为,用户数据完全可控
  • ✅ 完善的输入验证和错误处理机制,API 密钥需用户主动配置
  • ⚠️ T3 来源(个人开发者 hugosbl),建议生产环境使用前自行审查代码

使用说明

核心用法

French Services 提供四个独立的命令行工具,覆盖法国日常生活关键场景:

  • 🚄 SNCF 火车查询 (sncf.py):基于 Navitia API 查询法国铁路的列车时刻表、路线规划及线路中断信息,支持按日期时间搜索特定路线或查询车站发车信息。
  • 📦 La Poste 包裹追踪 (laposte.py):通过法国邮政官方 API 实时追踪包裹物流状态,支持批量查询多个包裹号。
  • 🌤️ 天气预报 (meteo.py):使用 Open-Meteo 的 Météo France 模型,提供法国境内任意城市的当前天气及未来 3-7 天预报,支持坐标定位,无需 API 密钥即可使用。
  • 🚇 巴黎大区交通 (ratp.py):基于 IDFM PRIM API 实时查询地铁、RER、公交等交通状态及特定站点的下一班车时间。

所有脚本均支持 --json 参数输出结构化数据,便于与自动化工具集成。

显著优点

1. 零依赖架构:仅使用 Python 标准库,无需安装第三方包,彻底避免依赖冲突和供应链安全风险。

2. 官方数据源:直接对接 SNCF、La Poste、Météo France 及 IDFM 官方 API,数据权威且实时性高。

3. 隐私友好:除必要的 API 密钥外不收集用户个人信息,天气查询甚至无需注册即可使用。

4. 轻量易用:命令行界面简洁直观,配合详细的法语文档,便于本地用户直接使用。

潜在局限

1. 配置门槛:除天气服务外,其余功能需用户自行注册并配置 API 密钥,对非技术用户有上手难度。

2. 地域限制:功能高度专注于法国本土及巴黎大区,对其他国家或地区无支持,适用场景相对单一。

3. 功能边界:作为轻量级脚本,缺乏历史数据存储、智能提醒等高级功能,不适合企业级复杂场景。

适合的目标群体

  • 在法居民与留学生:需要日常查询火车时刻、跟踪包裹或查看天气的本地生活人群。
  • 赴法游客:规划行程前查询交通状况和天气预报的旅行者。
  • 跨境电商从业者:需要批量追踪发往法国包裹物流状态的物流管理人员。
  • 开发者:需要快速集成法国公共服务 API 作为自动化工作流一部分的技术人员。

使用风险

  • API 配额限制:免费 API 密钥通常有调用频率限制(如 Navitia 5000 次/月),高频使用可能触发限流。
  • 网络稳定性:依赖外部 API 服务,如遇官方服务器维护,功能将暂时不可用。
  • 数据准确性:实时交通信息可能因突发情况延迟更新,建议关键行程通过官方 App 二次确认。
  • 密钥管理风险:用户需自行妥善保管 API 密钥,避免硬编码在脚本中导致泄露。

french-services 内容

文件夹图标references文件夹
文件夹图标scripts文件夹
手动下载zip · 17.0 kB
api-setup.mdtext/markdown
请选择文件