aub-graticule 0.2.11

data/test/unit/graticule/distance_test.rb

@@ -0,0 +1,58 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../test_helper')
+
+module Graticule
+  module Distance
+    class DistanceFormulaTest < Test::Unit::TestCase
+      EARTH_RADIUS_IN_MILES = 3963.1676
+      EARTH_RADIUS_IN_KILOMETERS = 6378.135
+
+      FORMULAS = [Haversine, Spherical, Vincenty]
+
+      def test_earth_radius
+        assert_equal EARTH_RADIUS_IN_MILES, EARTH_RADIUS[:miles]
+        assert_equal EARTH_RADIUS_IN_KILOMETERS, EARTH_RADIUS[:kilometers]
+      end
+
+      def test_distance
+        washington_dc = Location.new(:latitude => 38.898748, :longitude => -77.037684)
+        chicago = Location.new(:latitude => 41.85, :longitude => -87.65)
+        
+        FORMULAS.each do |formula|
+          assert_in_delta formula.distance(washington_dc, chicago), formula.distance(chicago, washington_dc), 0.00001
+          assert_in_delta 594.820, formula.distance(washington_dc, chicago), 1.0
+          assert_in_delta 594.820, formula.distance(washington_dc, chicago, :miles), 1.0
+          assert_in_delta 957.275, formula.distance(washington_dc, chicago, :kilometers), 1.0
+        end
+      end
+      
+      def test_distance_between_antipodal_points
+        # The Vincenty formula will be indeterminant with antipodal points.
+        # See http://mathworld.wolfram.com/AntipodalPoints.html
+        washington_dc = Location.new(:latitude => 38.898748, :longitude => -77.037684)
+        chicago = Location.new(:latitude => 41.85, :longitude => -87.65)
+        
+        # First, test the deltas.
+        FORMULAS.each do |formula|
+          assert_in_delta 12450.6582171051, 
+            formula.distance(chicago, chicago.antipodal_location), 1.0
+          assert_in_delta 12450.6582171051, 
+            formula.distance(washington_dc, washington_dc.antipodal_location), 1.0
+          assert_in_delta 12450.6582171051, 
+            formula.distance(chicago, chicago.antipodal_location, :miles), 1.0
+          assert_in_delta 12450.6582171051, 
+            formula.distance(washington_dc, washington_dc.antipodal_location, :miles), 1.0
+          assert_in_delta 20037.50205960391, 
+            formula.distance(chicago, chicago.antipodal_location, :kilometers), 1.0
+          assert_in_delta 20037.5020596039, 
+            formula.distance(washington_dc, washington_dc.antipodal_location, :kilometers), 1.0
+        end
+        
+        # Next, test Vincenty.  Vincenty will use haversine instead of returning NaN on antipodal points
+        assert_equal Haversine.distance(washington_dc, washington_dc.antipodal_location), 
+          Vincenty.distance(washington_dc, washington_dc.antipodal_location)
+        assert_equal Haversine.distance(chicago, chicago.antipodal_location),
+          Vincenty.distance(chicago, chicago.antipodal_location)
+      end
+    end
+  end
+end

data/test/unit/graticule/geocoder/geocoder_us_test.rb

@@ -0,0 +1,43 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../../test_helper')
+
+module Graticule
+  module Geocoder
+    class GeocoderUsTest < Test::Unit::TestCase
+
+      def setup
+        URI::HTTP.responses = []
+        URI::HTTP.uris = []
+
+        @geocoder = GeocoderUs.new
+        @location = Location.new(
+          :street => "1600 Pennsylvania Ave NW, Washington DC 20502",
+          :longitude => -77.037684,
+          :latitude => 38.898748
+        )
+      end
+
+      def test_success
+        prepare_response(:success)
+        assert_equal @location, @geocoder.locate('1600 Pennsylvania Ave, Washington DC')
+      end
+    
+      def test_url
+        prepare_response(:success)
+        @geocoder.locate('1600 Pennsylvania Ave, Washington DC')
+        assert_equal 'http://rpc.geocoder.us/service/rest/geocode?address=1600%20Pennsylvania%20Ave,%20Washington%20DC',
+                     URI::HTTP.uris.first
+      end
+
+      def test_locate_bad_address
+        prepare_response(:unknown)
+        assert_raises(AddressError) { @geocoder.locate('yuck') }
+      end
+
+    protected
+      def prepare_response(id)
+        URI::HTTP.responses << response('geocoder_us', id)
+      end
+
+    end
+  end
+end

data/test/unit/graticule/geocoder/geocoders.rb

