Introduction

Release v0.2.

pywunderground aims to provide a simple interface for retrieving weather data with wunderground API. Returned data is always a directly usable dict

Examples

List cities

Listing cities in France with name Paris

>>> cities = pywunderground.autocomplete('Paris', 'FR')
>>> cities
[{u'c': u'FR', u'tz': u'Europe/Paris', u'name': u'Paris, France', u'tzs': u'CET', u'l': u'/q/zmw:00000.1.07157', u'type': u'city', u'zmw': u'00000.1.07157'}, {u'c': u'FR', u'tz': u'Europe/Paris', u'name': u'Paris Le Bourget, France', u'tzs': u'CET', u'l': u'/q/zmw:00000.1.07150', u'type': u'city', u'zmw': u'00000.1.07150'}, {u'c': u'FR', u'tz': u'Europe/Paris', u'name': u'Paris Orly, France', u'tzs': u'CET', u'l': u'/q/zmw:00000.1.07149', u'type': u'city', u'zmw': u'00000.1.07149'}, {u'c': u'FR', u'tz': u'Europe/Paris', u'name': u'Paris-Plage, France', u'tzs': u'CET', u'l': u'/q/zmw:00000.6.07003', u'type': u'city', u'zmw': u'00000.6.07003'}]

Get the weather

Get the current condition and forecast for Paris in France

>>> weather = pywunderground.request('yourapikey', ['conditions', 'forecast'], 'Paris')
>>> weather
{u'response': {u'termsofService': u'http://www.wunderground.com/weather/api/d/terms.html', u'version': u'0.1', u'features': {u'conditions': 1, u'forecast': 1}, u'results': [{u'city': u'Paris', u'name': u'Paris', u'country': u'US', u'l': u'/q/zmw:72855.1.99999', u'state': u'AR', u'country_iso3166': u'US', u'country_name': u'USA', u'zmw': u'72855.1.99999'}, {u'city': u'Paris', u'name': u'Paris', u'country': u'FR', u'l': u'/q/zmw:00000.1.07157', u'state': u'', u'country_iso3166': u'FR', u'country_name': u'France', u'zmw': u'00000.1.07157'}, {u'city': u'Paris', u'name': u'Paris', u'country': u'US', u'l': u'/q/zmw:83261.1.99999', u'state': u'ID', u'country_iso3166': u'US', u'country_name': u'USA', u'zmw': u'83261.1.99999'}, {u'city': u'Paris', u'name': u'Paris', u'country': u'US', u'l': u'/q/zmw:61944.1.99999', u'state': u'IL', u'country_iso3166': u'US', u'country_name': u'USA', u'zmw': u'61944.1.99999'}, {u'city': u'Paris', u'name': u'Paris', u'country': u'US', u'l': u'/q/zmw:40361.1.99999', u'state': u'KY', u'country_iso3166': u'US', u'country_name': u'USA', u'zmw': u'40361.1.99999'}, {u'city': u'Paris', u'name': u'Paris', u'country': u'US', u'l': u'/q/zmw:04271.1.99999', u'state': u'ME', u'country_iso3166': u'US', u'country_name': u'USA', u'zmw': u'04271.1.99999'}, {u'city': u'Paris', u'name': u'Paris', u'country': u'US', u'l': u'/q/zmw:49338.1.99999', u'state': u'MI', u'country_iso3166': u'US', u'country_name': u'USA', u'zmw': u'49338.1.99999'}, {u'city': u'Paris', u'name': u'Paris', u'country': u'US', u'l': u'/q/zmw:38949.2.99999', u'state': u'MS', u'country_iso3166': u'US', u'country_name': u'USA', u'zmw': u'38949.2.99999'}, {u'city': u'Paris', u'name': u'Paris', u'country': u'US', u'l': u'/q/zmw:65275.1.99999', u'state': u'MO', u'country_iso3166': u'US', u'country_name': u'USA', u'zmw': u'65275.1.99999'}, {u'city': u'Paris', u'name': u'Paris', u'country': u'US', u'l': u'/q/zmw:13456.2.99999', u'state': u'NY', u'country_iso3166': u'US', u'country_name': u'USA', u'zmw': u'13456.2.99999'}, {u'city': u'Paris', u'name': u'Paris', u'country': u'US', u'l': u'/q/zmw:44669.1.99999', u'state': u'OH', u'country_iso3166': u'US', u'country_name': u'USA', u'zmw': u'44669.1.99999'}, {u'city': u'Paris', u'name': u'Paris', u'country': u'US', u'l': u'/q/zmw:15021.2.99999', u'state': u'PA', u'country_iso3166': u'US', u'country_name': u'USA', u'zmw': u'15021.2.99999'}, {u'city': u'Paris', u'name': u'Paris', u'country': u'US', u'l': u'/q/zmw:38242.1.99999', u'state': u'TN', u'country_iso3166': u'US', u'country_name': u'USA', u'zmw': u'38242.1.99999'}, {u'city': u'Paris', u'name': u'Paris', u'country': u'US', u'l': u'/q/zmw:75460.1.99999', u'state': u'TX', u'country_iso3166': u'US', u'country_name': u'USA', u'zmw': u'75460.1.99999'}, {u'city': u'Paris', u'name': u'Paris', u'country': u'US', u'l': u'/q/zmw:20130.1.99999', u'state': u'VA', u'country_iso3166': u'US', u'country_name': u'USA', u'zmw': u'20130.1.99999'}]}}

API Documentation

More details about the use of the module can be found here

Note

pywunderground.core is included in pywunderground

pywunderground.core.FEATURES = ['geolookup', 'conditions', 'forecast', 'astronomy', 'radar', 'satellite', 'webcams', 'history', 'alerts', 'hourly', 'hourly7day', 'forecast7day', 'yesterday', 'autocomplete', 'almanac', 'lang']

Available API request features

pywunderground.core.autocomplete(query, country=None, hurricanes=False, cities=True, timeout=5)

Make an autocomplete API request

This can be used to find cities and/or hurricanes by name

Parameters:
  • query (string) – city
  • country (string) – restrict search to a specific country. Must be a two letter country code
  • hurricanes (boolean) – whether to search for hurricanes or not
  • cities (boolean) – whether to search for cities or not
  • timeout (integer) – timeout of the api request
Returns:

result of the autocomplete API request

Return type:

dict

pywunderground.core.request(key, features, query, timeout=5)

Make an API request

Parameters:
  • key (string) – API key to use
  • features (list) – features to request. It must be a subset of FEATURES
  • query (string) – query to send
  • timeout (integer) – timeout of the request
Returns:

result of the API request

Return type:

dict

Table Of Contents

This Page