NAME

Mojo::YR - Get weather information from met.no (not Yr)

DESCRIPTION

Mojo::YR is an (a)synchronous weather data fetcher for the Mojolicious framework. The backend for weather data is https://api.met.no; the YR name is a misnomer and the module has nothing to do with yr.no.

Look at the resources below for mere information about the API:

• http://api.met.no/weatherapi/documentation

• http://api.met.no/weatherapi/locationforecast/1.9/documentation

• http://api.met.no/weatherapi/textforecast/1.6/documentation

• http://api.met.no/weatherapi/sunrise/1.1/documentation

SYNOPSIS

use Mojo::YR;
use open qw/:std :utf8/;
my $yr = Mojo::YR->new;

# Fetch location_forecast ==========================================
my $now = $yr->location_forecast([59, 10])->find('product.pointData > time')->first;
my $temp = $now->at('temperature');

warn "$temp->{value} $temp->{unit}";

# Fetch text_forecast ==============================================
my $today = $yr->text_forecast->children('time')->first;
my $hordaland = $today->at('area[name="Hordaland"]');

warn $hordaland->at('header')->text;
warn $hordaland->at('in')->text; # "in" holds the forecast text

ATTRIBUTES

url_map

$hash_ref = $self->url_map;

Returns the URL used to fetch data.

Note: These will always be pointers to the current version. If you require a specific version, set it manually. Note: YR have short deprecation cycles.

Default:

{
  location_forecast => 'https://api.met.no/weatherapi/locationforecast/1.8/',
  text_forecast => 'https://api.met.no/weatherapi/textforecast/1.6/',
};

METHODS

location_forecast

$self = $self->location_forecast([$latitude, $longitude], sub { my($self, $err, $dom) = @_; ... });
$self = $self->location_forecast(\%args, sub { my($self, $err, $dom) = @_; ... });
$dom = $self->location_forecast([$latitude, $longitude]);
$dom = $self->location_forecast(\%args);

Used to fetch weather forecast for a specified place.

%args is required (unless [$latitude,$longitude] is given):

{
  latitude => $num,
  longitude => $num,
}

$dom is a Mojo::DOM object you can use to query the result. See "SYNOPSIS" for example.

text_location_forecast

$self = $self->text_location_forecast([$latitude, $longitude], sub { my($self, $err, $dom) = @_; ... });
$self = $self->text_location_forecast(\%args, sub { my($self, $err, $dom) = @_; ... });
$dom = $self->text_location_forecast([$latitude, $longitude]);
$dom = $self->text_location_forecast(\%args);

Used to fetch textual weather forecast for a specified place.

%args is required (unless [$latitude,$longitude] is given):

{
  latitude => $num,
  longitude => $num,
  language => 'nb', # default
}

$dom is a Mojo::DOM object you can use to query the result. See "SYNOPSIS" for example.

text_forecast

$dom = $self->text_forecast(\%args);
$self = $self->text_forecast(\%args, sub { my($self, $err, $dom) = @_; ... });

Used to fetch textual weather forecast for all parts of the country.

%args is optional and has these default values:

{
  forecast => 'land',
  language => 'nb',
}

$dom is a Mojo::DOM object you can use to query the result. See "SYNOPSIS" for example.

sunrise

$dom = $self->sunrise(\%args);
$self = $self->sunrise(\%args, sub { my($self, $err, $dom) = @_; ... });

Used to fetch When does the sun rise and set for a given place

%args is required

{
  lat => $num,
  lon => $num,
  date => 'YYYY-MM-DD', # OR
  from => 'YYYY-MM-DD',
  to   => 'YYYY-MM-DD',
}

$dom is a Mojo::DOM object you can use to query the result. See "SYNOPSIS" for example.

COPYRIGHT AND LICENSE

Copyright (C) 2014 Jan Henning Thorsen

This program is free software, you can redistribute it and/or modify it under the terms of the Artistic License version 2.0.

AUTHOR

Jan Henning Thorsen - jhthorsen@cpan.org Marcus Ramberg - mramberg@cpan.org