graticule 0.2.5 → 0.2.6

data/Manifest.txt

@@ -20,6 +20,7 @@ lib/graticule/geocoder/google.rb
 lib/graticule/geocoder/host_ip.rb
 lib/graticule/geocoder/local_search_maps.rb
 lib/graticule/geocoder/meta_carta.rb
+lib/graticule/geocoder/multi.rb
 lib/graticule/geocoder/postcode_anywhere.rb
 lib/graticule/geocoder/rest.rb
 lib/graticule/geocoder/yahoo.rb
@@ -63,6 +64,7 @@ test/unit/graticule/geocoder/google_test.rb
 test/unit/graticule/geocoder/host_ip_test.rb
 test/unit/graticule/geocoder/local_search_maps_test.rb
 test/unit/graticule/geocoder/meta_carta_test.rb
+test/unit/graticule/geocoder/multi_test.rb
 test/unit/graticule/geocoder/postcode_anywhere_test.rb
 test/unit/graticule/geocoder/yahoo_test.rb
 test/unit/graticule/geocoder_test.rb

data/lib/graticule/geocoder/multi.rb

@@ -0,0 +1,46 @@
+module Graticule #:nodoc:
+  module Geocoder #:nodoc:
+    class Multi
+      
+      # The Multi geocoder allows you to use multiple geocoders in succession.
+      #
+      #   geocoder = Graticule.service(:multi).new(
+      #     Graticule.service(:google).new("api_key"),
+      #     Graticule.service(:yahoo).new("api_key"),
+      #   )
+      #   geocoder.locate '49423' # <= tries geocoders in succession
+      #
+      # The Multi geocoder will try the geocoders in order if a Graticule::AddressError
+      # is raised.  You can customize this behavior by passing in a block to the Multi
+      # geocoder.  For example, to try the geocoders until one returns a result with a
+      # high enough precision:
+      #
+      #   geocoder = Graticule.service(:multi).new(geocoders) do |result|
+      #     [:address, :street].include?(result.precision)
+      #   end
+      #
+      # Geocoders will be tried in order until the block returned true for one of the results
+      #
+      def initialize(*geocoders, &acceptable)
+        @acceptable = acceptable || lambda { true }
+        @geocoders = geocoders.flatten
+      end
+      
+      def locate(address)
+        last_error = nil
+        @geocoders.each do |geocoder|
+          begin
+            result = geocoder.locate address
+            return result if @acceptable.call(result)
+          rescue Error => e
+            last_error = e
+          rescue Errno::ECONNREFUSED
+            logger.error("Connection refused to #{service}")
+          end
+        end
+        raise last_error || AddressError.new("Couldn't find '#{address}' with any of the services")
+      end
+      
+    end
+  end
+end

data/lib/graticule/version.rb

@@ -2,7 +2,7 @@ module Graticule #:nodoc:
   module Version #:nodoc:
     MAJOR = 0
     MINOR = 2
-    TINY = 5
+    TINY = 6
   
     STRING = [MAJOR, MINOR, TINY].join('.')
   end

metadata

@@ -3,7 +3,7 @@ rubygems_version: 0.9.4
 specification_version: 1
 name: graticule
 version: !ruby/object:Gem::Version 
-  version: 0.2.5
+  version: 0.2.6
 date: 2007-09-12 00:00:00 -04:00
 summary: API for using all the popular geocoding services.
 require_paths: 
@@ -51,6 +51,7 @@ files:
 - lib/graticule/geocoder/host_ip.rb
 - lib/graticule/geocoder/local_search_maps.rb
 - lib/graticule/geocoder/meta_carta.rb
+- lib/graticule/geocoder/multi.rb
 - lib/graticule/geocoder/postcode_anywhere.rb
 - lib/graticule/geocoder/rest.rb
 - lib/graticule/geocoder/yahoo.rb
@@ -94,6 +95,7 @@ files:
 - test/unit/graticule/geocoder/host_ip_test.rb
 - test/unit/graticule/geocoder/local_search_maps_test.rb
 - test/unit/graticule/geocoder/meta_carta_test.rb
+- test/unit/graticule/geocoder/multi_test.rb
 - test/unit/graticule/geocoder/postcode_anywhere_test.rb
 - test/unit/graticule/geocoder/yahoo_test.rb
 - test/unit/graticule/geocoder_test.rb