气候日数据

查询任意经纬度的历史逐日气候数据（气温、降水、湿度、风速、太阳辐照），数据来自 NASA POWER，单次最多 366 天，最早到 1981-01-01。

接口	POST /v1/climate-daily-queries
所需权限	climate_daily:query
MCP 工具	climate_daily
计量单位	days

计量单位出现在 execution.usage.units 中，用于对账和计费。

请求字段

字段	类型	必填	说明
invocation_id	string	是	调用方（市场）生成的调用 ID：同一个 ID 在同一操作上只执行一次，用同一 ID 重试会被拒绝而不会重复计费。1–128 个字符，可用 A-Z a-z 0-9 . _ : -。
provider	string	是	处理本次请求的数据源，按下方数据源表的覆盖范围选择。 可选值：nasa-power
end_date	string	是	结束日期 YYYY-MM-DD（含当天），不晚于今天（UTC），距开始日期最多 366 天。
latitude	number	是	WGS 84 纬度，十进制度，-90 到 90。
longitude	number	是	WGS 84 经度，十进制度，-180 到 180。
start_date	string	是	开始日期 YYYY-MM-DD，不早于 1981-01-01。
parameters	string[]	否	可选，最多 7 项：temperature_mean_c、temperature_max_c、temperature_min_c、precipitation_mm、relative_humidity_pct、wind_speed_ms、solar_irradiance；省略时全部返回。

数据源

数据源	区域	说明	限制
nasa-power	US	NASA POWER	max_days: 366, max_parameters: 7, timeout_seconds: 30

示例

curl

curl -sS https://services.zgi.im/v1/climate-daily-queries \
  -H "Authorization: Bearer $ZGI_SERVICES_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"invocation_id": "docs-1791778521-climate_daily", "provider": "nasa-power", "latitude": 39.9, "longitude": 116.4, "start_date": "2026-09-01", "end_date": "2026-09-03"}'

HTTP

POST /v1/climate-daily-queries HTTP/1.1
Host: services.zgi.im
Authorization: Bearer <token>
Content-Type: application/json

{
  "invocation_id": "docs-1791778521-climate_daily",
  "provider": "nasa-power",
  "latitude": 39.9,
  "longitude": 116.4,
  "start_date": "2026-09-01",
  "end_date": "2026-09-03"
}

MCP

通过 MCP 调用时，工具参数与 HTTP 请求体完全相同。

request.json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "climate_daily",
    "arguments": {
      "invocation_id": "docs-1791778521-climate_daily",
      "provider": "nasa-power",
      "latitude": 39.9,
      "longitude": 116.4,
      "start_date": "2026-09-01",
      "end_date": "2026-09-03"
    }
  }
}

curl -sS https://services.zgi.im/v1/mcp \
  -H "Authorization: Bearer $ZGI_SERVICES_TOKEN" \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  -d @request.json

返回

以下为一次真实调用的返回，列表只保留前两项，长文本已截断。

{
  "code": 0,
  "message": "success",
  "data": {
    "execution": {
      "id": "exe_01a12e528a9f72e3bc2f56bca4466a76",
      "invocation_id": "docs-1791778521-climate_daily",
      "capability": "climate_daily",
      "operation": "climate_daily.query",
      "provider": "nasa-power",
      "outcome": "succeeded",
      "error_category": null,
      "error_code": null,
      "usage": {
        "provider_requests": 1,
        "units": [
          {
            "name": "days",
            "value": 3,
            "source": "measured"
          }
        ]
      },
      "upstream_ref": null,
      "request_id": "req_fa3008d0ec3e6ab971adb46a",
      "started_at": "2026-10-12T04:15:23.807186097Z",
      "finished_at": "2026-10-12T04:15:24.075054423Z",
      "duration_ms": 267
    },
    "result": {
      "location": {
        "latitude": 39.9,
        "longitude": 116.4,
        "elevation_m": 221.57
      },
      "days": [
        {
          "date": "2026-09-01",
          "values": {
            "precipitation_mm": 0.0,
            "temperature_mean_c": 23.35
          }
        },
        {
          "date": "2026-09-02",
          "values": {
            "precipitation_mm": 0.0,
            "temperature_mean_c": 23.39
          }
        }
      ],
      "units": {
        "precipitation_mm": "mm/day",
        "temperature_mean_c": "degC"
      },
      "source": {
        "name": "NASA Langley Research Center POWER Project (Daily API)",
        "license": "CC-BY-4.0",
        "url": "https://power.larc.nasa.gov"
      }
    }
  }
}