Google Weather

核心用法

Google Weather 是一个基于 Google Cloud Weather API 的命令行天气查询工具，通过 Python 脚本提供格式化的天气数据输出。用户可通过简单指令获取任意地点的实时天气：

python3 skills/google-weather/lib/weather_helper.py current "城市名"  # 格式化输出
python3 skills/google-weather/lib/weather_helper.py json "城市名"      # 原始 JSON

内置地理编码功能，自动将城市名转换为坐标，支持全球任意地点。输出包含温度、体感温度、天气状况（带 emoji 图标）、湿度、风向风速、降水概率、云量、能见度、UV 指数等完整气象维度。

显著优点

1. 数据源权威：Google Weather API 底层数据，商业级可靠性，15 分钟高频更新
2. 全球覆盖：支持任意城市、地标或坐标输入，自动地理编码无需手动查经纬度
3. 多语言适配：根据地点自动切换输出语言（已验证支持英语、希伯来语等）
4. 输出友好：emoji 增强的可读格式，同时保留 JSON 接口供程序调用
5. 密钥灵活：支持 GOOGLE_API_KEY、GOOGLE_WEATHER_API_KEY、GOOGLE_MAPS_API_KEY 多种环境变量

潜在缺点与局限性

1. 依赖商业 API：需 Google Cloud 账号及有效 API key，存在使用配额和潜在费用（Google Cloud 免费层通常覆盖个人使用）
2. 网络依赖：纯云端服务，无离线能力，API 故障时完全不可用
3. 功能边界：仅限数据查询，无预警推送、历史数据、多地点对比等高级功能
4. 隐私考量：查询记录会上传至 Google Cloud，敏感位置查询存在数据留存风险

适合人群

• 需要快速获取权威天气数据的开发者和技术用户
• 已有 Google Cloud 基础设施的企业/团队
• 对数据准确性要求高、愿意承担轻度配置成本的用户
• 需要集成天气数据到自动化工作流的场景

常规风险

• API 密钥泄露：环境变量配置不当可能导致密钥暴露于进程列表或日志
• 成本失控：高频自动化查询可能超出免费配额产生意外账单
• 服务依赖：Google API 政策变更或服务下线将影响功能可用性
• 地理位置隐私：精确坐标查询可能暴露用户行踪模式

核心用法

Google Weather 是一个调用 Google 官方 Weather API 的轻量级天气查询工具，通过命令行即可获取全球任意地点的实时天气数据。使用时需先在 Google Cloud Console 创建项目并启用 Weather API 与 Geocoding API，将 API 密钥配置为环境变量 GOOGLE_API_KEY 后即可运行。

支持两种输出模式：格式化文本（默认）适合快速阅读，包含温度、体感温度、天气状况（带 emoji）、风向风速、湿度等关键信息；JSON 原始数据模式便于程序化处理。地点输入灵活，支持城市名（如 "New York"）、地标或坐标，自动通过 Google Maps Geocoding API 解析为经纬度。

显著优点

1. 数据权威性高：直接调用 Google 官方 Weather API，数据每15分钟更新，覆盖全球且支持多语言输出
2. 依赖极简：仅依赖 Python 标准库 requests，无复杂依赖树，部署轻量
3. 安全配置规范：API 密钥通过环境变量读取，无硬编码风险，符合安全最佳实践
4. 输出友好：格式化输出包含 emoji 图标，直观易读，适合终端快速查看

潜在局限

• 需外部 API 密钥：必须拥有 Google Cloud 账号并启用计费，对偶尔使用者门槛较高
• 网络依赖性强：无本地缓存机制，每次查询均需实时请求 Google API
• 错误处理较简单：当前版本对 API 限流、网络超时等异常情况提示不够精细
• 许可证未声明：项目未明确开源许可证，使用者权限边界模糊

适合人群

• 需要快速获取权威天气数据的开发者和技术用户
• 已将工作流搭建在 Google Cloud 生态内的团队
• 对数据准确性和更新频率有要求的场景（如出行、户外作业参考）

常规风险

• API 成本：Google Weather API 超出免费额度后按调用计费，高频使用需关注用量
• 密钥泄露风险：环境变量配置不当可能导致密钥泄露，建议配合密钥管理服务使用
• 服务可用性依赖：完全依赖 Google 服务稳定性，无降级方案