怎样用Golang开发天气查询应用 调用第三方API获取数据解析

package main

import (
    "encoding/json"
    "fmt"
    "io"
    "net/http"
    "os"
    "time"
)

// WeatherResponse 结构体定义，用于匹配OpenWeatherMap API的JSON响应
// 这里只取了部分关键字段，实际应用可能需要更多
type WeatherResponse struct {
    Weather []struct {
        Description string `json:"description"`
        Icon        string `json:"icon"`
    } `json:"weather"`
    Main struct {
        Temp      float64 `json:"temp"`
        FeelsLike float64 `json:"feels_like"`
        TempMin   float64 `json:"temp_min"`
        TempMax   float64 `json:"temp_max"`
        Humidity  int     `json:"humidity"`
    } `json:"main"`
    Name string `json:"name"` // 城市名称
    Cod  int    `json:"cod"`  // 状态码
}

// getWeatherData 从OpenWeatherMap API获取天气数据
func getWeatherData(city string, apiKey string) (*WeatherResponse, error) {
    // 构建API请求URL
    // 确保API Key和城市名正确编码，这里简单处理
    apiURL := fmt.Sprintf("http://api.openweathermap.org/data/2.5/weather?q=%s&appid=%s&units=metric&lang=zh_cn", city, apiKey)

    // 创建一个HTTP客户端，设置超时
    client := &http.Client{Timeout: 10 * time.Second}

    // 发送GET请求
    resp, err := client.Get(apiURL)
    if err != nil {
        return nil, fmt.Errorf("请求天气API失败: %w", err)
    }
    // 确保响应体被关闭，避免资源泄露
    defer resp.Body.Close()

    // 检查HTTP状态码
    if resp.StatusCode != http.StatusOK {
        // 尝试读取错误信息，如果API有返回的话
        bodyBytes, _ := io.ReadAll(resp.Body)
        return nil, fmt.Errorf("API请求返回非成功状态码: %d, 响应: %s", resp.StatusCode, string(bodyBytes))
    }

    // 读取响应体
    bodyBytes, err := io.ReadAll(resp.Body)
    if err != nil {
        return nil, fmt.Errorf("读取API响应失败: %w", err)
    }

    // 解析JSON数据到WeatherResponse结构体
    var weatherData WeatherResponse
    err = json.Unmarshal(bodyBytes, &weatherData)
    if err != nil {
        return nil, fmt.Errorf("解析JSON数据失败: %w", err)
    }

    // 检查API返回的内部状态码，有些API会在JSON中提供业务错误码
    if weatherData.Cod != http.StatusOK {
        // OpenWeatherMap在城市未找到时Cod会是404
        return nil, fmt.Errorf("API返回业务错误码: %d, 城市可能不存在", weatherData.Cod)
    }

    return &weatherData, nil
}

func main() {
    // 从环境变量获取API Key，这是更安全的做法
    apiKey := os.Getenv("OPENWEATHER_API_KEY")
    if apiKey == "" {
        fmt.Println("错误：请设置环境变量 OPENWEATHER_API_KEY")
        fmt.Println("示例：export OPENWEATHER_API_KEY=你的API密钥")
        return
    }

    city := "Beijing" // 默认查询城市，也可以从命令行参数获取

    // 尝试获取天气数据
    weather, err := getWeatherData(city, apiKey)
    if err != nil {
        fmt.Printf("获取天气数据时发生错误: %v\n", err)
        return
    }

    // 打印天气信息
    fmt.Printf("%s当前天气：\n", weather.Name)
    if len(weather.Weather) > 0 {
        fmt.Printf("  描述: %s\n", weather.Weather[0].Description)
    }
    fmt.Printf("  温度: %.1f°C (体感: %.1f°C)\n", weather.Main.Temp, weather.Main.FeelsLike)
    fmt.Printf("  湿度: %d%%\n", weather.Main.Humidity)
    fmt.Printf("  最高温: %.1f°C, 最低温: %.1f°C\n", weather.Main.TempMax, weather.Main.TempMin)
}

net/http

http.Get()

http.Client

http.Client

Timeout

io.ReadAll

defer resp.Body.Close()

encoding/json

json.Unmarshal

json:"json_key_name"

tag

main

main

WeatherResponse

weather

[]struct{}