Google Weather

核心用法

Google Weather skill 通过调用 Google Cloud Weather API 获取全球任意地点的实时天气数据。支持三种输出模式：

• current：格式化当前天气（温度、体感温度、湿度、风速、天气状况 emoji）
• forecast：24小时逐小时预报
• json：原始 JSON 数据供二次开发

命令行调用格式统一为 python3 skills/google-weather/lib/weather_helper.py <mode> <location>，location 支持城市名、地址、地标或坐标，自动通过 Google Maps Geocoding API 解析。

显著优点

1. 数据权威性：Google Weather API 整合多源气象数据，每15分钟更新，准确度高
2. 全球覆盖：支持任意地点，自动地理编码无需手动输入坐标
3. 单位灵活：通过环境变量 GOOGLE_WEATHER_UNITS 一键切换公制/英制，无需改代码
4. 本地化输出：根据位置自动适配语言（英语、希伯来语等）
5. 信息维度全：涵盖温度、湿度、风速风向、UV指数、降水概率、云量、能见度等

潜在缺点与局限性

• 依赖外部 API：需自行申请 Google Cloud API key，存在调用配额和费用（Google Cloud 免费 tier 通常足够个人使用）
• 网络依赖：完全依赖 Google 服务可用性，国内用户可能需要特殊网络环境
• 预报精度：24小时逐小时预报对极端天气事件的准确性受限于 Google 数据源
• 配置门槛：需要 Google Cloud 项目创建、API 启用、密钥管理等步骤，对非技术用户不够友好

适合人群

• 开发者集成天气数据到自动化工作流
• 需要可靠全球天气数据的运维/运维场景
• 多语言环境下的国际化应用

常规风险

• API 密钥泄露风险：需妥善保管 GOOGLE_API_KEY 等环境变量
• 成本控制：高频调用可能产生 Google Cloud 费用
• 服务依赖：Google API 政策变更或服务下线将影响功能

核心用法

google-weather 是一个基于 Google Weather API 的天气查询工具，支持获取全球任意地点的实时天气状况和24小时预报。用户通过简单的命令行参数即可查询温度、湿度、风速、体感温度、紫外线指数、降水概率等详细数据，输出包含 emoji 图标的格式化结果，支持公制/英制单位切换及多语言显示。

显著优点

• 数据源权威：直接调用 Google Cloud 官方 Weather API，数据更新频率达每15分钟，准确性高
• 全球覆盖：支持任意城市名称、地址或坐标查询，自动通过 Google Geocoding API 解析地理位置
• 功能完整：涵盖当前状况、24小时逐小时预报、温度、湿度、风速、UV指数、降水概率、能见度等多维度数据
• 输出友好：格式化输出含 emoji 图标，支持公制（°C/km/h）与英制（°F/mph）单位一键切换
• 多语言支持：根据地点自动适配输出语言（如特拉维夫显示希伯来语）
• 轻量安全：仅依赖 Python 标准库和 requests，无第三方包引入供应链风险

潜在缺点与局限性

• API密钥门槛：必须自行注册 Google Cloud 项目并启用 Weather API 与 Geocoding API，对新手存在配置成本
• 付费限制：Google Weather API 非完全免费，高频调用可能产生费用
• 网络依赖：完全依赖 Google 服务可用性，部分地区存在访问限制
• 预报时长有限：仅支持24小时逐小时预报，缺乏7天或更长周期的趋势预测
• T3来源：由个人开发者维护，无企业背书，长期维护稳定性待观察

适合人群

• 需要集成可靠天气数据的开发者与自动化工作流用户
• 对数据实时性有要求、愿意承担 API 配置成本的技术用户
• 全球多地业务需要统一数据源的企业场景

常规风险

• API密钥泄露风险：需通过环境变量妥善保管 GOOGLE_API_KEY
• 地理位置隐私：查询时向 Google 发送位置信息，虽符合 GDPR/CCPA 但需注意合规
• 速率限制：未实现自动退避策略，高频调用可能触发 Google 配额限制
• 服务中断依赖：Google API 策略变更或区域封锁可能影响可用性