/ 
Weather-Meteo-0.09
River stage zero No dependents
/ Weather::Meteo

NAME

Weather::Meteo - Interface to https://open-meteo.com for historical weather data

VERSION

Version 0.09

SYNOPSIS

use Weather::Meteo;

my $meteo = Weather::Meteo->new();
my $weather = $meteo->weather({ latitude => 0.1, longitude => 0.2, date => '2022-12-25' });

DESCRIPTION

Weather::Meteo provides an interface to open-meteo.com for historical weather data from 1940.

METHODS

new

my $meteo = Weather::Meteo->new();
my $ua = LWP::UserAgent->new();
$ua->env_proxy(1);
$meteo = Weather::Meteo->new(ua => $ua);

my $weather = $meteo->weather({ latitude => 51.34, longitude => 1.42, date => '2022-12-25' });
my @snowfall = @{$weather->{'hourly'}->{'snowfall'}};

print 'Number of cms of snow: ', $snowfall[1], "\n";

weather

use Geo::Location::Point;

The date argument can be an ISO-8601 formatted date, or an object that understands the strftime method.

my $ramsgate = Geo::Location::Point->new({ latitude => 51.34, longitude => 1.42 });
# Print snowfall at 1AM on Christmas morning in Ramsgate
$weather = $meteo->weather($ramsgate, '2022-12-25');
@snowfall = @{$weather->{'hourly'}->{'snowfall'}};

print 'Number of cms of snow: ', $snowfall[1], "\n";

use DateTime;
my $dt = DateTime->new(year => 2024, month => 2, day => 1);
$weather = $meteo->weather({ location => $ramsgate, date => $dt });

Takes an optional argument, tz, which defaults to 'Europe/London'. For that to work set TIMEZONEDB_KEY to be your API key from https://timezonedb.com.

ua

Accessor method to get and set UserAgent object used internally. You can call env_proxy for example, to get the proxy information from environment variables:

$meteo->ua()->env_proxy(1);

You can also set your own User-Agent object:

use LWP::UserAgent::Throttled;

my $ua = LWP::UserAgent::Throttled->new();
$ua->throttle('open-meteo.com' => 1);
$meteo->ua($ua);

AUTHOR

Nigel Horne, <njh@bandsman.co.uk>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Lots of thanks to the folks at https://open-meteo.com.

BUGS

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

SEE ALSO

Open Meteo API: https://open-meteo.com/en/docs#api_form

SUPPORT

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

perldoc Weather::Meteo

You can also look for information at:

LICENSE AND COPYRIGHT

Copyright 2024 Nigel Horne.

This program is released under the following licence: GPL2