17370845950

如何使用Golang开发天气查询工具_Golang API数据获取项目讲解
用Golang标准库可开发轻量稳定天气查询工具:注册获取API密钥,定义匹配JSON字段的导出结构体,用net/http发起GET请求并解析响应,通过flag支持命令行参数,友好提示各类错误,格式化输出温度、湿度、天气描述。

用 Golang 开发天气查询工具,核心是调用公开天气 API(如 OpenWeatherMap、和风天气等),发送 HTTP 请求、解析 JSON 响应、结构化输出。整个过程不依赖框架,标准库就能完成,轻量且稳定。

注册 API 并获取密钥

大多数免费天气 API 需要注册账号并申请 API Key。以 OpenWeatherMap 为例:

  • 访问 https://openweathermap.org/api,点击 “Sign Up” 注册
  • 登录后进入 API Keys 页面,复制生成的 32 位字符串(如 abc123def456...
  • 免费版默认支持每分钟 1000 次请求,足够本地开发和小规模使用

定义结构体匹配 JSON 返回

API 返回的是嵌套 JSON,需用 Go 结构体精准映射。例如 OpenWeatherMap 的当前天气接口返回包含 main.tempweather[0].description 等字段:

type WeatherResponse struct {
    Name string `json:"name"`
    Main struct {
        Temp     float64 `json:"temp"`
        Humidity int     `json:"humidity"`
    } `json:"main"`
    Weather []struct {
        Description string `json:"description"`
    } `json:"weather"`
}

注意字段首字母大写(导出)、tag 中的 json: 名称要与 API 字段完全一致(含大小写),否则解析为空。

发起 HTTP 请求并处理响应

使用 net/http 发起 GET 请求,带上 API Key 和城市参数(支持城市名或经纬度):

  • 构造 URL:如 https://api.openweathermap.org/data/2.5/weather?q=Beijing&appid=YOUR_KEY&units=metric
  • http.Get() 获取响应,检查 resp.StatusCode 是否为 200
  • json.NewDecoder(resp.Body).Decode(&data) 解析到结构体
  • 记得 defer resp.Body.Close() 防止连接泄漏

封装命令行交互与错误提示

flag 包支持命令行参数,让工具更实用:

  • 运行时输入:./weather -city Shanghai -key abc123
  • 对空城市名、网络超时、API 错误码(如 404 城市未找到)分别给出友好提示
  • 成功时格式化输出:温度、湿度、天气描述,例如 上海 | 22.5°C | 多云 | 湿度 68%

基本上就这些。不需要第三方库,Go 标准库 + 一次 API 调用 + 合理结构体,就能跑通一个可用的天气查询小工具。关键在理解 API 文档字段、正确解码、以及处理常见异常。