- 天气预报查询:支持全国以及全球多个城市的天气查询,包含15天天气预报查询。
返回示例:
{
“status”: 0,
“result”: {
“location”: {
“areacode”: “JPN10041001001”, //城市ID
“name”: “足立区”, //城市中文名
“country”: “日本”, //所属国家中文名
“path”: “足立区,足立区,东京都,日本” //行政区划路径
},
“realtime”: {
“text”: “多云”, //天气现象,string类型
“code”: “01”, //天气现象编码,string类型
“temp”: 6.5, //气温,单位℃,double类型
“feels_like”: 6, //体感温度,单位℃,int类型
“rh”: 38, //相对湿度,单位%,int类型
“wind_class”: “2级”, //蒲福氏风级,string类型
“wind_speed”: 2.5, //风速,单位m/s,double类型
“wind_dir”: “南风”, //风向,string类型
“wind_angle”: 187, //风向角度,0表示正北,180表示正南,int类型
“prec”: 0.0, //过去1小时降水量,单位毫米(mm),double类型
“prec_time”: “2021-03-05 18:00:00”, //过去1小时降水量所对应的时间段
“clouds”: 99, //云量,单位%,int类型
“vis”: 12085, //能见度,单位米(m),int类型
“pressure”: 1020, //气压,单位百帕(hPa),int类型
“dew”: -6, //露点温度,单位℃,int类型
“uv”: 2, //紫外线指数,int类型
“snow”: 0.0, //降雪量,单位厘米(cm),double类型 #国内城市不支持#
“weight”: 0, //文案权重,int类型
“brief”: “今日惊蛰”, //天气短文案,string类型
“detail”: “今日惊蛰,春雷惊百虫”, //天气长文案 ,string类型
},
“last_update”: “2021-03-05 19:07:44” //数据更新时间(北京时间)
}
}
- 空气质量查询: 支持国内3400+个城市的整点观测,获取指定城市的整点观测空气质量。
返回示例:
{
"status": 0,
"result": {
"location": {
"areacode": "101010100", //城市ID
"name": "北京", //城市中文名
"country": "中国", //所属国家中文名
"path": "北京,北京市,北京市,中国" //行政区划路径
},
"realtimeAqi": {
"aqi": 124, //空气质量指数
"aqi_level": "轻度污染", //空气质量等级
"pm10": 59, //PM10浓度,单位: 微克/立方米
"pm25": 94, //PM2.5浓度,单位: 微克/立方米
"no2": 18, //二氧化氮浓度,单位: 微克/立方米
"so2": 3, //二氧化硫浓度,单位: 微克/立方米
"co": 1.0, //一氧化碳浓度,单位: 毫克/立方米
"o3": 36, //臭氧浓度,单位: 微克/立方米
"pollutant": "一氧化碳", //首要污染物,有时为空
"data_time": "2020-02-14 09:00:00", //实况数据时间
"stations": [
{
"stationID": "1011A", //站点编号
"lon": 116.73, //站点经度
"lat": 39.68, //站点纬度
"name": "永定门", //站点名称
"aqi": 68, //实时空气质量指数
"aqi_level": "良", //空气质量等级
"pm10": 0, //PM10浓度,单位: 微克/立方米
"pm25": 49, //PM2.5浓度,单位: 微克/立方米
"no2": 27, //二氧化氮浓度,单位: 微克/立方米
"so2": 2, //二氧化硫浓度,单位: 微克/立方米
"co": 1.0, //一氧化碳浓度,单位: 毫克/立方米
"o3": 30, //臭氧浓度,单位: 微克/立方米
"pollutant": "细颗粒物(PM2.5)", //首要污染物,有时为空
},
…… //其它站点实况信息
]
}
"last_update": "2020-02-14 09:44:00", //数据更新时间
}
}
- 分钟级降水预报:支持输入经纬度查询,可准确提醒下一场雨何时出现,何时变大,何时停止等预报信息。
返回示例:
{
“status”: 0,
“result”: {
“startTime”: “2020-03-25 09:07”, //预报开始时间(北京时间) ,未来两小时无降水时为空
“endTime”: “2020-03-25 11:07”, //预报结束时间(北京时间) ,未来两小时无降水时为空
“series”: [
1.22,
1.16,
0.45,
0.3,
0.1,
0.0,
…
], //逐分钟雨强预测,单位毫米/小时(mm/h),未来两小时无降水时为空
“text”: “小雨”, //实时天气
“code”: “07”, //实时天气编码
“msg”: “约5分钟后雨停,之后也不会下了” //短临预报描述,string类型
}
}
//无雷达覆盖区域的返回结果
{
“status”:41,
“message”:”当前位置无气象雷达观测数据覆盖”
}
- 历史天气预报:可查询国内指定城市的历史天气预报数据,最长可查询至2018年1月1日。目前支持3400+国内城市的历史预报数据查询,同时也支持国内任意经纬度查询。
返回示例:
{
"status": 0,
"result": {
"location": {
"areacode": "101010100", //城市ID
"name": "北京", //城市中文名
"country": "中国", //所属国家
"path": "北京,北京市,北京市,中国" //行政区划分路径
},
"hisWeather": [{
"text_day": "晴", //白天天气现象
"code_day": "00", //白天天气现象编码
"text_night": "多云", //夜间天气现象
"code_night": "01", //夜间天气现象编码
"high": 38, //日最高气温,单位℃
"low": 25, //日最低气温,单位℃
"wc_day": "3~4级", //白天风力级别
"wd_day": "西南风", //白天风向
"wc_night": "<3级", //夜间风力级别
"wd_night": "南风", //夜间风向
"date": "2023-07-01", //日期(当地时间)
"week": "星期三" //星期
}]
}
}
- 日出日落:获取指定城市/地点每日日出时间、日落时间。
返回示例:
{
"status": 0,
"result": {
"location": {
"areacode": "101010100", //城市ID
"name": "北京", //城市中文名
"country": "中国", //所属国家中文名
"path": "北京,北京市,北京市,中国" //行政区划路径
},
"sunrises": [
{
"sunrise": "06:52", //日出时间(当地时间)
"sunset": "18:03", //日落时间(当地时间)
"data_time": "2020-02-27" //预报日期(当地时间)
},
…… //其它日期日出日落信息
]
}
}