Home Assistant集成：瑞士公共交通(swiss_public_transport)的请求频率限制解决方案

问题背景

在Home Assistant中使用瑞士公共交通集成时，部分用户会遇到傍晚时段数据停止更新的现象。这通常是由于触发了Transport API的请求频率限制（每日1000次请求上限）。该API由瑞士联邦铁路(SBB)提供，对所有用户实施严格的调用配额管理。

技术原理

该集成通过轮询机制获取实时交通数据，每个连接配置都会产生独立的API调用。当出现以下情况时容易触发限制：

• 配置多个交通路线监控
• 使用默认的60秒更新间隔
• 24小时不间断查询

专业解决方案

方案一：自定义轮询调度（推荐）

1. 禁用默认轮询 在集成配置中关闭"Enable polling"选项，完全接管更新控制权

2. 创建智能自动化规则

   alias: 工作日高峰时段交通更新
   trigger:
     - platform: time_pattern
       minutes: "/5"  # 每5分钟触发
   condition:
     - condition: time
       after: "07:00:00"
       before: "09:00:00"
       weekday:
         - mon
         - tue
         - wed
         - thu
         - fri
   action:
     - service: homeassistant.update_entity
       target:
         entity_id:
           - sensor.bern_zurich_departure
           - sensor.geneva_lausanne_departure
   

3. 分时段策略

   • 工作日早晚高峰：5分钟间隔
   • 日间平峰：10分钟间隔
   • 夜间(00:00-05:00)：暂停更新

方案二：可视化替代方案

对于仅需查看发车时刻表的场景，可采用：

1. 使用iframe面板嵌入第三方时刻表网页
2. 配置静态交通信息卡片
3. 结合地理围栏触发条件更新

最佳实践建议

1. 监控API用量 通过HA开发者工具观察sensor.swiss_public_transport_requests实体，确保每日用量低于900次

2. 分组更新策略 将同类交通线路（如所有地铁线路）分组到同一个自动化中更新，减少触发次数

3. 缓存利用 对非实时性要求高的信息（如站点列表）使用input_select存储，减少API调用

4. 异常处理 在自动化中添加重试机制和失败通知：

   action:
     - service: homeassistant.update_entity
       target:
         entity_id: sensor.bus_123_departure
     - delay: "00:01:00"
     - condition: state
       entity_id: sensor.bus_123_departure
       state: "unavailable"
     - service: notify.mobile_app
       data:
         message: "交通数据更新失败，请检查API状态"
   

技术延伸

理解Transport API的限制机制：

• 每个请求消耗1个信用点
• 信用点桶容量为1000点
• 每日UTC时间00:00重置
• 超过限制后返回429状态码
• 响应头包含剩余配额信息（X-RateLimit-Remaining）

通过合理规划更新策略，既能保证数据的实时性，又可避免触发API限制，实现稳定的智能家居交通信息集成。