杂项

查询历史天气

0次调用
1 积分/次

想知道某个城市过去一段时间有没有下雨、降雨量是多少?这个接口用于查询过去最多 366 天的城市每日历史天气。

GET
uapis.cn
/api/v1/misc/weather/history
查询参数
6
city
string

城市名称,支持中文或英文;可选,不传 city/adcode 时会尝试 IP 自动定位。

adcode
string

6 位行政区划代码,优先级高于 city。

start_date
string

起始日期,格式 YYYY-MM-DD;与 end_date 搭配使用。

end_date
string

结束日期,格式 YYYY-MM-DD,默认昨天。

days
integer

回看天数,1-366,默认 365;仅在未指定 start_date 时生效。

lang
string

返回语言:zh(默认)或 en。

功能概述

支持按 cityadcode 或客户端 IP 自动定位查询。你可以传 start_date + end_date 指定日期范围,也可以只传 days 回看最近若干天。返回结果重点包含 rainedrain,适合做出行复盘、农业记录、气象看板和数据分析。

使用须知

小贴士

定位优先级:adcode > city > IP 自动定位。同时传 start_datedays 时,以 start_date + end_date 区间为准。

查询参数

city
string可选

城市名称,支持中文或英文;可选,不传 city/adcode 时会尝试 IP 自动定位。

adcode
string可选

6 位行政区划代码,优先级高于 city。

start_date
string可选

起始日期,格式 YYYY-MM-DD;与 end_date 搭配使用。

end_date
string可选

结束日期,格式 YYYY-MM-DD,默认昨天。

days
integer可选

回看天数,1-366,默认 365;仅在未指定 start_date 时生效。

lang
string可选

返回语言:zh(默认)或 en。

响应

200 / 请求成功

查询成功,返回城市历史每日天气。

JSON
{
  "city": "北京市",
  "adcode": "110000",
  "start_date": "2026-05-01",
  "end_date": "2026-05-31",
  "days": [
    {
      "date": "2026-05-01",
      "weather": "小雨",
      "temp_max": 24,
      "temp_min": 15,
      "rained": true,
      "rain": 3.6
    }
  ]
}

400 / 错误的请求

参数错误,例如日期格式不正确或 lang 不是 zh/en。

404 / 未找到

未找到城市位置。

502 / 网关错误

服务暂时不可用,请稍后重试。

查询历史天气免费API接口 - 稳定可靠 | UAPI开发者平台 | UAPI