Metadata-Version: 2.1
Name: owm2json
Version: 0.1.89
Summary: Python module for getting several of OpenWeatherMap API at once
Home-page: https://github.com/viktak/owm2json
Author: @viktak
Author-email: owm2json@viktak.com
License: UNKNOWN
Project-URL: Bug Tracker, https://github.com/viktak/owm2json/issues
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown

![GitHub](https://img.shields.io/github/license/viktak/owm2json) ![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/viktak/owm2json) ![PyPI](https://img.shields.io/pypi/v/owm2json) ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/owm2json) ![PyPI - Format](https://img.shields.io/pypi/format/owm2json)  ![GitHub Repo stars](https://img.shields.io/github/stars/viktak/owm2json?style=social)

# owm2json package

Owm2json is a Python library for combining multiple OpenWeatherMap API calls into one.

## Installation

Use the package manager [pip](https://pip.pypa.io/en/stable/) to install owm2json.

```bash
pip install owm2json
```

## Usage

```python
import owm2json
apinames = ["air_pollution", "roadrisk"]
myOWM = owm2json.owmRequestor(apinames, latitude, longitude, appid)
print(myOWM.GetData())
```

### Explanation
`apinames`: a list of APIs to call. The full list can be seen on the official [OpenWeatherMap web site](https://openweathermap.org/api).<br>
`latitude`, `longitude`: coordinates of the desired location.<br>
`appid`: API key to use with the service. You can obtain yours at [OpenWeatherMap](https://home.openweathermap.org/api_keys)

If the call is successful, `owm2json` returns a string that contains a concatenated version of all the API calls that were requested. It also contains version information about itself.

Sample response from `owm2json`:
```json
{
    "module": {
        "version": "0.1.86"
    },
    "air_pollution": {
        "coord": {
            "lon": 12.34,
            "lat": 12.34
        },
        "list": [{
            "main": {
                "aqi": 2
            },
            "components": {
                "co": 216.96,
                "no": 0.36,
                "no2": 2.49,
                "o3": 98.71,
                "so2": 5.19,
                "pm2_5": 5.18,
                "pm10": 5.46,
                "nh3": 0.33
            },
            "dt": 1617289200
        }]
    },
    "roadrisk": {
        "message": "Please use POST request according to the documentation https://openweathermap.org/api/road-risk"
    }
}
```

## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

## License
[GNU General Public License v3.0](https://choosealicense.com/licenses/gpl-3.0/)


