如何正确解析 USDA 农贸市场 API 返回的 JSON 数据-Golang-PHP中文网

如何正确解析 USDA 农贸市场 API 返回的 JSON 数据

usda 农贸市场 api 实际返回标准 json（非 jsonp），问题根源在于结构体定义与 api 响应格式不匹配；需根据真实响应结构调整 go 结构体，并规范错误处理与资源释放。

usda 农贸市场 api 实际返回标准 json（非 jsonp），问题根源在于结构体定义与 api 响应格式不匹配；需根据真实响应结构调整 go 结构体，并规范错误处理与资源释放。

USDA Farmers Market Directory API（如 zipSearch 端点）返回的是标准 JSON，而非 JSONP。其 HTTP 响应头明确声明 Content-Type: application/json; charset=utf-8，因此无需任何 JSONP 解析器或额外第三方包——直接使用 Go 标准库 encoding/json 即可。所谓“JSONP 无法解析”的困惑，本质是 Go 结构体字段未与实际 JSON 数据结构对齐，导致 json.Unmarshal 静默失败（字段值为空）或报错。

✅ 正确建模 API 响应结构

以 zipSearch?zip=20902 为例，真实响应为如下格式（精简）：

{
  "results": [
    {
      "id": "1001745",
      "marketname": "Bethesda Central Farm Market",
      "address": "Bethesda, MD 20814",
      "schedule": "Saturdays, 9:00 AM - 1:00 PM",
      "products": "Baked Goods, Cheese, Crafts, Flowers, Eggs, Seafood, Herbs, Vegetables, Honey, Jams, Maple, Meat, Organic, Plants, Poultry, Prepared Food, Soap, Wine",
      "googlelink": "https://www.google.com/maps/search/?api=1&query=Bethesda+Central+Farm+Market"
    }
  ]
}

对应地，Go 结构体应严格匹配嵌套层级与字段名（注意大小写和 json tag）：

Expanso yaml-to-json

使用 Expanso Edge 管道将 YAML 输入转换为 JSON 格式。

下载

type MarketResponse struct {
    Results []Market `json:"results"`
}

type Market struct {
    ID          string `json:"id"`
    MarketName  string `json:"marketname"` // 注意：API 字段为小写开头的 marketname
    Address     string `json:"address"`
    Schedule    string `json:"schedule"`
    Products    string `json:"products"`
    GoogleLink  string `json:"googlelink"` // 而非 GoogleLink（驼峰命名不匹配）
}

⚠️ 关键细节：

marketname、googlelink 等字段在 API 中均为全小写，必须通过 json:"marketname" 显式映射；

原始代码中 MapsLink、Address 等字段名虽语义合理，但因未正确绑定 json tag 或字段名不一致，导致反序列化失败；

响应是对象包裹数组（{"results":[...]}），而非扁平对象，因此顶层结构体必须包含 Results []Market 字段。

✅ 完整、健壮的请求与解析示例

package main

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

type MarketResponse struct {
    Results []Market `json:"results"`
}

type Market struct {
    ID         string `json:"id"`
    MarketName string `json:"marketname"`
    Address    string `json:"address"`
    Schedule   string `json:"schedule"`
    Products   string `json:"products"`
    GoogleLink string `json:"googlelink"`
}

func fetchMarketsByZip(zipcode string) ([]Market, error) {
    url := fmt.Sprintf("http://search.ams.usda.gov/farmersmarkets/v1/data.svc/zipSearch?zip=%s", zipcode)

    client := &http.Client{Timeout: 10 * time.Second}
    resp, err := client.Get(url)
    if err != nil {
        return nil, fmt.Errorf("HTTP request failed: %w", err)
    }
    defer func() {
        if closeErr := resp.Body.Close(); closeErr != nil {
            log.Printf("Failed to close response body: %v", closeErr)
        }
    }()

    if resp.StatusCode != http.StatusOK {
        return nil, fmt.Errorf("API returned status %d", resp.StatusCode)
    }

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        return nil, fmt.Errorf("failed to read response body: %w", err)
    }

    var mr MarketResponse
    if err := json.Unmarshal(body, &mr); err != nil {
        return nil, fmt.Errorf("JSON unmarshal failed: %w (raw: %s)", err, string(body))
    }

    return mr.Results, nil
}

func main() {
    markets, err := fetchMarketsByZip("20902")
    if err != nil {
        log.Fatal(err)
    }

    for i, m := range markets {
        fmt.Printf("[%d] %s — %s\n", i+1, m.MarketName, m.Address)
    }
}