Skip to main content

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

Project description

WorldWeatherOnline historical weather data API wrapper

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 for 60 days, as of 30-May-2019).

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

Install the package:

pip install wwo-hist

Import package

from wwo_hist import retrieve_hist_data

Set working directory to store output csv file(s)

import os
os.chdir(".\YOUR_PATH")

Input: api_key, location_list, start_date, end_date, frequency

Output: location_name.csv

Example code

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 worldweatheronline.com

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.

Project details


Release history Release notifications

Download files

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

Files for wwo-hist, version 0.0.4
Filename, size File type Python version Upload date Hashes
Filename, size wwo_hist-0.0.4.tar.gz (3.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page