@@ -0,0 +1,56 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../../test_helper')
+
+
+module Graticule
+  
+  # Generic tests for all geocoders (theoretically)
+  module GeocodersTestCase
+    
+    def test_success
+      return unless prepare_response(:success)
+      
+      location = Location.new(
+        :street => "1600 Amphitheatre Pkwy",
+        :city => "Mountain View",
+        :state => "CA",
+        :zip => "94043",
+        :country => "US",
+        :longitude => -122.083739,
+        :latitude => 37.423021,
+        :precision => :address
+      )
+      assert_equal location, @geocoder.locate('1600 Amphitheatre Parkway, Mountain View, CA')
+    end
+    
+    def test_bad_key
+      return unless prepare_response(:badkey)
+      assert_raises(CredentialsError) { @geocoder.locate('x') }
+    end
+    
+    def test_locate_missing_address
+      return unless prepare_response(:missing_address)
+      assert_raises(AddressError) { @geocoder.locate 'x' }
+    end
+    
+    def test_locate_server_error
+      return unless prepare_response(:server_error)
+      assert_raises(Error) { @geocoder.locate 'x' }
+    end
+
+    def test_locate_too_many_queries
+      return unless prepare_response(:limit)
+      assert_raises(CredentialsError) { @geocoder.locate 'x' }
+    end
+
+    def test_locate_unavailable_address
+      return unless prepare_response(:unavailable)
+      assert_raises(AddressError) { @geocoder.locate 'x' }
+    end
+
+    def test_locate_unknown_address
+      return unless prepare_response(:unknown_address)
+      assert_raises(AddressError) { @geocoder.locate 'x' }
+    end
+
+  end
+end

data/test/unit/graticule/geocoder/google_test.rb

@@ -0,0 +1,112 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../../test_helper')
+
+module Graticule
+  module Geocoder
+    class GoogleTest < Test::Unit::TestCase
+      def setup
+        URI::HTTP.responses = []
+        URI::HTTP.uris = []
+        @geocoder = Google.new(:key => 'APP_ID')
+      end
+    
+      def test_success
+        return unless prepare_response(:success)
+      
+        location = Location.new(
+          :street => "1600 Amphitheatre Pkwy",
+          :locality => "Mountain View",
+          :region => "CA",
+          :postal_code => "94043",
+          :country => "US",
+          :longitude => -122.083739,
+          :latitude => 37.423021,
+          :precision => :address
+        )
+        assert_equal location, @geocoder.locate('1600 Amphitheatre Parkway, Mountain View, CA')
+      end
+      
+
+      # The #locate parameters are broad, so the XML response contains 
+      # multiple results at street-level precision. We expect to get the 
+      # first result back, and it should not contain a postal code.
+      def test_success_multiple_results
+        return unless prepare_response(:success_multiple_results)
+
+        location = Location.new(
+          :street => "Queen St W",
+          :locality => "Toronto",
+          :region => "ON",
+          :postal_code => nil,
+          :country => "CA",
+          :longitude => -79.4125590,
+          :latitude => 43.6455030,
+          :precision => :street
+        )
+        assert_equal location, @geocoder.locate('Queen St West, Toronto, ON CA')
+      end
+
+
+        # <?xml version='1.0' encoding='UTF-8'?><kml xmlns='http://earth.google.com/kml/2.0'><Response><name>15-17 </name><Status><code>200</code><request>geocode</request></Status><Placemark id='p1'><Point><coordinates>-17.000000,15.000000,0</coordinates></Point></Placemark></Response></kml>
+        def test_only_coordinates
+          return unless prepare_response(:only_coordinates)
+
+          location = Location.new(:longitude => -17.000000, :latitude => 15.000000)
+          assert_equal location, @geocoder.locate('15-17 & 16 Railroad Square, Nashua, NH, 03064')
+        end
+        
+
+
+      def test_partial
+        return unless prepare_response(:partial)
+        
+        location = Location.new(
+          :locality => "San Francisco",
+          :region => "CA",
+          :country => "US",
+          :longitude => -122.418333,
+          :latitude => 37.775000,
+          :precision => :city
+        )
+        
+        assert_equal location, @geocoder.locate('sf ca')
+      end
+    
+      def test_bad_key
+        return unless prepare_response(:badkey)
+        assert_raises(CredentialsError) { @geocoder.locate('x') }
+      end
+    
+      def test_locate_missing_address
+        return unless prepare_response(:missing_address)
+        assert_raises(AddressError) { @geocoder.locate 'x' }
+      end
+    
+      def test_locate_server_error
+        return unless prepare_response(:server_error)
+        assert_raises(Error) { @geocoder.locate 'x' }
+      end
+
+      def test_locate_too_many_queries
+        return unless prepare_response(:limit)
+        assert_raises(CredentialsError) { @geocoder.locate 'x' }
+      end
+
+      def test_locate_unavailable_address
+        return unless prepare_response(:unavailable)
+        assert_raises(AddressError) { @geocoder.locate 'x' }
+      end
+
+      def test_locate_unknown_address
+        return unless prepare_response(:unknown_address)
+        assert_raises(AddressError) { @geocoder.locate 'x' }
+      end
+
+    protected
+
+      def prepare_response(id = :success)
+        URI::HTTP.responses << response('google', id)
+      end
+  
+    end
+  end
+end

