drifter 0.1.1 → 0.1.2

data/lib/drifter/version.rb

@@ -1,3 +1,3 @@
 module Drifter
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,13 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: drifter
 version: !ruby/object:Gem::Version 
-  hash: 25
-  prerelease: 
+  prerelease: false
   segments: 
   - 0
   - 1
-  - 1
-  version: 0.1.1
+  - 2
+  version: 0.1.2
 platform: ruby
 authors: 
 - Ahmed Adam
@@ -15,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-01-23 00:00:00 +00:00
+date: 2011-01-24 00:00:00 +00:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -26,7 +25,6 @@ dependencies:
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        hash: 11
         segments: 
         - 1
         - 4
@@ -42,7 +40,6 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 3
         segments: 
         - 0
         version: "0"
@@ -59,7 +56,6 @@ extra_rdoc_files: []
 files: 
 - .gitignore
 - Gemfile
-- README
 - README.rdoc
 - Rakefile
 - drifter.gemspec
@@ -100,7 +96,6 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
       segments: 
       - 0
       version: "0"
@@ -109,14 +104,13 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
       segments: 
       - 0
       version: "0"
 requirements: []
 
 rubyforge_project: drifter
-rubygems_version: 1.4.2
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: Simple geocoding library for ruby

data/README

@@ -1,102 +0,0 @@
-== drifter
-
-drifter is a simple geocoding library with support for the Google Geocoder API and
-the Yahoo Placefinder API. It also supports IP address geocoding using the hostip.info API
-
-=== Installation
-  
-  gem install drifter
-  require 'rubygems'
-  require 'drifter'
-
-  # if you're using rails:
-  gem install drifter
-  gem 'drifter' # in Gemfile
-
-
-=== Usage
-
-Drifter.geocode() takes a string representing an address or location and returns
-an array of Drifter::Location objects
-
-  >> london = Drifter.geocode("London, UK").first
-  => <#Drifter::Location>
-
-Drifter::Location objects hold common address attributes like city, state, post_code
-country_code, lat and lng:
-
-  >> [london.country_code, london.lat, london.lng]
-  => ['GB', 51.5001524, -0.1262362]
-
-Reverse geocoding is also supported. Instead of passing a string to geocode(), you can
-pass a two item array or an object that responds to lat() and lng()
-
-  >> loc = Drifter.geocode( [53.4807125, -2.2343765] ).first
-  => [loc.city, loc.state].join(', ')
-  => "Manchester, England"
-
-IP address gecoding is supported using the hostip.info api. Just pass the IP as the
-location parameter
-
-  >> loc = Drifter.geocode('1.2.3.4').first
-  => <#Drifter::Location>
-
-hostip.info only provides the city, country, lat and lng. If you need more info, you
-can reverse geocode the result:
-
-  >> loc = Drifter.geocode('1.2.3.4').first
-  >> loc = Drifter.geocode(loc).first
-  >> loc.state_code
-  => 'CA'
-
-Google is the default geocoding provider and works out of the box.  Yahoo's placefinder
-is also supported but you'll need an api key (they call it an appid)
-
-  >> Drifter.default_geocoder = :yahoo
-  >> Drifter::Geocoders::Yahoo.api_key = 'my_key'
-
-  >> bh = Drifter.geocode("90210").first
-  => <#Drifter::Location>
-
-You can change the geocoder per request:
-
-  >> Drifter.geocode("springfield", :geocoder => :yahoo)
-  >> Drifter.geocode("springfield", :geocoder => :google)
-
-Both Yahoo and Google return a lot more info than is held in Drifter::Location's standard
-attributes. You can access the extra data using the data() method which returns a Hash
-
-  # using google as the provider:
-  >> london.data["geometry"]["location_type"]
-  => "APPROXIMATE"
-
-The key => value pairs in the data Hash are specific to each provider, so you'll have to
-check their docs to see what's available.  You can also modify the query sent to the 
-geocoder to customise the results.  Any option other than :geocoder will be URL encoded
-and sent as a query string parameter e.g. Yahoo's service returns a timezone if you pass a
-'flags' parameter containing a 'T':
-
-  >> Drifter.default_geocoder = :yahoo
-  >> paris = Drifter.geocode("Paris", :flags => 'T').first
-  >> paris.data["timezone"]
-  => "Europe/paris"
-
-Finally, Drifter::Location objects have a distance_to() method
-
-  >> london.distance_to(bh)
-  => 5438.60013996461
-
-Distances are returned in miles by default. You can change this per request or change the default
-
-  >> Drifter.default_units = :km
-  >> london.distance_to(bh, :units => :miles)
-
-Drifter.geocode() always returns an array if the request was processed successfully by the
-geocoding service. An empty array indicates that the service returned no results.
-
-If the geocoding service returns an error, Drifter.geocode() returns nil and Drifter.last_error()
-returns a hash with the error :code and :message
-
-=== License
-
-MIT License. Copyright 2011 Ahmed Adam (http://github.com/ahmedrb)