README.rdoc in barometer-0.7.1 vs README.rdoc in barometer-0.7.2
- old
+ new
@@ -13,11 +13,11 @@
support the query directly. See the "Query" section for more information on
this.
== version
-Version 0.7.1 is the current release of this gem. The gem is available from
+Version 0.7.2 is the current release of this gem. The gem is available from
gemcutter (barometer: http://gemcutter.org/gems/barometer).
Older version are available through rubyforge (barometer) and github
(attack-barometer).
It is fully functional (for five weather service APIs).
@@ -32,29 +32,19 @@
- even more weather service drivers (hamweather)
- icon support
= dependencies
-== Google API key
+== Google API key [UPDATED]
-In most cases you will need to have a free google geocode api key.
-Get one here: http://code.google.com/apis/maps/signup.html
-Then put it in the file '~/.barometer' by adding the lines:
+As stated on the Google Geocoding API website
+(http://code.google.com/apis/maps/documentation/geocoding/), Google no longer
+requires an API key. Therefore Barometer no longer requires a Google API key.
- google:
- geocode: YOUR_KEY_HERE
-
-You will need this for:
-- using the Barometer gem (unless you use queries that are directly supported
- by the weather source API, ie yahoo will take a zip code directly and doesn't
- require any geocoding)
-- running the Barometer binary
-- running the Barometer Web Demo
-
=== other keys
-The same file can hold all your weather service API keys.
+The '~/.barometer' file can hold all your weather service API keys.
eg. weather.com
weather:
partner: YOUR_PARTNER_KEY
@@ -129,16 +119,12 @@
You can use barometer right out of the box, as it is configured to use one
register-less (no API key required) international weather service
(wunderground.com).
-For better results, signup for a google-map key and enhance your barometer
-with geo-coding.
-
require 'barometer'
- Barometer.google_geocode_key = "THE_GOOGLE_API_KEY"
barometer = Barometer.new("Paris")
weather = barometer.measure
puts weather.current.temperature
@@ -147,12 +133,12 @@
The available sources are:
Wunderground.com (:wunderground) [default]
Yahoo! Weather (:yahoo)
Google Weather (:google)
- Weather.com (:weather_dot_com)
- WeatherBug.com (:weather_bug)
+ Weather.com (:weather_dot_com) [requires key]
+ WeatherBug.com (:weather_bug) [requires key]
== source configuration
Barometer can be configured to use multiple weather service APIs (either in
a primary/failover config or in parallel). Each weather service can also
@@ -177,10 +163,9 @@
=== multiple weather API, with hierarchy
require 'barometer'
- Barometer.google_geocode_key = "THE_GOOGLE_API_KEY"
# use yahoo and google, if they both fail, use wunderground
Barometer.config = { 1 => [:yahoo, :google], 2 => :wunderground }
barometer = Barometer.new("Paris")
weather = barometer.measure