如何做一个Golang天气查询应用_Golang第三方API获取与结构化输出

用Golang做天气查询应用的核心三步是:选OpenWeatherMap等免费API、用net/http发请求并解析JSON、结构化输出;需注意URL编码、坐标查询、结构体tag、状态码与cod字段校验、缓存及错误提示。

用 Golang 做一个天气查询应用不难,核心就三步:选一个稳定免费的天气 API、用 net/http 发请求并解析 JSON、把数据结构化输出(命令行或简单 Web)。下面直接说实用做法,不绕弯。

选一个开箱即用的第三方天气 API

推荐 OpenWeatherMap(https://www./link/a5aef5357bc5d38853c0b0d3cca7bf8c),注册免费账号就能拿到 API Key,每分钟 1000 次调用、每天 1000 次,够个人学习和小工具用。它支持按城市名、坐标、ZIP 码查天气,返回 JSON 清晰,文档友好。

示例请求地址(当前天气):

https://api.openweathermap.org/data/2.5/weather?q=Beijing&appid=YOUR_API_KEY&units=metric

  • 注意 units 参数:填 metric 返回摄氏度,imperial 是华氏度
  • 中文城市要 URL 编码,比如 “上海” 要写成 q=%E4%B8%8A%E6%B5%B7,或者直接用英文名 q=Shanghai
  • 如果想查更准,建议用经纬度接口:/geo/1.0/direct?q={city} 先查坐标,再用 /weather?lat={}&lon={}

用 Go 写 HTTP 请求 + JSON 解析

不用额外框架,标准库就够了。关键点是定义好结构体,字段名要和 JSON key 对应(注意 tag)。

示例结构体(精简版):

type WeatherResponse struct {
    Name string `json:"name"`
    Main struct {
        Temp     float64 `json:"temp"`
        FeelsLike float64 `json:"feels_like"`
        Humidity int     `json:"humidity"`
    } `json:"main"`
    Weather []struct {
        Main        string `json:"main"`
        Description string `json:"description"`
    } `json:"weather"`
}
  • http.Get() 发请求,记得检查 errresp.StatusCode
  • json.NewDecoder(resp.Body).Decode(&data) 解析,别用 json.Unmarshal 读全部字节——对大响应不友好
  • API 返回错误时(比如城市不存在),OpenWeatherMap 仍返回 200,但带 {"cod": "404", "message": "city not found"},需手动判断 cod 字段

结构化输出:命令行友好格式

终端里看天气,别堆 JSON。按逻辑分块打印,加点颜色(可选)提升可读性:

  • 第一行:城市名 + 当前时间(用 time.Now().Format("Jan 2 15:04")
  • 第二行:温度 + “体感” + 天气描述(如 “晴,少云”)
  • 第三行:湿度 + 风速(如果 API 返回 wind.speed)
  • \t 或固定宽度对齐,避免换行错乱

进阶可加 flag 支持:weather -city Beijing -unit imperial,用 flag.String 解析参数。

可选增强:缓存与错误处理

天气变化慢,本地缓存 10 分钟很合理。用 sync.Mapmap[string]WeatherResponse,key 是 city+unit,value 带时间戳。每次查先判缓存是否过期。

错误处理重点不是“优雅”,而是“有用”:

  • 网络失败 → 提示 “网络不通,请检查代理或重试”
  • API 返回非 200 → 打印 OpenWeatherMap 的 message 字段
  • JSON 解析失败 → 检查结构体 tag 是否写错,或打印原始响应前 200 字符辅助调试

基本上就这些。不复杂但容易忽略细节,跑通一次,后面加功能(比如 5 天预报、CLI 自动补全、Web 页面)就顺了。