**大陆重点城市空气质量历史数据库

声明：本项目提供的数据所有权权归原始方所有，在未获得所有方任何形式认可的情况下，请勿将本数据用作商业目的。本程序提供的数据仅用作参考，不做任何形式的承诺、担保以及负责。

数据源

目前基于中华人民共和国环境保护部信息中心等其他公共数据来源抓取并汇总而成，提供给网友作为当地空气质量的历史数据参考。~~如有其他的数据源，欢迎网友提供。~~

数据库

数据库使用 SQLite 数据格式，单一的压缩文件，方便随时调用以及嵌入。

字段说明

以下是 SQLite 的主要表的字段说明，省去索引部分说明。

sqlite> .schema
        -- 空气质量主数据表
CREATE TABLE aqi (
            ID INTEGER NOT NULL PRIMARY KEY,          
            division UNSIGNED BIG INT(10) NOT NULL,     - 行政编码
            areaName VARCHAR(12) DEFAULT NULL,          - 地区名
            value INTEGER NOT NULL,                     - 值
            pollutant INTEGER DEFAULT NULL,             - 污染类型
            recordDate DATE NOT NULL,                   - 记录时间
            _fetchDate DATE NOT NULL,                   - 抓取时间
            source VARCHAR(8) DEFAULT NULL              - 来源
        );
        -- 地区表
CREATE TABLE areas (
            ID INTEGER NOT NULL PRIMARY KEY,
            division UNSIGNED BIG INT(10) NOT NULL,     - 行政编码 
            name VARCHAR(12) NOT NULL,                  - 地区名
            engName VARCHAR(64),                        - 地区英文名
            pinyinName VARCHAR(64),                     - 地区中文拼音
            bottom BOOLEAN DEFAULT FALSE,               - 是否是最后一级地区
            superior UNSIGNED BIG INT(10)               - 上级地区编码，顶级为0
        );
        -- 污染类型表
CREATE TABLE pollutant (
            ID INTEGER NOT NULL PRIMARY KEY,
            name VARCHAR(32) NOT NULL                   - 污染类型名称
        );

扩展

扩展使用其他数据源

主要功能为继承 include/Base.inc.php 中的基类，同时编写对对应的代码，程序入口为 run 函数。为了方便管理，建议将抓取的对应类文件放到 fetcher 目录中。

参考 FetcherMep.inc.phps 的实例代码：

// 其中 DumpDataFromMep 基于 Base 函数
class FetcherMep extends DumpDataFromMep {
    public function run() {
        // 请求线上地址
        $this->getDateFromUrl($url);
        // ...
        // 插入到数据库
        $this->insertAqiData($item['division_id'], 
                      $item['value'], $item['record_date'], $item['pollutant'], 
                      $item['area_name'], self::FLAG_SOURCE);
    }
}

然后修改 fetcher.php 文件中需要执行的类加入到数组中：

$builders = array('FetcherMep');

它们就会顺序执行。

定时抓取

强烈建议使用 crontab 等工具定时抓取线上数据，可以考虑使用

$make fetch

方法，详细可以参见 Makefile 文件。

参考

http://en.wikipedia.org/wiki/Air_quality_index#Mainland_China
**大陆地区的行政区划参见 assets/area.json 文件，JSON 格式

空气质量指数(AQI)范围及相应的空气质量类别对应表

空气质量指数	空气质量状况	对健康影响情况	建议采取的措施
0~50	优	空气质量令人满意，基本无空气污染	各类人群可正常活动
51~100	良	空气质量可接受，但某些污染物可能对极少数异常敏感人群健康有较弱影响	极少数异常敏感人群应减少户外活动
101~150	轻度污染	易感人群症状有轻度加剧，健康人群出现刺激症状	儿童、老年人及心脏病、呼吸系统疾病患者应减少长时间、高强度的户外锻炼
151~200	度污染	进一步加剧易感人群症状，可能对健康人群心脏、呼吸系统有影响	儿童、老年人及心脏病、呼吸系统疾病患者避免长时间、高强度的户外锻炼，一般人群适量减少户外运动
201~300	重度污染	心脏病和肺病患者症状显著加剧，运动耐受力降低，健康人群普遍出现症状	儿童、老年人及心脏病、肺病患者应停留在室内，停止户外运动，一般人群减少户外运动
>300	严重污染	健康人群运动耐受力降低，有明显强烈症状，提前出现某些疾病	儿童、老年人和病人应停留在室内，避免体力消耗，一般人群避免户外活动

反馈&联系

Blog 介绍 http://www.gracecode.com/posts/mainland-china-aqi-database-download.html
Homepage https://github.com/feelinglucky/AQI
Twitter @feelinglucky
Weibo @手气还不错
Blog http://www.gracecode.com/
Email lucky[at]gracecode.com

alirong/AQI