为超过 100 万开发者提供专业的 API 服务,所有 API 均提供免费的服务

天气环境类API接口推荐,附返回示例

  • 天气预报查询:支持全国以及全球多个城市的天气查询,包含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"        //预报日期(当地时间)
            },
                ……                              //其它日期日出日落信息
        ]
    }
}

Last Updated on 2023-08-10 by admin