空气质量指数API接口_免费数据接口

1、空气质量指数查询

接口地址：https://api.jisuapi.com/aqi/query

返回格式：JSON

请求方式：GET POST

请求示例：https://api.jisuapi.com/aqi/query?appkey=yourappkey&city=杭州

请求参数：

参数名称	类型	必填	说明
city	string	是	城市和城市ID任选一个
cityid	int	是	城市ID

返回参数：

参数名称	类型	说明
cityid	int	城市ID
city	string	城市
so2	string	二氧化硫1小时平均
so224	string	二氧化硫24小时平均
no2	string	二氧化氮1小时平均
no224	string	二氧化氮24小时平均
co	string	一氧化碳1小时平均 mg/m3
co24	string	一氧化碳24小时平均 mg/m3
o3	string	臭氧1小时平均
o38	string	臭氧8小时平均
o324	string	臭氧24小时平均
pm10	string	PM10 1小时平均
pm1024	string	PM10 24小时平均
pm2_5	string	PM2.5 1小时平均
pm2_524	string	PM2.5 24小时平均
iso2	string	二氧化硫指数
ino2	string	二氧化氮指数
ico	string	一氧化碳指数
io3	string	臭氧指数
io38	string	臭氧8小时指数
ipm10	string	PM10指数
ipm2_5	string	PM2.5指数
aqi	string	AQI指数
primarypollutant	string	首要污染物
quality	string	空气质量指数类别，有“优、良、轻度污染、中度污染、重度污染、严重污染”6类
timepoint	string	发布时间
aqiinfo	string	AQI指数信息
level	string	等级
color	string	指数颜色值
affect	string	对健康的影响
measure	string	建议采取的措施
position	string	监测点
positionname	string	监测点名称

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": {
        "cityid": "382",
        "city": "杭州",
        "so2": "12",
        "so224": "20",
        "no2": "80",
        "no224": "64",
        "co": "1.105",
        "co24": "0.924",
        "o3": "11",
        "o38": "11",
        "o324": "56",
        "pm10": "86",
        "pm1024": "78",
        "pm2_5": "60",
        "pm2_524": "52",
        "iso2": "4",
        "ino2": "40",
        "ico": "12",
        "io3": "4",
        "io38": "6",
        "ipm10": "64",
        "ipm2_5": "72",
        "aqi": "72",
        "primarypollutant": "PM2.5",
        "quality": "良",
        "timepoint": "2015-12-09 16:00:00",
        "aqiinfo": {
            "level": "二级",
            "color": "#FFFF00",
            "affect": "空气质量可接受，但某些污染物可能对极少数异常敏感人群健康有较弱影响",
            "measure": "极少数异常敏感人群应减少户外活动"
        },
        "position": [
            {
                "positionname": "滨江",
                "so2": "10",
                "so224": "25",
                "no2": "84",
                "no224": "75",
                "co": "1.324",
                "co24": "0.808",
                "o3": "4",
                "o38": "6",
                "o324": "45",
                "pm10": "112",
                "pm1024": "93",
                "pm2_5": "80",
                "pm2_524": "61",
                "iso2": "4",
                "ino2": "42",
                "ico": "14",
                "io3": "2",
                "io38": "3",
                "ipm10": "72",
                "ipm2_5": "83",
                "aqi": "107",
                "primarypollutant": "细颗粒物(PM2.5)",
                "quality": "轻度污染",
                "timepoint": "2015-12-09 16:00:00",
                "color": "#FF7E00"
            }
        ]
    }
}

2、历史空气质量指数查询

接口地址：https://api.jisuapi.com/aqi/history

返回格式：JSON

请求方式：GET POST

请求示例：https://api.jisuapi.com/aqi/history?appkey=yourappkey&city=杭州

请求参数：

参数名称	类型	必填	说明
city	string	是	城市和城市ID任选一个
cityid	int	是	城市ID
date	string	否	日期（最早 2015-01-01），默认当天

返回参数：

