Skip to main content

Python bindings to multiple weather station vendor APIs

Project description

Multi Weather API

Consistent Python bindings for select commercial weather station APIs, such as Zentra Cloud REST API v3, created for MSU EnviroWeather Project.

Background

This is inspired by python bindings for v1 of the Zentra API from the Montana Climate office : MSU Agricultural Weather Office

The EnviroWeather system from the MSU Agricultural Weather Office will interface with weather stations (select list of vendors) deployed and owned privately. Since each vendor has a differrent REST/Web API to access station's weather data, this package aims to provide a consistent interface to all of those stations in order to make it easy for incoporating them into a data pipeline.

Installation

The Multi-Weather API is currently available on PyPI. Install using pip:

pip install multiweatherapi

Usage

>>> from multiweatherapi import multiweatherapi
>>> param = {'sn': 'STATION_ID',
...          'apikey': 'API_KEY',
...          'apisec': 'API_SECRET'}
>>> resp = multiweatherapi.get_reading('davis', **param)
>>> resp.resp_raw # raw JSON response of the reading
>>> resp.resp_parsed # parsed JSON response into list of dict for EnviroWeather project

Refer to the respective link below for parameter and authentication requirements of weather station vendor APIs

Supported Python Versions

Python 3.6 and higher are supported.

Supported Station Time Zones

Currently following time zones are supported:

Name Description
HT US/Hawaii
AT US/Alaska
PT US/Pacific
MT US/Mountain
CT US/Central
ET US/Eastern

Requirements

Outputs

To be determined

License

Released under the MIT License

Testing the package

If you want to test without installing via PIP, there is a script get_sample_data.py in the main directory which requires a configuration file named '.env' in the root folder.

pip install -r requirements.txt
get_sample_data.py RAINWISE

see also docs/Test Suite Doco.py for more formal tests and how to provide station configuration file

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

multiweatherapi-0.0.18.tar.gz (18.0 kB view hashes)

Uploaded Source

Built Distribution

multiweatherapi-0.0.18-py3-none-any.whl (26.4 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