data/test/unit/graticule/geocoder/host_ip_test.rb

@@ -0,0 +1,40 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../../test_helper')
+
+module Graticule
+  module Geocoder
+    class HostIpTest < Test::Unit::TestCase
+      
+      def setup
+        @geocoder = HostIp.new
+        URI::HTTP.responses = []
+        URI::HTTP.uris = []
+      end
+      
+      def test_success
+        prepare_response :success
+        
+        location = Location.new :country => 'US', :locality => 'Mountain View',
+          :region => 'CA', :latitude => 37.402, :longitude => -122.078
+        
+        assert_equal location, @geocoder.locate('64.233.167.99')
+      end
+      
+      def test_unknown
+        prepare_response :unknown
+        assert_raises(AddressError) { @geocoder.locate('127.0.0.1') }
+      end
+
+      def test_private_ip
+        prepare_response :private
+        assert_raises(AddressError) { @geocoder.locate('127.0.0.1') }
+      end
+      
+    private
+    
+      def prepare_response(id = :success)
+        URI::HTTP.responses << response('host_ip', id, 'txt')
+      end
+      
+    end
+  end
+end

data/test/unit/graticule/geocoder/local_search_maps_test.rb

@@ -0,0 +1,30 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../../test_helper')
+
+module Graticule
+  module Geocoder
+    class LocalSearchMapsTest < Test::Unit::TestCase
+      
+      def setup
+        @geocoder = LocalSearchMaps.new
+        URI::HTTP.responses = []
+        URI::HTTP.uris = []
+      end
+      
+      def test_success
+        prepare_response :success
+        
+        location = Location.new :latitude => 51.510036, :longitude => -0.130427
+        
+        assert_equal location, @geocoder.locate(:street => '48 Leicester Square',
+          :locality => 'London', :country => 'UK')
+      end
+
+    private
+    
+      def prepare_response(id = :success)
+        URI::HTTP.responses << response('local_search_maps', id, 'txt')
+      end
+      
+    end
+  end
+end

data/test/unit/graticule/geocoder/mapquest_test.rb

@@ -0,0 +1,61 @@
+require File.join(File.dirname(__FILE__), '..', '..', '..', 'test_helper')
+
+module Graticule
+  module Geocoder
+    class MapquestTest < Test::Unit::TestCase
+      def setup
+        URI::HTTP.responses = []
+        URI::HTTP.uris = []
+        @geocoder = Mapquest.new('client_id', 'password')
+      end
+
+      def test_success
+        prepare_response(:success)
+        location = Location.new(
+          :country => "US",
+          :latitude => 44.152019,
+          :locality => "Lovell",
+          :longitude => -70.892706,
+          :postal_code => "04051-3919",
+          :precision => :address,
+          :region => "ME",
+          :street => "44 Allen Rd"
+        )
+        assert_equal(location, @geocoder.locate('44 Allen Rd., Lovell, ME 04051'))
+      end
+
+      def test_multi_result
+        prepare_response(:multi_result)
+        locations = [
+          Location.new(
+            :country => "US",
+            :latitude => 40.925598,
+            :locality => "Stony Brook",
+            :longitude => -73.141403,
+            :postal_code => nil,
+            :precision => :city,
+            :region => "NY",
+            :street => nil
+          ),
+          Location.new(
+            :country => "US",
+            :latitude => 41.229401,
+            :locality => "Stony Point",
+            :longitude => -73.987503,
+            :postal_code => nil,
+            :precision => :city,
+            :region => "NY",
+            :street => nil
+          )
+        ]
+        assert_equal(locations, @geocoder.locate_all('217 Union St., NY'))
+      end
+
+      protected
+      
+      def prepare_response(id)
+        URI::HTTP.responses << response('mapquest', id)
+      end
+    end
+  end
+end

