PHPackages                             addapp/breezometer-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. addapp/breezometer-php

ActiveLibrary[Utility & Helpers](/categories/utility)

addapp/breezometer-php
======================

PHP client package for the Breezometer

1.0(11y ago)13.6k1MITPHPPHP >=5.4.0

Since Apr 2Pushed 10y ago11 watchersCompare

[ Source](https://github.com/addappio/breezometer-php)[ Packagist](https://packagist.org/packages/addapp/breezometer-php)[ Docs](https://github.com/addappio/Breezometer)[ RSS](/packages/addapp-breezometer-php/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

Breezometer php
===============

[](#breezometer-php)

[![Latest Version](https://camo.githubusercontent.com/f7fc6cdacb5477e7814d3db6a693549d556f34c1338ad90b88b89ac0ca4833c7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f616464617070696f2f627265657a6f6d657465722d7068702e7376673f7374796c653d666c61742d737175617265)](https://github.com/addappio/breezometer-php/releases)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/6f5a9f558925527976443c21493e92213913ff4e1c262e931fe83e7a2614f5e8/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f616464617070696f2f627265657a6f6d657465722d7068702f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/addappio/breezometer-php)[![Coverage Status](https://camo.githubusercontent.com/36755cd553043ba4d4d63ef4953b5bdce38adb6c4a212b5547b2171132104153/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f616464617070696f2f627265657a6f6d657465722d7068702e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/addappio/breezometer-php/code-structure)[![Quality Score](https://camo.githubusercontent.com/22548f2a3de036e79bd784dae1b6e454d023cae87f2bb242addf3e1a801f63e6/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f616464617070696f2f627265657a6f6d657465722d7068702e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/addappio/breezometer-php)[![Total Downloads](https://camo.githubusercontent.com/657376b4ec09dcc25d666d022500e28ea4340f8e492f5764dfc7a71657b4a01a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6164646170702f627265657a6f6d657465722d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/addapp/breezometer-php)

A PHP client package for the [Breezometer](http://breezometer.com/) [API](http://breezometer.com/api/).

Want to use this inside a Laravel application? Check out the [Breezometer-Laravel](https://github.com/addappio/Breezometer-laravel) package.

Install
-------

[](#install)

Via Composer

```
$ composer require addapp/breezometer-php
```

Usage
-----

[](#usage)

```
$breezometer = new \Addapp\Breezometer\Breezometer('your_api_key');

$info = $breezometer->baqi('40.7324296', '-73.9977264');
// or
$info = $breezometer->baqi('40.7324296', '-73.9977264', '2015-06-17T11:11:21');
// or
$info = $breezometer->baqiFromLocation('New+York');
// or
$info = $breezometer->baqiFromLocation('New+York', '2015-06-17T11:11:21');
```

Will return something like :

```
{
   "country_name" :  "USA",
   "breezometer_aqi" :  49,
   "breezometer_color" :  "#FFF900",
   "breezometer_description" :  "Moderate Air Quality",
   "country_aqi" :  78,
   "country_color" :  "#FFF700",
   "country_description" :  "Moderate Air Quality",
   "data_valid" : true,
   "key_valid" : true,
   "random_recommendations" : {
         "children" :  "Pay attention to the respiratory status of your kid(s)",
         "sport" :  "You want to work out now??!… Only if you have no plan B",
         "health" :  "People with health sensitivities should be prepared for minor respiratory difficulties",
         "inside" :  "We're not going to tell you not to go outside, but you should continue tracking the air quality around you",
         "outside" :  "If you wish to stay outside for a long time, you should try to find a cleaner place nearby"
         },
   "dominant_pollutant_canonical_name" :  "nox",
   "dominant_pollutant_text" : {
         "main" :  "At the moment, nitrogen oxides (NOx) are the main pollutant in the air.",
         "effects" :  "Exposure may cause increased bronchial reactivity in patients with asthma, lung function decline in patients with COPD and increased risk of respiratory infections, especially in young children.",
         "causes" :  "Main sources are fuel burning processes in industry and transportation."
         }
}
```

Testing
-------

[](#testing)

```
$ phpunit
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Credits
-------

[](#credits)

- [Nicolas Widart](https://github.com/nWidart)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 89.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

4065d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/565946b8d70f5fa172a21f87b7f0e3abdce0611cc1cd300ec8e7b360bdb0a4bc?d=identicon)[nWidart](/maintainers/nWidart)

---

Top Contributors

[![nWidart](https://avatars.githubusercontent.com/u/882397?v=4)](https://github.com/nWidart "nWidart (33 commits)")[![henriquepedrosa](https://avatars.githubusercontent.com/u/2057502?v=4)](https://github.com/henriquepedrosa "henriquepedrosa (4 commits)")

---

Tags

phpairBreezometerPollution

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/addapp-breezometer-php/health.svg)

```
[![Health](https://phpackages.com/badges/addapp-breezometer-php/health.svg)](https://phpackages.com/packages/addapp-breezometer-php)
```

###  Alternatives

[stevebauman/location

Retrieve a user's location by their IP Address

1.3k7.6M65](/packages/stevebauman-location)[gehrisandro/tailwind-merge-laravel

TailwindMerge for Laravel merges multiple Tailwind CSS classes by automatically resolving conflicts between them

341682.2k18](/packages/gehrisandro-tailwind-merge-laravel)[amirbagh75/smsir-php

Unofficial sms.ir PHP Package

181.2k](/packages/amirbagh75-smsir-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)