开发者 API 文档

快速接入时空路由气象预报引擎，赋能您的业务应用。

接口介绍

基于时空路由引擎的逐点气象查询服务，提供当前天气、未来逐小时天气预报。

Base URL:https://weather.spaceroute.cn/api

数据来源：自研高精度网格算法模型，每 6 小时更新一次
时间格式：UTC，YYYY-MM-DD HH:MM

GET

未来逐小时天气

/weather/hourly

请求参数 (Query Parameters)

参数名	类型	必填	说明
lat	number	是	纬度（-90 ~ 90）
lon	number	是	经度（-180 ~ 360）

响应字段说明

字段	类型	说明
cycle_time	string	起报时间 (UTC)
hourly[].valid_time	string	预报有效时间
hourly[].t2m	number	2m 气温 (°C)
hourly[].feels_like	number	体感温度 (°C)
hourly[].rh	number	相对湿度 (%)
hourly[].wind_speed	number	10m 风速 (m/s)
hourly[].tp	number	逐小时降水量 (mm)
hourly[].tcc	number	总云量 (%)
hourly[].prmsl	number	海平面气压 (hPa)
hourly[].phenomenon	string	天气现象

响应示例 (Response Example)

{
  "cycle_time": "2026-04-24 00:00 UTC",
  "lat": 39.9042,
  "lon": 116.4074,
  "hourly": [
    {
      "valid_time": "2026-04-24 08:00",
      "step_h": 8,
      "t2m": 27.9,
      "feels_like": 27.9,
      "d2m": 2.5,
      "rh": 19.4,
      "wind_speed": 2.3,
      "wind_dir": 214.5,
      "gust": 3.5,
      "tp": 0.0,
      "tcc": 100.0,
      "prmsl": 1007.5,
      "phenomenon": "阴"
    },
    // ...
  ]
}

调用示例

curl "https://weather.spaceroute.cn/api/weather/hourly?lat=39.9042&lon=116.4074"