accuweather

Accuweather

A simple wrapper around the accuweather web API written in Ruby

Get weather information for cities around the world. Includes current current conditions for temperature, pressure and humidity. Forecasts include temperature highs, lows, "real feels", UV, wind speed and direction, rain, snow, ice probabilities and amounts. The web API returns seven days of forecasts with estimates for both day and nighttime.

Also includes local times for the rise and set of celestial bodies in our solar system including the sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune and pluto.

Installation

Add this line to your application's Gemfile:

gem 'accuweather'

And then execute:

$ bundle

Or install it yourself as:

$ gem install accuweather

Usage

Search for a city location to determine its id:

location_array = Accuweather.city_search(name: 'vancouver')
vancouver = location_array.first

vancouver.id        # => 'cityId:53286'
vancouver.city      # => 'Vancouver'
vancouver.state     # => 'Canada (British Columbia)'
vancouver.latitude  # => '49.2448'
vancouver.longitude # => '123.1154'

Search for weather conditions for a given location id:

current_weather = Accuweather.get_conditions(location_id: 'cityId:53286').current
current_weather.temperature    # => '41'
current_weather.weather_text   # => 'Partly Sunny'
current_weather.pressure       # => '30.35'
current_weather.humidity       # => '43%'
current_weather.cloud_cover    # => '40%'

Get forecast details:

weather_forecast = Accuweather.get_conditions(location_id: 'cityId:53286').forecast
last_forecast_day = weather_forecast.last
last_forecast_day.date        # => "12/3/2015"
last_forecast_day.day_of_week # => "Thursday"
last_forecast_day.sunrise     # => "7:49 AM"
last_forecast_day.sunset      # => "4:16 PM"

# Get the dates, daytime high and nighttime low temperatures
weather_forecast.map(&:date)                             #  => ["11/27/2015", "11/28/2015", "11/29/2015", "11/30/2015", "12/1/2015", "12/2/2015", "12/3/2015"]
weather_forecast.map(&:daytime).map(&:high_temperature)  # => ["45", "45", "47", "44", "44", "48", "48"]
weather_forecast.map(&:nighttime).map(&:low_temperature) # => ["27", "28", "31", "32", "40", "42", "36"]

See Accuview::Conditions::ForecastWeather class for a full list of attributes for daytime and nighttime forecasts.

Get the units for the conditions:

units = Accuweather.get_conditions(location_id: 'cityId:53286').units
units.temperature  # => 'F'
units.distance     # => 'MI'
units.speed        # => 'MPH'

Get more information on the location including time and time zone:

local = Accuweather.get_conditions(location_id: 'cityId:53286').local
local.time                   # => '13:41'
local.time_zone              # => '-8'
local.time_zone_abbreviation # => 'PST'

English units are returned by default, but metric results are available:

Accuweather.get_conditions(location_id: 'cityId:53286', metric: true)

Each Accuweather::Conditions object implements a to_s method that displays all attribute name, value pairs. This makes it easy to explore the API. For example:

Accuweather.get_conditions(location_id: 'cityId:53286').local.to_s
# => "city: Vancouver, state: British Columbia, latitude: 49.2448, longitude: -123.1154, time: 16:58, time_zone: -8, obs_daylight: 0, current_gmt_offset: -8, time_zone_abbreviation: PST"

Get local times for the rise and set of celestial bodies in our solar system:

planets = Accuweather.get_conditions(location_id: 'cityId:53286').planets
planets.sunrise  # => "8:00 AM"
planets.moonrise # => "12/14/2015 10:14:00 AM"
planets.sunset   # => "4:14 PM"
planets.marsrise # => "10:16 AM"
planets.plutoset # => "2:04 AM"

Development

Run rake to run the tests

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/accuweather.