Skip to content
ZGI Services

Daily climate

Daily historical climate values for one point from NASA POWER (temperature, precipitation, relative humidity, wind speed, solar irradiance), over an inclusive span of at most 366 days between 1981-01-01 and today (UTC); unavailable values are null.
Endpoint POST /v1/climate-daily-queries
Scope climate_daily:query
MCP tool climate_daily
Usage units days

Usage units appear in execution.usage.units for reconciliation and billing.

Request fields

Section titled “Request fields”
Field Type Required Description
invocation_id string yes The market’s invocation id: one execution per id and operation, so a retry with the same id is rejected instead of charged twice. 1-128 characters of A-Z a-z 0-9 . _ : -.
provider string yes Provider that serves the request; choose by the coverage described for this tool. One of: nasa-power
end_date string yes Last date, YYYY-MM-DD, inclusive; not after today (UTC) and at most 366 days from start_date.
latitude number yes WGS 84 latitude in decimal degrees, -90 to 90.
longitude number yes WGS 84 longitude in decimal degrees, -180 to 180.
start_date string yes First date, YYYY-MM-DD, 1981-01-01 or later.
parameters string[] no Optional at most 7 of temperature_mean_c, temperature_max_c, temperature_min_c, precipitation_mm, relative_humidity_pct, wind_speed_ms, solar_irradiance_kwh_m2; default temperature_mean_c and precipitation_mm.

Providers

Section titled “Providers”
Provider Region Source Limits
nasa-power US NASA POWER max_days: 366, max_parameters: 7, timeout_seconds: 30

Example

Section titled “Example”
终端窗口
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"}'

Response

Section titled “Response”

A real response, with lists cut to two items and long text shortened.

{
  "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"
      }
    }
  }
}