接口介绍
更人性化的天气接口, 可查询自2023年1月1日至今日的所有历史天气数据, 可查询某一天、某个日期区间、某月, 总体来说参数非常灵活, 非常方便开发对接。
返回字段包含:白天天气、夜间天气、高温(白天天气)、低温(夜间天气)、湿度、能见度、气压、风向(白天到夜间)、风力(白天到夜间)、风速km/h、空气质量数值、pm2.5、pm10、o3、no2、so2、co、日出时间、日落时间、月初时间、月落时间、月相、紫外线、云量、降雨量。
请求参数
参数名 | 必选 | 类型 | 说明 | 备注(示例) |
---|---|---|---|---|
appid | True | string | 用户appid | 注册开发账号 |
appsecret | True | String | 用户appsecret | |
cityid | True | String | 城市ID | 请参考 城市ID列表 |
year | False | Int | 年份 | 如: 2015 |
month | False | Int | 月份 | 如: 5 |
date | False | String | 根据日期区间查询 | 如: 2023-01-01_2023-01-15,用下划线分割。如果只查询某天,只传当前日期即可,带下划线会理解为区间查询 |
查询某个月
查询比如2023年10月的历史数据
需要提交查询的城市ID和查询的年、月
http://gfeljm.tianqiapi.com/free/history?appid=43656176&appsecret=I42og6Lm&cityid=101120101&year=2023&month=10
查询某一天
查询比如 2023年10月1日 的天气
需要提交查询的城市ID和查询的日期
http://gfeljm.tianqiapi.com/free/history?appid=43656176&appsecret=I42og6Lm&cityid=101120101&date=2023-10-01
查询日期区间
查询比如 2023年10月1日至 2023年10月15日 的天气
需要提交查询的城市ID和查询的日期区间, 格式为:2023-01-01_2023-01-10
http://gfeljm.tianqiapi.com/free/history?appid=43656176&appsecret=I42og6Lm&cityid=101120101&date=2023-01-01_2023-01-10
返回数据JSON预览
{
"nums": 5,
"cityid": "101120101",
"days": 10,
"date_start": "2023-01-01",
"date_end": "2023-01-10",
"list": [
{
"date": "2023-01-01",
"wea_day": "多云",
"wea_night": "晴",
"tem_day": "8",
"tem_night": "-2",
"humidity": "52",
"visibility": "4",
"pressure": "1011",
"win": "西南风转南风",
"win_speed": "3-4级转<3级",
"win_meter": "6",
"air": "175",
"pm25": "132",
"pm10": "186",
"o3": "4",
"no2": "86",
"so2": "14",
"co": "1",
"sunrise": "07:23",
"sunset": "17:05",
"moonrise": "13:06",
"moonset": "01:57",
"moonIcon": "WXG",
"uv": "1",
"cloudPct": "88",
"precipPct": "1",
"wea_day_img": "yun",
"wea_night_img": "qing"
},
{
"date": "2023-01-02",
"wea_day": "多云",
"wea_night": "多云",
"tem_day": "9",
"tem_night": "-3",
"humidity": "31",
"visibility": "19",
"pressure": "1014",
"win": "东风转北风",
"win_speed": "<3级",
"win_meter": "5",
"air": "206",
"pm25": "156",
"pm10": "237",
"o3": "7",
"no2": "93",