如何做一个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() 发请求，记得检查 err 和 resp.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.Map 存 map[string]WeatherResponse，key 是 city+unit，value 带时间戳。每次查先判缓存是否过期。

错误处理重点不是“优雅”，而是“有用”：

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

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