核心用法
google-weather 是一个调用 Google Weather API 的命令行天气查询工具,通过 Python 脚本提供格式化或原始 JSON 两种输出模式。用户只需输入城市名称即可获取当前天气状况,支持全球任意地点的自动地理编码。
主要功能:
- 实时天气查询:温度(实际/体感)、天气状况(带 emoji 图标)、湿度、风速风向
- 扩展数据:UV 指数、降水概率、云量、能见度
- 多语言输出:自动适配地点语言(支持英语、希伯来语等)
- 灵活调用:提供美观的格式化输出或完整的 JSON 原始数据
显著优点
1. 数据源权威:背靠 Google 气象服务,数据更新频率达 15 分钟,准确性和时效性有保障
2. 全球覆盖:依托 Google Maps 地理编码,支持任意地址、地标或坐标查询
3. 输出友好:emoji 图标增强可读性,同时保留 JSON 接口供开发者集成
4. 轻量易用:命令行一键查询,无需复杂配置,多语言自动适配
潜在局限
- 依赖外部 API:需 Google Cloud 账号及有效 API Key,存在配额和费用风险(Google Maps/Weather API 超出免费额度后收费)
- 隐私考量:查询地点信息会发送至 Google 服务器
- 功能边界:仅支持当前天气,不含未来多日预报(文档未提及 extended forecast)
- 环境依赖:需 Python3 运行环境,非纯离线工具
适合人群
- 开发者需要快速集成天气数据的脚本/自动化工作流
- 命令行用户偏好轻量、无广告的天气查询工具
- 多语言环境下需要本地化天气展示的场景
常规风险
- API 密钥泄露风险:需妥善保管
GOOGLE_MAPS_API_KEY - 服务中断依赖:Google API 服务变更或网络问题会影响可用性
- 成本失控:高频调用可能产生意外账单,建议设置配额监控