天聚数行-今日动态 Home Assistant 集成
这是一个 Home Assistant 自定义集成，通过天行数据API获取今日动态信息，包括汇率、油价、空气质量和热点新闻。
功能特点
- 💵 实时汇率：美元兑人民币汇率（24小时更新一次）
- ⛽ 油价信息：全国各省市最新油价（24小时更新一次）
- 🌤️ 空气质量：全国地级市空气质量指数（24小时更新一次）
- 📰 热点新闻：自动滚动显示今日头条热点（可配置滚动间隔）
- ⚙️ 高度可配置：可设置更新间隔和滚动间隔
- 🌏 多地区支持：支持全国31个省市油价查询和300+地级市空气质量查询
安装方法
方法一：通过 HACS 安装（推荐）
- 确保已安装 HACS
- 在 HACS 中添加自定义仓库：
- 在 HACS 中搜索"天聚数行-今日动态"并安装
- 重启 Home Assistant
方法二：手动安装
- 下载本集成文件
- 将
tian_today 文件夹复制到 Home Assistant 的 custom_components 目录
- 重启 Home Assistant
配置
第一步：获取天行数据API密钥
- 访问 天行数据
- 注册账号并登录
- 在控制台申请以下API：
- 获取您的API密钥
第二步：在Home Assistant中添加集成
- 进入 Home Assistant → 设置 → 设备与服务
- 点击"添加集成"
- 搜索"天聚数行-今日动态"
- 输入您的API密钥和配置选项：
- API密钥：您的天行数据API密钥
- 油价省份：选择要查询油价的省份
- 空气质量省份：选择要查询空气质量的省份
- 空气质量城市：从所选省份中选择具体城市（默认莆田）
- 数据更新间隔：API数据更新频率（分钟，默认1440分钟/24小时）
- 头条滚动间隔：热点新闻滚动频率（秒，默认15）
实体说明
安装完成后，将创建一个传感器实体：
- 实体ID:
sensor.jin_ri_dong_tai
- 状态: 最后更新时间
- 属性:
rate_display: 格式化汇率信息oil_display: 格式化油价信息air_display: 格式化空气质量信息（包含AQI、PM2.5、SO2等）hot_display: 当前显示的热点新闻hot_data: 所有热点新闻字典hot_index: 当前热点索引rate_data: 原始汇率数据oil_data: 原始油价数据air_data: 原始空气质量数据province: 选择的油价省份air_city: 选择的空气质量城市scroll_interval: 滚动间隔设置
空气质量数据
空气质量数据包含以下信息：
- 空气质量等级（优质、良、轻度污染等）
- AQI指数
- PM2.5浓度
- PM10浓度
- SO2、NO2、O3、CO浓度
- 首要污染物
- 数据更新时间
自动化示例
在通知中显示今日动态
alias: "每日动态通知"
trigger:
- platform: time
at: "08:00:00"
action:
- service: notify.mobile_app
data:
title: "今日动态"
message: |
{{ state_attr('sensor.jin_ri_dong_tai', 'rate_display') }}
{{ state_attr('sensor.jin_ri_dong_tai', 'oil_display') }}
{{ state_attr('sensor.jin_ri_dong_tai', 'air_display') }}
{{ state_attr('sensor.jin_ri_dong_tai', 'hot_display') }}
空气质量预警自动化
alias: "空气质量预警"
trigger:
- platform: state
entity_id: sensor.jin_ri_dong_tai
condition:
- condition: template
value_template: >
{{ state_attr('sensor.jin_ri_dong_tai', 'air_data').quality in ['中度污染', '重度污染', '严重污染'] }}
action:
- service: notify.mobile_app
data:
title: "空气质量预警"
message: >
{{ state_attr('sensor.jin_ri_dong_tai', 'air_city') }}空气质量{{ state_attr('sensor.jin_ri_dong_tai', 'air_data').quality }}，
请减少户外活动！
在仪表盘显示
在Lovelace仪表盘中添加实体卡片：
type: custom:html-template-card
content: >
{% set entity = 'sensor.jin_ri_dong_tai_2' %}<div style="color: white;"> <p
align="left"><h3 style="color: white; margin-bottom: 0px;"> 【{{
state_attr(entity, 'friendly_name') }}】</h3></p></div>
{{ state_attr(entity, 'hot_display') }}<br> {{ state_attr(entity,
'oil_display') }}</br> {{ state_attr(entity, 'rate_display') }}</br> {{
state_attr(entity, 'air_display') }}
故障排除
常见问题
- 集成无法加载
o 检查API密钥是否正确
o 确认已申请相关API权限
o 查看Home Assistant日志获取详细错误信息
- 数据不更新
o 数据默认24小时更新一次，请耐心等待
o 检查网络连接
o 确认API密钥未过期
o 查看天行数据API调用次数是否超限
- 头条不滚动
o 检查滚动间隔设置
o 确认有可用的热点数据
o 重启Home Assistant
- 空气质量城市无法选择
o 确保已选择空气质量省份
o 城市列表会根据所选省份动态更新
日志查看
如需调试，在configuration.yaml中添加：
logger:
default: info
logs:
custom_components.tian_today: debug
API调用说明
本集成设计为低频率调用API：
• 汇率、油价、空气质量和头条数据：每24小时更新一次
• 热点滚动：本地处理，不调用API
这样可以有效减少API调用次数，避免超过免费额度限制。
更新日志
v1.3.0
• 新增空气质量API功能
• 支持全国300+地级市空气质量查询
• 实现省份-城市二级选择界面
• 空气质量显示添加SO2信息
• 优化中文界面体验
v1.2.0
• 新增空气质量API功能
• 支持80+主要城市空气质量查询
• 优化数据展示格式
v1.1.0
• 移除黄金API，减少API调用
• 优化API调用频率为24小时一次
• 保留汇率、油价和头条功能
v1.0.0
• 初始版本发布
• 支持汇率、油价、黄金、头条数据
支持与反馈
如有问题或建议，请通过以下方式联系：
• GitHub Issues: 项目地址
• 作者: lambilly
许可证
本项目采用 MIT 许可证。
免责声明
本集成仅用于个人学习和非商业用途，数据来源为天行数据API，请遵守天行数据的使用条款。
发表于 
