接口介绍
更人性化的天气接口, 可查询自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",
"so2": "36",
"co": "1",
"sunrise": "07:23",
"sunset": "17:05",
"moonrise": "13:35",
"moonset": "03:00",
"moonIcon": "WXG",
"uv": "2",
"cloudPct": "37",
"precipPct": "1",
"wea_day_img": "yun",
"wea_night_img": "yun"
},
{
"date": "2023-01-03",
"wea_day": "多云",
"wea_night": "晴",
"tem_day": "7",
"tem_night": "-3",
"humidity": "56",
"visibility": "4",
"pressure": "1012",
"win": "西北风转南风",
"win_speed": "<3级",
"win_meter": "4",
"air": "175",
"pm25": "132",
"pm10": "190",
"o3": "6",
"no2": "74",
"so2": "36",
"co": "1",
"sunrise": "07:23",
"sunset": "17:06",
"moonrise": "14:07",
"moonset": "04:02",
"moonIcon": "WXG",
"uv": "2",
"cloudPct": "0",
"precipPct": "1",
"wea_day_img": "yun",
"wea_night_img": "qing"
},
{
"date": "2023-01-04",
"wea_day": "多云",
"wea_night": "多云",
"tem_day": "7",
"tem_night": "0",
"humidity": "56",
"visibility": "4",
"pressure": "1009",
"win": "北风转南风",
"win_speed": "<3级",
"win_meter": "2",
"air": "138",
"pm25": "105",
"pm10": "142",
"o3": "90",
"no2": "35",
"so2": "10",
"co": "0",
"sunrise": "07:23",
"sunset": "17:07",
"moonrise": "14:45",
"moonset": "05:04",
"moonIcon": "WXG",
"uv": "2",
"cloudPct": "68",
"precipPct": "3",
"wea_day_img": "yun",
"wea_night_img": "yun"
},
{
"date": "2023-01-05",
"wea_day": "多云",
"wea_night": "晴",
"tem_day": "9",
"tem_night": "0",
"humidity": "75",
"visibility": "2",
"pressure": "1009",
"win": "南风",
"win_speed": "<3级转3-4级",
"win_meter": "4",
"air": "228",
"pm25": "178",
"pm10": "232",
"o3": "2",
"no2": "80",
"so2": "11",
"co": "1",
"sunrise": "07:24",
"sunset": "17:08",
"moonrise": "15:29",
"moonset": "06:04",
"moonIcon": "WXG",
"uv": "2",
"cloudPct": "70",
"precipPct": "3",
"wea_day_img": "yun",
"wea_night_img": "qing"
},
{
"date": "2023-01-06",
"wea_day": "晴",
"wea_night": "晴",
"tem_day": "10",
"tem_night": "0",
"humidity": "45",
"visibility": "2",
"pressure": "1003",
"win": "西北风转南风",
"win_speed": "3-4级转<3级",
"win_meter": "8",
"air": "235",
"pm25": "185",
"pm10": "234",
"o3": "118",
"no2": "40",
"so2": "10",
"co": "1",
"sunrise": "07:24",
"sunset": "17:09",
"moonrise": "16:19",
"moonset": "06:59",
"moonIcon": "F",
"uv": "2",
"cloudPct": "17",
"precipPct": "1",
"wea_day_img": "qing",
"wea_night_img": "qing"
},
{
"date": "2023-01-07",
"wea_day": "晴",
"wea_night": "晴",
"tem_day": "13",
"tem_night": "5",
"humidity": "29",
"visibility": "21",
"pressure": "1001",
"win": "南风",
"win_speed": "3-4级转4-5级",
"win_meter": "8",
"air": "75",
"pm25": "24",
"pm10": "100",
"o3": "6",
"no2": "52",
"so2": "7",
"co": "0",
"sunrise": "07:24",
"sunset": "17:10",
"moonrise": "17:14",
"moonset": "07:49",
"moonIcon": "F",
"uv": "2",
"cloudPct": "8",
"precipPct": "0",
"wea_day_img": "qing",
"wea_night_img": "qing"
},
{
"date": "2023-01-08",
"wea_day": "晴",
"wea_night": "晴",
"tem_day": "12",
"tem_night": "1",
"humidity": "51",
"visibility": "4",
"pressure": "998",
"win": "北风",
"win_speed": "<3级转3-4级",
"win_meter": "4",
"air": "195",
"pm25": "147",
"pm10": "276",
"o3": "6",
"no2": "104",
"so2": "37",
"co": "2",
"sunrise": "07:24",
"sunset": "17:10",
"moonrise": "18:12",
"moonset": "08:31",
"moonIcon": "WNG",
"uv": "2",
"cloudPct": "25",
"precipPct": "2",
"wea_day_img": "qing",
"wea_night_img": "qing"
},
{
"date": "2023-01-09",
"wea_day": "晴",
"wea_night": "晴",
"tem_day": "9",
"tem_night": "-2",
"humidity": "45",
"visibility": "11",
"pressure": "1008",
"win": "东北风",
"win_speed": "3-4级转<3级",
"win_meter": "11",
"air": "102",
"pm25": "76",
"pm10": "139",
"o3": "11",
"no2": "56",
"so2": "20",
"co": "1",
"sunrise": "07:24",
"sunset": "17:11",
"moonrise": "19:12",
"moonset": "09:08",
"moonIcon": "WNG",
"uv": "2",
"cloudPct": "24",
"precipPct": "2",
"wea_day_img": "qing",
"wea_night_img": "qing"
},
{
"date": "2023-01-10",
"wea_day": "晴",
"wea_night": "晴",
"tem_day": "10",
"tem_night": "0",
"humidity": "30",
"visibility": "30",
"pressure": "1010",
"win": "南风",
"win_speed": "<3级转3-4级",
"win_meter": "6",
"air": "24",
"pm25": "5",
"pm10": "22",
"o3": "36",
"no2": "47",
"so2": "6",
"co": "0",
"sunrise": "07:24",
"sunset": "17:12",
"moonrise": "20:11",
"moonset": "09:40",
"moonIcon": "WNG",
"uv": "2",
"cloudPct": "4",
"precipPct": "0",
"wea_day_img": "qing",
"wea_night_img": "qing"
}
]
}
小结
这个接口是收费的,可以免费测试3000次,正式环境使用需要购买,如有需要请打开主域名官网下单。