Golang调用天气API与数据解析实战

OpenWeatherMap是首选免费稳定天气API：注册即获32位API Key，需通过环境变量安全使用；用带10秒超时的http.Client发起请求并正确关闭resp.Body；JSON解析需导出字段和嵌套struct；优先通过地理编码API获取经纬度再查天气以避免地名歧义。

怎么选天气API服务商并获取可用的API Key

免费且稳定可用的天气API其实不多，OpenWeatherMap 是目前最省心的选择：注册即得免费 Key，每分钟 1000 次调用限额，响应快、文档全、支持 JSON。别碰那些要求“实名认证+企业资质”的小众接口——开发阶段根本跑不起来。

注册后在 https://home.openweathermap.org/api_keys 页面复制你的 Key，它是一串 32 位十六进制字符串，类似 2a4b7c1e9f8d3a5b6c7d8e9f0a1b2c3d。这个 Key 要作为查询参数传给 API，千万别硬编码进 main.go；用环境变量更安全：

export OPENWEATHER_API_KEY=2a4b7c1e9f8d3a5b6c7d8e9f0a1b2c3d

常见坑：
• Key 复制时多了一个空格或换行（len(key) 不是 32 就是错了）
• 请求 URL 拼错，比如把 api.openweathermap.org 写成 www.openweathermap.org
• 忘了加 appid=xxx 参数，返回 {"cod":"401","message":"Invalid API key."}

用 net/http 发起 GET 请求并处理超时与错误

Go 标准库的 net/http 完全够用，不用额外引入第三方 HTTP 客户端。关键不是“怎么发请求”，而是“怎么不被卡住”——天气 API 偶尔延迟高或不可达，必须设超时。

不要直接用 http.Get()，它没有超时控制。正确做法是构造带超时的 http.Client：

client := &http.Client{
    Timeout: 10 * time.Second,
}

然后用 client.Do(req) 发起请求。注意以下几点：
• resp.Body 一定要 defer resp.Body.Close()，否则连接不释放，跑几次就报 dial tcp: too many open files
• 检查 resp.StatusCode 是否为 200，OpenWeatherMap 出错时返回 4xx/5xx，但 body 里仍有 JSON 错误信息
• 不要忽略 err：网络不通、DNS 失败、TLS 握手失败都会在这里抛出，不能只看 status code

解析 JSON 响应并映射到结构体（含嵌套字段）

OpenWeatherMap 的 JSON 结构较深，比如温度在 main.temp，城市名在 name，国家码在 sys.country。用 Go 的 struct tag 精确对应即可，不需要第三方库。

定义结构体时注意：
• 所有字段首字母大写（导出），否则 json.Unmarshal 无法赋值
• 用 json:"xxx" tag 映射字段名，支持嵌套路径（如 sys.country 需拆成两层 struct）
• 温度单位默认是 Kelvin，转摄氏度要减 273.15，别漏掉小数点
• weather 是数组，即使只有一项也要定义为 []WeatherItem

示例片段：

type WeatherResponse struct {
    Name string `json:"name"`
    Main struct {
        Temp float64 `json:"temp"`
    } `json:"main"`
    Sys struct {
        Country string `json:"country"`
    } `json:"sys"`
    Weather []struct {
        Main string `json:"main"`
        Description string `json:"description"`
    } `json:"weather"`
}

把城市名转成经纬度再查天气（避免地名歧义）

直接用城市名查天气（/data/2.5/weather?q=Beijing）容易出错：北京 vs 北京市（美国）、London（UK）vs London（Canada）。更可靠的方式是先调用地理编码 API 获取坐标，再用坐标查天气。

OpenWeatherMap 提供免费地理编码接口：http://api.openweathermap.org/geo/1.0/direct?q={city}&limit=1&appid={key}。它返回一个数组，取第一个元素的 lat 和 lon，再拼到天气接口：/data/2.5/weather?lat={lat}&lon={lon}&appid={key}。

关键细节：
• 地理编码接口返回的是 []GeoResult，不是单个对象，别忘了索引 [0]
• 如果城市不存在，返回空数组，需检查 len(results) == 0 并报错
• 经纬度是 float64，拼 URL 时用 fmt.Sprintf 或 url.Values 编码，避免小数点被截断或特殊字符未转义

这一步让程序健壮性提升明显，尤其对拼音相同但位置不同的城市（如 “Shanghai” 和 “ShangHai”）。