waqi

世界空气质量指数API的简单PHP包装器

世界空气质量指数项目是一项旨在绘制全球当前和实时空气质量的计划。空气质量指数基于PM2.5，PM10，臭氧，NO2，SO2和CO小时测量，由世界各个监测站提供。

该软件包使您可以轻松地检索您所在地区的空气质量指数，并基于WAQI项目的实时空气质量数据提要（API）。

注意：要使用此软件包（以及基础AQI API），需要访问令牌。您可以在此处获取令牌：https：//aqicn.org/data-platform/token ..

系统要求

您需要php> = 8.2才能使用azuyalabs/waqi 。

安装

您可以通过Composer吸引此软件包：

composer require azuyalabs/waqi

用法

首先在您的项目中包括作曲家autoload文件：

 <?php
require ' vendor/autoload.php ' ;

使用您的AQI访问令牌，创建WAQI对象的实例：

 use Azuyalabs  WAQI  WAQI ;

$ waqi = new WAQI (<your access token>);

接下来，使用带有所需城市或监视站名称（例如纽约）的getObservationByStation方法。这将获得最新的空气质量观察：

 $ waqi -> getObservationByStation ( ' new york ' );

空气质量

如果一切顺利，请使用各种AP​​I方法获取有关所选城市或监视站检索到的空气质量指数的详细信息。

要获取AQI（空气质量指数），请使用方法getAQI ：

 $ waqi -> getAQI ();

这返回了一个阵列结构，该阵列结构包含在测量时在此监测站测量的空气质量指数。它包含4个元素：

• “ AQI”：AQI级别（由监视站的主要污染类型定义）
• “污染_level”：描述空气污染水平的叙述
• “ Health_implications”：描述与测量污染水平相关的健康影响的叙述
• “ withutionary_statement”：与测量污染水平相关的警示声明（仅适用于PM2.5）

示例输出（“纽约”）：

 - ' aqi ' : 15
 - ' pollution_level ' : Good
 - ' health_implications ' : Air quality is considered satisfactory, and air pollution poses little or no risk.
 - ' cautionary_statement ' : None

除了一般的空气质量信息外，还提供特定的污染物水平。请注意，并非每个监视站都捕获所有污染物类型，因此其中一些API功能可能会返回“ null”。

以下API功能可用于获取特定的污染物级别信息：

• getCO() ：返回测量时在监测站测量的一氧化碳（CO）水平。
• getNO2() ：返回测量时在监测站测量的二氧化氮（NO2）水平。
• getO3() ：返回测量时在监测站测量的臭氧（O3）水平。
• getSO2() ：返回测量时在监测站测量的二氧化硫（SO2）水平。
• getPM10() ：返回颗粒物的水平10微米或更低（PM10），在测量时在此监测站进行测量。
• getPM25() ：返回颗粒物物质的水平2.5微米或更低（PM2.5），在测量时在此监测站进行测量。

监视站

可以通过两种API方法获得有关监视站的信息。

首先，使用API​​方法getMonitoringStation() ，将返回有关给定监视站的信息：

• “ ID”：此监视站的唯一ID
• “名称”：此监视站的名称（或描述）
• “坐标”：该监控站的地理坐标（“经度”和“纬度”的数组）
• 'url'：此监视站的URL

其次，API方法getAttributions()将返回此监视站的EPA归因列表。

其他

提供其他信息的其他API方法是：

• getMeasurementTime() ：返回进行最后测量的日期/时间。 （作为DateTime对象）。
• getHumidity() ：返回测量时在此监测站测量的湿度（以％）。
• getTemperature() ：在测量时在此监测站测量的温度（以摄氏度为单位）。
• getPressure() ：返回测量时在此监测站测量的气压（以毫巴为单位）。
• getPrimaryPollutant() ：在测量时（例如'pm25'）返回此监视站的主要污染物的名称。

ChangElog

有关更多信息，请参阅ChangElog。

测试

此软件包带有Phpunit测试套件。要运行测试，请从项目目录运行以下命令：

composer test

，或者以：

vendor/bin/phpunit

贡献

鼓励和欢迎捐款；我总是很乐意在github上获得反馈或提取请求:)为错误和新功能创建GitHub问题，并对您感兴趣的问题进行评论。

如果您喜欢我正在制作的东西，非常感谢额外的咖啡:)。您的支持可以帮助我将更多时间投入到这样的开源软件项目中。

学分

• Sacha telgenhof
• 所有贡献者

执照

该软件包是根据MIT许可证许可的开源软件。请参阅许可证以获取更多信息。