<div align=center
</br>
# Ozon3
[](https://badge.fury.io/py/ozon3) <a href="CONTRIBUTING.md#pull-requests"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome"></a>  [](https://github.com/Ozon3Org/Ozon3/actions/workflows/pages/pages-build-deployment) [](https://github.com/Ozon3Org/Ozon3/actions/workflows/dependency-review.yml) [](https://github.com/Ozon3Org/Ozon3/actions/workflows/test.yml) [](https://codecov.io/github/Ozon3Org/Ozon3)
[](https://www.buymeacoffee.com/MilindSharma)
## The simplest AQI API
</div>
Getting air quality data with Python should be easy and straightforward - and that's exactly what Ozon3 can help you with.
With Ozon3, just 4 lines of code are enough to get you the data you need. And the best part is that you can trust this data to be accurate and reliable, since the package uses the World Air Quality Index's API under the hood! ✅ 📈
Use Ozon3 to **get real-time air quality data, or historical data from 2014 onwards**, and fetch air quality data **for anywhere in the world** in seconds.
_You can view our complete documentation [here](https://Ozon3Org.github.io/Ozon3/)_
_Don't forget to star Ozon3 repository if you found it helpful_
#### Table of Contents
[Install ozon3](#install-it-here)
[Getting your API token](#getting-your-api-token)
[Getting started](#getting-started)
[Contributing and submitting PR's](#contributing-and-submitting-pull-requests)
[Semantic Versioning System](#semantic-versioning-system)
[Attributions](#world-air-quality-index-and-epa-attribution)
[License and TOS](#license-and-terms-of-service)
[Contributors](#contributors)
## Install it here!
```sh
pip install ozon3
```
You can find more information on the PyPI page for Ozon3 [here](https://pypi.org/project/ozon3/)
## Getting your API token
To use Ozon3, you must first request and get a your own unique API token 🎫. This is required to access for the underlying API to work 👮🏼♂️.
This is very easy to do, and takes no time at all as your token is generally emailed to you instantly.
Get your token [here](https://aqicn.org/data-platform/token/#/)!
## Getting started
### Real-time data
```python
import ozon3 as ooo
o3 = ooo.Ozon3('YOUR_PRIVATE_TOKEN')
data = o3.get_city_air('New Delhi')
```
for many cities:
```python
data = o3.get_multiple_city_air(['London', 'Hong Kong', 'New York']) # As many locations as you need
```
### Historical data
```python
data = o3.get_historical_data(city='Houston') # data from 2014 onwards!
```
<hr>
### Examples In Action 🎬
### Air Quality Parameters
Ozon3 can fetch the following parameters:
* `aqi`: air quality index, a measurement of air quality that tells you how clean or polluted the air is. It is measured in micrograms per cubic meter (µg/m3).
* `pm25`: fine particulate matter, a measure of 2.5 micrometers or smaller particles in the air. It is measured in micrograms per cubic meter (µg/m3).
* `pm10`: respirable particulate matter, a measure of 10 micrometers or smaller particles in the air. It is measured in micrograms per cubic meter (µg/m3).
* `o3`: a measure of ground level ozon3 concentrations in the air. It is measured in parts per billion (ppb).
* `co`: a measure of carbon monoxide concentrations in the air. It is measured in parts per billion (ppb).
* `no2`: a measure of nitrogen dioxide concentrations in the air. It is measured in parts per billion (ppb).
* `so2`: a measure of sulfur dioxide concentrations in the air. It is measured in parts per billion (ppb).
* `dew`: dew point, the temperature the air needs to be cooled to in order to reach 100% relative humidity. It is measured in Celsius (°C) or Fahrenheit (°F).
* `h`: relative humidity, a measure of moisture in the atmosphere. It does not have a standard unit of measurement.
* `p`: atmospheric pressure, a measure of the weight of atoms and molecules that make up the layers in the atmosphere. It is measured in Pascal (Pa).
* `t`: temperature, a measure of thermal energy in one or a combined substance at a given time. It is measured in Celsius (°C) or Fahrenheit (°F).
* `w`: wind speed, a measure of air in motion. It is measured in kilometers per hour (km/h)
Sample output:
<img width="1065" alt="blehblhe" src="./src/media/sample-output.png">
## Contributing and submitting Pull requests
**We love PR's!**
Take a look at the [CONTRIBUTING.md](https://github.com/Ozon3Org/Ozon3/blob/main/CONTRIBUTING.md) file for details on how to go about this!
## Semantic Versioning System
Ozon3 uses a semantic versioning system to increment its release version number. Using this model, changes in version numbers can help indicate the meaning of modified code for each version.
See more information on semantic versioning [here](https://github.com/Ozon3Org/Ozon3/discussions/26).
## World Air Quality Index and EPA attribution
This package is a wrapper around an API provided by the World Air Quality Index project. Without them as well as the US EPA, Ozon3 would not exist. Please consider visiting the WAQI website and contributing to their project if you have time:
[World Air Quality Index](https://aqicn.org/contact/)
[United States Environmental Protection Agency](https://www.epa.gov/aboutepa)
## LICENSE and Terms of Services 📰
1. Ozon3 is licensed under the GNU GENERAL PUBLIC LICENSE v3.0, and so it cannot be used for closed-source software or for monetary gain.
2. The WAQI API, which Ozon3 uses to provide data, has it's own [Acceptable Usage Policy](https://aqicn.org/api/tos/). Please refer to it for more details.
## Contributors
Contributions of any kind are welcome! These are our amazing contributors :)
<a href="https://github.com/Ozon3Org/Ozon3/graphs/contributors">
<img src="https://contrib.rocks/image?repo=Ozon3Org/Ozon3" />
</a>
Enjoy using Ozon3!
🥳 🍾 🚀
#### _Created by [Milind Sharma](https://github.com/Milind220)_
Raw data
{
"_id": null,
"home_page": "https://github.com/Ozon3Org/Ozon3",
"name": "ozon3",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "aqi,air quality,world air quality,api,open source",
"author": "Milind Sharma",
"author_email": "milindsharma8@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/78/89/8cae1ed5e7b0ec5ae639a681fe6ac5ee28953e51da859d607bc88a8104e9/ozon3-4.0.2.tar.gz",
"platform": null,
"description": "\n\n<div align=center\n\n</br>\n\n# Ozon3\n\n\n\n[](https://badge.fury.io/py/ozon3) <a href=\"CONTRIBUTING.md#pull-requests\"><img src=\"https://img.shields.io/badge/PRs-welcome-brightgreen.svg\" alt=\"PRs Welcome\"></a>  [](https://github.com/Ozon3Org/Ozon3/actions/workflows/pages/pages-build-deployment) [](https://github.com/Ozon3Org/Ozon3/actions/workflows/dependency-review.yml) [](https://github.com/Ozon3Org/Ozon3/actions/workflows/test.yml) [](https://codecov.io/github/Ozon3Org/Ozon3)\n[](https://www.buymeacoffee.com/MilindSharma)\n\n## The simplest AQI API\n\n</div>\n\nGetting air quality data with Python should be easy and straightforward - and that's exactly what Ozon3 can help you with.\nWith Ozon3, just 4 lines of code are enough to get you the data you need. And the best part is that you can trust this data to be accurate and reliable, since the package uses the World Air Quality Index's API under the hood! \u2705 \ud83d\udcc8\n\nUse Ozon3 to **get real-time air quality data, or historical data from 2014 onwards**, and fetch air quality data **for anywhere in the world** in seconds.\n\n\n\n_You can view our complete documentation [here](https://Ozon3Org.github.io/Ozon3/)_\n\n_Don't forget to star Ozon3 repository if you found it helpful_\n\n#### Table of Contents\n\n[Install ozon3](#install-it-here)\n\n[Getting your API token](#getting-your-api-token)\n\n[Getting started](#getting-started)\n\n[Contributing and submitting PR's](#contributing-and-submitting-pull-requests)\n\n[Semantic Versioning System](#semantic-versioning-system)\n\n[Attributions](#world-air-quality-index-and-epa-attribution)\n\n[License and TOS](#license-and-terms-of-service)\n\n[Contributors](#contributors)\n\n## Install it here!\n\n```sh\npip install ozon3\n```\n\nYou can find more information on the PyPI page for Ozon3 [here](https://pypi.org/project/ozon3/)\n\n## Getting your API token\n\nTo use Ozon3, you must first request and get a your own unique API token \ud83c\udfab. This is required to access for the underlying API to work \ud83d\udc6e\ud83c\udffc\u200d\u2642\ufe0f.\n\nThis is very easy to do, and takes no time at all as your token is generally emailed to you instantly.\n\nGet your token [here](https://aqicn.org/data-platform/token/#/)!\n\n## Getting started\n\n### Real-time data\n```python\nimport ozon3 as ooo\n\no3 = ooo.Ozon3('YOUR_PRIVATE_TOKEN')\ndata = o3.get_city_air('New Delhi')\n```\n\nfor many cities:\n\n```python\ndata = o3.get_multiple_city_air(['London', 'Hong Kong', 'New York']) # As many locations as you need\n```\n\n### Historical data\n\n```python\ndata = o3.get_historical_data(city='Houston') # data from 2014 onwards!\n```\n\n<hr>\n\n### Examples In Action \ud83c\udfac\n\n\n\n\n\n### Air Quality Parameters\n\nOzon3 can fetch the following parameters:\n\n * `aqi`: air quality index, a measurement of air quality that tells you how clean or polluted the air is. It is measured in micrograms per cubic meter (\u00b5g/m3).\n * `pm25`: fine particulate matter, a measure of 2.5 micrometers or smaller particles in the air. It is measured in micrograms per cubic meter (\u00b5g/m3).\n * `pm10`: respirable particulate matter, a measure of 10 micrometers or smaller particles in the air. It is measured in micrograms per cubic meter (\u00b5g/m3).\n * `o3`: a measure of ground level ozon3 concentrations in the air. It is measured in parts per billion (ppb).\n * `co`: a measure of carbon monoxide concentrations in the air. It is measured in parts per billion (ppb).\n * `no2`: a measure of nitrogen dioxide concentrations in the air. It is measured in parts per billion (ppb).\n * `so2`: a measure of sulfur dioxide concentrations in the air. It is measured in parts per billion (ppb).\n * `dew`: dew point, the temperature the air needs to be cooled to in order to reach 100% relative humidity. It is measured in Celsius (\u00b0C) or Fahrenheit (\u00b0F).\n * `h`: relative humidity, a measure of moisture in the atmosphere. It does not have a standard unit of measurement.\n * `p`: atmospheric pressure, a measure of the weight of atoms and molecules that make up the layers in the atmosphere. It is measured in Pascal (Pa).\n * `t`: temperature, a measure of thermal energy in one or a combined substance at a given time. It is measured in Celsius (\u00b0C) or Fahrenheit (\u00b0F).\n * `w`: wind speed, a measure of air in motion. It is measured in kilometers per hour (km/h)\n\nSample output:\n<img width=\"1065\" alt=\"blehblhe\" src=\"./src/media/sample-output.png\">\n\n## Contributing and submitting Pull requests\n\n**We love PR's!**\n\nTake a look at the [CONTRIBUTING.md](https://github.com/Ozon3Org/Ozon3/blob/main/CONTRIBUTING.md) file for details on how to go about this!\n\n## Semantic Versioning System\n\nOzon3 uses a semantic versioning system to increment its release version number. Using this model, changes in version numbers can help indicate the meaning of modified code for each version.\n\nSee more information on semantic versioning [here](https://github.com/Ozon3Org/Ozon3/discussions/26).\n\n## World Air Quality Index and EPA attribution\n\nThis package is a wrapper around an API provided by the World Air Quality Index project. Without them as well as the US EPA, Ozon3 would not exist. Please consider visiting the WAQI website and contributing to their project if you have time:\n\n[World Air Quality Index](https://aqicn.org/contact/)\n\n[United States Environmental Protection Agency](https://www.epa.gov/aboutepa)\n\n## LICENSE and Terms of Services \ud83d\udcf0\n\n1. Ozon3 is licensed under the GNU GENERAL PUBLIC LICENSE v3.0, and so it cannot be used for closed-source software or for monetary gain.\n2. The WAQI API, which Ozon3 uses to provide data, has it's own [Acceptable Usage Policy](https://aqicn.org/api/tos/). Please refer to it for more details.\n\n## Contributors\n\nContributions of any kind are welcome! These are our amazing contributors :)\n\n<a href=\"https://github.com/Ozon3Org/Ozon3/graphs/contributors\">\n <img src=\"https://contrib.rocks/image?repo=Ozon3Org/Ozon3\" />\n</a>\n\nEnjoy using Ozon3!\n\ud83e\udd73 \ud83c\udf7e \ud83d\ude80\n\n#### _Created by [Milind Sharma](https://github.com/Milind220)_\n",
"bugtrack_url": null,
"license": "GPLv3+",
"summary": "An open-source package to easily obtain real-time, historical,or forecasted air quality data for anywhere in the world. Reliable,accurate and simple.",
"version": "4.0.2",
"split_keywords": [
"aqi",
"air quality",
"world air quality",
"api",
"open source"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4c571a825ac7f4ea1fcb93a12a7bfd02388339cf3c4ba562b8bc909c39a82be5",
"md5": "1434d06d0df84889b567c6516ac97dae",
"sha256": "bc8a340e691dca7e4271d1a64e91ccee38df76b9391827fd5cf2b80bf0ac3f9e"
},
"downloads": -1,
"filename": "ozon3-4.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1434d06d0df84889b567c6516ac97dae",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 27818,
"upload_time": "2023-02-01T04:22:25",
"upload_time_iso_8601": "2023-02-01T04:22:25.638452Z",
"url": "https://files.pythonhosted.org/packages/4c/57/1a825ac7f4ea1fcb93a12a7bfd02388339cf3c4ba562b8bc909c39a82be5/ozon3-4.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "78898cae1ed5e7b0ec5ae639a681fe6ac5ee28953e51da859d607bc88a8104e9",
"md5": "9ba681da00464cc60b7a055edfecea2a",
"sha256": "cc1915ca9229663146ab00d0ee5073c2bb0c4e1b2d7650447ea4f6a97c9a8ac0"
},
"downloads": -1,
"filename": "ozon3-4.0.2.tar.gz",
"has_sig": false,
"md5_digest": "9ba681da00464cc60b7a055edfecea2a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 29879,
"upload_time": "2023-02-01T04:22:26",
"upload_time_iso_8601": "2023-02-01T04:22:26.831568Z",
"url": "https://files.pythonhosted.org/packages/78/89/8cae1ed5e7b0ec5ae639a681fe6ac5ee28953e51da859d607bc88a8104e9/ozon3-4.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-02-01 04:22:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "Ozon3Org",
"github_project": "Ozon3",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "ozon3"
}
JSON