data/test/unit/graticule/geocoder/meta_carta_test.rb

@@ -0,0 +1,44 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../../test_helper')
+
+module Graticule
+  module Geocoder
+    class MetaCartaTest < Test::Unit::TestCase
+
+      def setup
+        URI::HTTP.responses = []
+        URI::HTTP.uris = []
+
+        @geocoder = MetaCarta.new
+      end
+
+      def test_locate
+        prepare_response(:success)
+
+        expected = Location.new :latitude => 44.3939, :longitude => 33.3386
+        
+        assert_equal expected, @geocoder.locate('baghdad')
+        assert_equal true, URI::HTTP.responses.empty?
+        assert_equal 1, URI::HTTP.uris.length
+        assert_equal 'http://labs.metacarta.com/GeoParser/?output=locations&q=baghdad',
+                     URI::HTTP.uris.first
+      end
+
+      def test_locate_bad_address
+        prepare_response(:bad_address)
+        assert_raises(AddressError) { @geocoder.locate('aoeueou') }
+      end
+
+      def test_locations
+        prepare_response(:multiple)
+        expected = Location.new :latitude => -122.33083, :longitude => 47.60639
+        assert_equal expected, @geocoder.locate('seattle')
+      end
+
+    protected
+      def prepare_response(id = :success)
+        URI::HTTP.responses << response('meta_carta', id)
+      end
+
+    end
+  end
+end

data/test/unit/graticule/geocoder/multi_test.rb

@@ -0,0 +1,43 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../../test_helper')
+
+module Graticule
+  module Geocoder
+    class MultiTest < Test::Unit::TestCase
+
+      def setup
+        @mock_geocoders = [mock("geocoder 1"), mock("geocoder 2")]
+        @mock_geocoders.each {|g| g.stubs(:locate) }
+        @geocoder = Multi.new(*@mock_geocoders)
+      end
+
+      def test_locate_calls_each_geocoder_and_raises_error
+        @mock_geocoders.each do |g|
+          g.expects(:locate).with('test').raises(Graticule::AddressError)
+        end
+        assert_raises(Graticule::AddressError) { @geocoder.locate 'test' }
+      end
+
+      def test_locate_returns_first_result_without_calling_others
+        result = mock("result")
+        @mock_geocoders.first.expects(:locate).returns(result)
+        @mock_geocoders.last.expects(:locate).never
+        assert_equal result, @geocoder.locate('test')
+      end
+      
+      def test_locate_with_custom_block
+        @mock_geocoders.first.expects(:locate).returns(1)
+        @mock_geocoders.last.expects(:locate).returns(2)
+        @geocoder = Multi.new(*@mock_geocoders) {|r| r == 2 }
+        assert_equal 2, @geocoder.locate('test')
+      end
+
+      def test_locate_with_custom_block_and_no_match
+        @mock_geocoders.first.expects(:locate).returns(1)
+        @mock_geocoders.last.expects(:locate).returns(2)
+        @geocoder = Multi.new(*@mock_geocoders) {|r| r == 3 }
+        assert_raises(Graticule::AddressError) { @geocoder.locate('test') }
+      end
+
+    end
+  end
+end

data/test/unit/graticule/geocoder/multimap_test.rb

@@ -0,0 +1,52 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../../test_helper')
+
+module Graticule
+  module Geocoder
+    class MultimapTest < Test::Unit::TestCase
+
+      def setup
+        URI::HTTP.responses = []
+        URI::HTTP.uris = []
+        @geocoder = Multimap.new 'API_KEY'
+        @location = Location.new(
+          :street => "Oxford Street",
+          :locality => "London",
+          :postal_code => "W1",
+          :country => "GB",
+          :longitude => -0.14839,
+          :latitude => 51.51452,
+          :precision => :address
+        )
+      end
+
+    def test_locate
+      prepare_response(:success)
+      assert_equal @location, @geocoder.locate('Oxford Street, LONDON, W1')
+    end
+
+    def test_url_from_string
+      prepare_response(:success)
+      @geocoder.locate('Oxford Street, LONDON, W1')
+      assert_equal 'http://clients.multimap.com/API/geocode/1.2/API_KEY?qs=Oxford%20Street,%20LONDON,%20W1', URI::HTTP.uris.first
+    end
+    
+    def test_url_from_location
+      prepare_response(:success)
+      @geocoder.locate(:street => 'Oxford Street', :city => 'London')
+      assert_equal 'http://clients.multimap.com/API/geocode/1.2/API_KEY?city=&countryCode=&postalCode=&region=&street=Oxford%20Street', URI::HTTP.uris.first
+    end
+
+
+    def test_locate_bad_address
+      prepare_response(:no_matches)
+      assert_raise(Error) { @geocoder.locate('yucksthoeusthaoeusnhtaosu') }
+    end
+
+    protected
+      def prepare_response(id)
+        URI::HTTP.responses << response('multimap', id)
+      end
+
+    end
+  end
+end