参数名称	类型	说明
cityid	int	城市ID
city	string	城市
hour	string	按小时指数
so2	string	二氧化硫1小时平均
so224	string	二氧化硫24小时平均
no2	string	二氧化氮1小时平均
no224	string	二氧化氮24小时平均
co	string	一氧化碳1小时平均 mg/m3
co24	string	一氧化碳24小时平均 mg/m3
o3	string	臭氧1小时平均
o38	string	臭氧8小时平均
o324	string	臭氧24小时平均
pm10	string	PM10 1小时平均
pm1024	string	PM10 24小时平均
pm2_5	string	PM2.5 1小时平均
pm2_524	string	PM2.5 24小时平均
iso2	string	二氧化硫指数
ino2	string	二氧化氮指数
ico	string	一氧化碳指数
io3	string	臭氧指数
io38	string	臭氧8小时指数
ipm10	string	PM10指数
ipm2_5	string	PM2.5指数
aqi	string	AQI指数
primarypollutant	string	首要污染物
quality	string	空气质量指数类别，有“优、良、轻度污染、中度污染、重度污染、严重污染”6类
timepoint	string	发布时间
color	string	指数颜色值
day	string	按日期指数
date	string	日期

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": {
        "cityid": "382",
        "city": "杭州",
        "hour": [
            {
                "so2": "12",
                "so224": "20",
                "no2": "80",
                "no224": "64",
                "co": "1.105",
                "co24": "0.924",
                "o3": "11",
                "o38": "11",
                "o324": "56",
                "pm10": "86",
                "pm1024": "78",
                "pm2_5": "60",
                "pm2_524": "52",
                "iso2": "4",
                "ino2": "40",
                "ico": "12",
                "io3": "4",
                "io38": "6",
                "ipm10": "64",
                "ipm2_5": "72",
                "aqi": "72",
                "primarypollutant": "PM2.5",
                "quality": "良",
                "timepoint": "2015-12-09 16:00:00",
                "color": "#FFFF00"
            }
        ],
        "day": [            
            {
                "cityid": "382",
                "so2": "22",
                "so224": "22",
                "no2": "62",
                "no224": "64",
                "co": "0.983",
                "co24": "1.022",
                "o3": "11",
                "o38": "14",
                "o324": "56",
                "pm10": "87",
                "pm1024": "98",
                "pm2_5": "56",
                "pm2_524": "66",
                "iso2": "8",
                "ino2": "31",
                "ico": "10",
                "io3": "4",
                "io38": "7",
                "ipm10": "74",
                "ipm2_5": "89",
                "aqi": "89",
                "primarypollutant": "PM2.5",
                "quality": "良",
                "date": "2015-12-09",
                "color": "#FFFF00"
            }
        ]
    }
}

3、获取城市

接口地址：https://api.jisuapi.com/aqi/city

返回格式：JSON

请求方式：GET

请求示例：https://api.jisuapi.com/aqi/city?appkey=yourappkey

请求参数：

参数名称	类型	必填	说明

返回参数：

参数名称	类型	说明
cityid	int	城市ID
city	string	城市

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": [
        {
            "cityid": "1",
            "city": "北京"
        },
        {
            "cityid": "24",
            "city": "上海"
        },
        {
            "cityid": "26",
            "city": "天津"
        },
        {
            "cityid": "31",
            "city": "重庆"
        },
        {
            "cityid": "35",
            "city": "安庆"
        },
        {
            "cityid": "36",
            "city": "蚌埠"
        },
        {
            "cityid": "38",
            "city": "池州"
        },
        {
            "cityid": "39",
            "city": "滁州"
        },
        {
            "cityid": "40",
            "city": "阜阳"
        },
        {
            "cityid": "41",
            "city": "淮北"
        },
        {
            "cityid": "42",
            "city": "淮南"
        }        
    ]
}

API错误码

代号	说明
201	城市和城市ID为空
202	城市不存在
210	没有信息

系统错误码

代号	说明
101	APPKEY为空或不存在
102	APPKEY已过期
103	APPKEY无请求此数据权限
104	请求超过次数限制
105	IP被禁止
106	IP请求超过限制
107	接口维护中
108	接口已停用

名称	权限	价格
免费套餐	100次	免费
Level2	3000次	135.00元
Level1	100000次	198.00元
Level3	6000次	260.00元
Level2	200000次	370.00元
Level4	10000次	420.00元
Level3	500000次	850.00元
Level4	1000000次	1500.00元