WorldWeatherOnline - GitLite

KO | EN

gitlite — search

#typescript #golang #go #android #machine-learning #deep-learning #nodejs #macos #windows #cli #awesome-list #pytorch #ios #openai

WorldWeatherOnline

(★ 86)

WorldWeatherOnline historical weather data API Python wrapper

File Explorer

Download Latest Version (.zip)

- wwo_hist-0.0.7-py3-none-any.whl
- wwo_hist-0.0.7.tar.gz
- - Example_01.PNG
  - Example_02.PNG
- __init__.py
- dependency_links.txt
- PKG-INFO
- SOURCES.txt
- top_level.txt
README.md
setup.py

# Installation Guide

1. Get the code

git clone https://github.com/ekapope/WorldWeatherOnline

Downloads the entire project code from GitHub to your computer.

cd WorldWeatherOnline

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

Python 3 Python is required to use pip.

pip install wwo-hist

Installs the package published on PyPI directly — no need to clone the source.

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. Python

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

pip install wwo-hist

Installs the package published on PyPI directly — no need to clone the source.

✅ If it runs without errors and prints output in the terminal, it worked.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# WorldWeatherOnline historical weather data API wrapper

[![Downloads](https://pepy.tech/badge/wwo-hist)](https://pepy.tech/project/wwo-hist)

This package is used to retrieve and transform historical weather data from www.worldweatheronline.com into pandas dataframe and csv.

You can get API key for free (free trial 500 requests/key/day for 60 days, as of 30-May-2019).

example API explorer: https://www.worldweatheronline.com/developer/premium-api-explorer.aspx

**Input**: api_key, location_list, start_date, end_date, frequency

**Output**: location_name.csv

**Output column names**: date_time, maxtempC, mintempC, totalSnow_cm, sunHour, uvIndex, uvIndex, moon_illumination, moonrise, moonset, sunrise, sunset, DewPointC, FeelsLikeC, HeatIndexC, WindChillC, WindGustKmph, cloudcover, humidity, precipMM, pressure, tempC, visibility, winddirDegree, windspeedKmph

#### Install the package:
```
pip install wwo-hist
```

#### Import package
```python
from wwo_hist import retrieve_hist_data
```

#### Set working directory to store output csv file(s)
```python
import os
os.chdir(".\YOUR_PATH")
```

#### Example code
```python
frequency=3
start_date = '11-DEC-2018'
end_date = '11-MAR-2019'
api_key = 'YOUR_API_KEY'
location_list = ['singapore','california']

hist_weather_data = retrieve_hist_data(api_key,
                                location_list,
                                start_date,
                                end_date,
                                frequency,
                                location_label = False,
                                export_csv = True,
                                store_df = True)
```

#### Parameters:

**api_key**: *string*

(Premium/ free trial) API key from https://www.worldweatheronline.com/developer/api/

**location_list**: *list of string*

US Zipcode, UK Postcode, Canada Postalcode, IP address, Latitude/Longitude (decimal degree) or city name

**start_date**: *string*

Preferred date format: 'dd-mmm-yyyy'

**end_date**: *string*

Preferred date format: 'dd-mmm-yyyy'

**frequency**: *integer*

1, 3, 6, 12, 24

1 hourly, 3 hourly, 6 hourly, 12 hourly (day/night) or 24 hourly (day average)

**location_label**: *bool*, default = False

If True, all column names will have city name as prefix.

**export_csv**: *bool*, default = True

If False, no csv file will be exported to current directory.

**store_df**: *bool*, default = False

If True, retrieved dataframe(s) will be stored as list in the work space.

#### Console view
![IPython](https://raw.githubusercontent.com/ekapope/WorldWeatherOnline/master/doc/screenshots/Example_01.PNG)

#### Output file
![CSV file](https://raw.githubusercontent.com/ekapope/WorldWeatherOnline/master/doc/screenshots/Example_02.PNG)