Skip to main content

A package to get air quality data using the WAQI API

Project description

Ozone

PyPI version PRs Welcome GitHub

The simplest AQI API!

I want to make it easy to get your hands on accurate air quality data for your project, whatever it is. Ozone makes this as straightforward as typing out a few lines of code. Ozone uses the World Air Quality Index's API to fetch data, so you can trust the data you get to be accurate and reliable.

Table of Contents

Install ozon3

Getting your API token

Getting started

Contributing and submitting PR's

Attributions

License and TOS

Install it here!

pip install ozon3

Getting your API token

To use Ozone, 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!

Getting started

import ozone as ooo

o3 = ooo.Ozone('YOUR_PRIVATE_TOKEN')
data = o3.get_city_air('CITY_NAME')

for many cities:

data = o3.get_multiple_city_air([ARRAY OF CITY NAMES])

Examples In Action

Gif of ozone.get_city_air()

Gif of ozone.get_multiple_city_air()

Contributing and submitting Pull requests

We love PR's!

Take a look at the CONTRIBUTING.md file for details on how to go about this!

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, Ozone would not exist. Please consider visiting the WAQI website and contributing to their project if you have time:

World Air Quality Index

United States Environmental Protection Agency

LICENSE and Terms of Services

  1. Ozone 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 Ozone usees to provide data, has it's own Acceptable Usage Policy. Please refer to it for more details.

Enjoy using Ozone!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ozon3-1.2.2.tar.gz (19.0 kB view hashes)

Uploaded Source

Built Distribution

ozon3-1.2.2-py3-none-any.whl (19.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page