NAME

WWW::Wunderground::API - Use Weather Underground's XML interface

VERSION

Version 0.01

SYNOPSIS

Connects to the Weather Underground XML weather conditions URL and parses the data into something usable. The entire response is available in Hash::AsObject form, so any data that comes from the server is accessible. Print a Data::Dumper of ->data to see all of the tasty data bits.

use WWW::Wunderground::API;

#location
my $wun = new WWW::Wunderground::API('Fairfax, VA');

#or zipcode
my $wun = new WWW::Wunderground::API(22030);

#or airport identifier
my $wun = new WWW::Wunderground::API('KIAD');

print 'The temperature is: '.$wun->data->temp_f;
print 'XML source:'.$wun->xml;

update()

Refetch data from the server. This is called automatically every time location is set, but you may want to put it in a timer.

location()

Change the location. For example:

my $wun = new WWW::Wunderground::API(22030);
my $ffx_temp = $wun->data->temp_f;
$wun->location('KJFK');
my $ny_temp = $wun->data->temp_f;
$wun->location('San Diego, CA');
my $socal_temp = $wun->data->temp_f;

xml()

Returns raw xml result from wunderground server

data()

Contains xml result from server parsed into convenient Hash::AsObject form;

AUTHOR

John Lifsey, <nebulous at crashed.net>

BUGS

Please report any bugs or feature requests to bug-www-wunderground-api at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WWW-Wunderground-API. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc WWW::Wunderground::API

You can also look for information at:

LICENSE AND COPYRIGHT

Copyright 2011 John Lifsey.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.