杂项

查询历史天气

0次调用
1 积分/次

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

功能概述

支持按 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

400 / 错误的请求

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

404 / 未找到

未找到城市位置。

502 / 网关错误

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