data/test/unit/graticule/geocoder/postcode_anywhere_test.rb

@@ -0,0 +1,50 @@
+# account code: INDIV30777
+# license key: KG39-HM17-PZ95-NR98
+require File.expand_path(File.dirname(__FILE__) + '/../../../test_helper')
+
+module Graticule
+  module Geocoder
+    class PostcodeAnywhereTest < Test::Unit::TestCase
+
+      def setup
+        URI::HTTP.responses = []
+        URI::HTTP.uris = []
+        @geocoder = PostcodeAnywhere.new 'account_code', 'license_key'
+      end
+
+    def test_locate
+      prepare_response(:success)
+      location = Location.new(
+        :street => "204 Campbell Ave",
+        :locality => "Revelstoke",
+        :region => "BC",
+        :postal_code => "V0E",
+        :country => "Canada",
+        :longitude => -118.196970002204,
+        :latitude => 50.9997350418267
+      )
+      assert_equal location, @geocoder.locate(:street => "204 Campbell Ave",
+        :locality => "Revelstoke", :country => "Canada")
+    end
+    
+    def test_locate_uk_address
+      prepare_response(:uk)
+      
+      location = Location.new :latitude => 51.5728910186362, :longitude => -0.253788666693255
+      assert_equal location, @geocoder.locate(:street => '80 Wood Lane', :locality => 'London', :country => 'UK')
+    end
+    
+    def test_empty
+      prepare_response(:empty)
+      
+      assert_raises(Graticule::AddressError) { @geocoder.locate :street => 'foobar'}
+    end
+  
+    protected
+      def prepare_response(id)
+        URI::HTTP.responses << response('postcode_anywhere', id)
+      end
+  
+    end
+  end
+end

data/test/unit/graticule/geocoder/yahoo_test.rb

@@ -0,0 +1,48 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../../test_helper')
+
+module Graticule
+  module Geocoder
+    class YahooTest < Test::Unit::TestCase
+
+      def setup
+        URI::HTTP.responses = []
+        URI::HTTP.uris = []
+        @geocoder = Yahoo.new 'APP_ID'
+        @location = Location.new(
+          :street => "701 First Ave",
+          :locality => "Sunnyvale",
+          :region => "CA",
+          :postal_code => "94089-1019",
+          :country => "US",
+          :longitude => -122.024853,
+          :latitude => 37.416384,
+          :precision => :address
+        )
+      end
+
+    def test_locate
+      prepare_response(:success)
+      assert_equal @location, @geocoder.locate('701 First Street, Sunnyvale, CA')
+    end
+  
+    def test_url
+      prepare_response(:success)
+      @geocoder.locate('701 First Street, Sunnyvale, CA')
+      assert_equal 'http://api.local.yahoo.com/MapsService/V1/geocode?appid=APP_ID&location=701%20First%20Street,%20Sunnyvale,%20CA&output=xml',
+                   URI::HTTP.uris.first
+    end
+  
+
+    def test_locate_bad_address
+      prepare_response(:unknown_address)
+      assert_raise(Error) { @geocoder.locate('yucksthoeusthaoeusnhtaosu') }
+    end
+
+    protected
+      def prepare_response(id)
+        URI::HTTP.responses << response('yahoo', id)
+      end
+  
+    end
+  end
+end

data/test/unit/graticule/geocoder_test.rb

@@ -0,0 +1,27 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../test_helper')
+
+module Graticule
+  class GeocoderTest < Test::Unit::TestCase
+
+    def test_bogus_service
+      assert_equal Geocoder::Bogus, Graticule.service(:bogus)
+    end
+
+    def test_yahoo_service
+      assert_equal Geocoder::Yahoo, Graticule.service(:yahoo)
+    end
+
+    def test_google_service
+      assert_equal Geocoder::Google, Graticule.service(:google)
+    end
+
+    def test_geocoder_us_service
+      assert_equal Geocoder::GeocoderUs, Graticule.service(:geocoder_us)
+    end
+
+    def test_meta_carta_service
+      assert_equal Geocoder::MetaCarta, Graticule.service(:meta_carta)
+    end
+  
+  end
+end