Knut-Olav Hoven > Weather-YR-0.25 > Weather::YR::Locationforecast

Download:
Weather-YR-0.25.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Source   Latest Release: Weather-YR-0.32

NAME ^

Weather::YR::Locationforecast - Used to fetch forecast from a geo position from YR

SYNOPSIS ^

  use Weather::YR::Locationforecast

  my $loc   = Weather::YR::Locationforecast->new(
    {
        'latitude'      => '59.6327',
        'longitude'     => '10.2468',
    }
  );

  my $loc_forecast = $loc->forecast;

  print $loc_forecast->[0]->{'temperature'}->{'value'} . " degrees celcius";

DESCRIPTION ^

This module returns textforecasts from YR according to specified parameters.

This module uses the data from URLs such as these: http://api.yr.no/weatherapi/locationforecast/1.5/?lat=60.10;lon=9.58

DESCRIPTION FROM YR API

This modules implements a full forecast for one location, that is, a forecast with five parameters for a seven-day period.

The five parameters are temperature, wind speed, wind direction, pressure and precipitation.

For the first 48 hours, the datapoints are spaces one hour apart, and for the remaining five 24-hour periods, they are spaces three hours apart.

CONFIGURATION ^

url

The URL to the web service for getting the textforecasts. Defaults to version 1.5 of the API: http://api.yr.no/weatherapi/locationforecast/1.5/.

latitude

The latitude of the location. No default, must be applied in constructor.

longitude

The longitude of the location. No default, must be applied in constructor.

METHODS ^

new(\%args) ^

Constructor that validates the incoming parameters. We request these parameters to be set: latitude longitude

forecast

Retrieves the forecast in a data structure representing the XML document.

parse_weatherdata($xml)

This method parses the response from YR and returns a structure of objects.

parse_forecast_time($time_ref)

This method parses each time element in the forecast XML document.

parse_forecast_full($location)

This method parses full/complete forecasts which contains different types of data.

parse_forecast_symbol($location)

This method parses forecasts that contains symbol data.

parse_forecast_precip($location)

This method parses forecasts that contains precipitation data.

get_url

Assembles the complete URL for the textforecast service with the forecast type and language.

SEE ALSO ^

Weather::YR, Weather::YR::Base

AUTHOR ^

Knut-Olav, <knut-olav@hoven.ws>

COPYRIGHT AND LICENSE ^

Copyright (C) 2008 by Knut-Olav Hoven

This library is free software; you can redireibute it and/or modify it under the terms as GNU GPL version 2.

syntax highlighting: