graticule 0.1.3 → 0.2.0

data/test/fixtures/responses/postcode_anywhere/success.xml

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<PostcodeAnywhere Server="WS11" Version="3.0" Date="17/03/2007 18:12:11" Duration="1.703s">
+  <Schema Items="8">
+    <Field Name="line1"/>
+    <Field Name="line2"/>
+    <Field Name="city"/>
+    <Field Name="state"/>
+    <Field Name="postal_code"/>
+    <Field Name="country"/>
+    <Field Name="longitude"/>
+    <Field Name="latitude"/>
+  </Schema>
+  <Data Items="1">
+    <Item line1="204 Campbell Ave" city="Revelstoke" state="BC" postal_code="V0E" country="Canada" longitude="-118.196970002204" latitude="50.9997350418267"/>
+  </Data>
+</PostcodeAnywhere>

data/test/fixtures/responses/postcode_anywhere/uk.xml

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<PostcodeAnywhere Server="WS12" Version="3.0" Date="17/03/2007 19:01:39" Duration="2.422s">
+  <Schema Items="10">
+    <Field Name="id"/>
+    <Field Name="seq"/>
+    <Field Name="location"/>
+    <Field Name="grid_east_m"/>
+    <Field Name="grid_north_m"/>
+    <Field Name="longitude"/>
+    <Field Name="latitude"/>
+    <Field Name="os_reference"/>
+    <Field Name="wgs84_longitude"/>
+    <Field Name="wgs84_latitude"/>
+  </Schema>
+  <Data Items="1">
+    <Item id="17783983.00" seq="0" location="80 Wood Lane London NW9" grid_east_m="521000" grid_north_m="187500" longitude="-0.253788666693255" latitude="51.5728910186362" os_reference="TQ 21000 87500" wgs84_longitude="-0.255365891581496" wgs84_latitude="51.5733397173092"/>
+  </Data>
+</PostcodeAnywhere>

data/test/test_helper.rb

@@ -9,14 +9,16 @@ require 'test/unit'
 require 'breakpoint'
 require 'graticule'
 
+TEST_RESPONSE_PATH = File.dirname(__FILE__) + '/fixtures/responses'
+
 module Test
   module Unit
     module Assertions
       
       private
-        def response(geocoder, response)
+        def response(geocoder, response, extension = 'xml')
           clean_backtrace do
-            File.read(File.dirname(__FILE__) + "/fixtures/responses/#{geocoder}/#{response}.xml")
+            File.read(File.dirname(__FILE__) + "/fixtures/responses/#{geocoder}/#{response}.#{extension}")
           end
         end
       

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

@@ -0,0 +1,43 @@
+require 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/google_test.rb

@@ -0,0 +1,66 @@
+require 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
+    
+      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,39 @@
+require 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.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/meta_carta_test.rb

@@ -0,0 +1,44 @@
+require 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.393889, :longitude => 33.338611
+        
+        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/postcode_anywhere_test.rb

@@ -0,0 +1,50 @@
+# account code: INDIV30777
+# license key: KG39-HM17-PZ95-NR98
+require 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.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

@@ -3,28 +3,24 @@ require File.dirname(__FILE__) + '/../../test_helper'
 module Graticule
   class GeocoderTest < Test::Unit::TestCase
 
-    def test_cannot_instantiate
-      assert_raises(NotImplementedError) { Geocoder.new }
-    end
-    
     def test_bogus_service
-      assert_equal BogusGeocoder, Graticule.service(:bogus)
+      assert_equal Geocoder::Bogus, Graticule.service(:bogus)
     end
 
     def test_yahoo_service
-      assert_equal YahooGeocoder, Graticule.service(:yahoo)
+      assert_equal Geocoder::Yahoo, Graticule.service(:yahoo)
     end
 
     def test_google_service
-      assert_equal GoogleGeocoder, Graticule.service(:google)
+      assert_equal Geocoder::Google, Graticule.service(:google)
     end
 
     def test_geocoder_us_service
-      assert_equal GeocoderUsGeocoder, Graticule.service(:geocoder_us)
+      assert_equal Geocoder::GeocoderUs, Graticule.service(:geocoder_us)
     end
 
     def test_meta_carta_service
-      assert_equal MetaCartaGeocoder, Graticule.service(:meta_carta)
+      assert_equal Geocoder::MetaCarta, Graticule.service(:meta_carta)
     end
   
   end

data/test/unit/graticule/location_test.rb

@@ -3,14 +3,19 @@ require File.dirname(__FILE__) + '/../../test_helper'
 module Graticule
   class LocationTest < Test::Unit::TestCase
     
+    def setup
+      @washington_dc = Location.new :latitude => 38.898748, :longitude => -77.037684,
+        :street => '1600 Pennsylvania Avenue, NW', :locality => 'Washington',
+        :region => 'DC', :postal_code => 20500, :country => 'US'
+    end
+    
     def test_distance_to
-      washington_dc = Location.new(:latitude => 38.898748, :longitude => -77.037684)
       chicago = Location.new(:latitude => 41.85, :longitude => -87.65)
-      assert_in_delta 594.820, washington_dc.distance_to(chicago), 1.0
+      assert_in_delta 594.820, @washington_dc.distance_to(chicago), 1.0
     end
     
     def test_responds_to
-      [:latitude, :longitude, :street, :city, :state, :zip, :country, :coordinates, :precision].each do |m|
+      [:latitude, :longitude, :street, :locality, :region, :postal_code, :country, :coordinates, :precision].each do |m|
         assert Location.new.respond_to?(m), "should respond to #{m}"
       end
     end
@@ -24,7 +29,7 @@ module Graticule
       assert_equal Location.new, Location.new
 
       attrs = {:latitude => 100.5389, :longitude => -147.5893, :street => '123 A Street',
-          :city => 'Somewhere', :state => 'NO', :zip => '12345', :country => 'USA', :precision => :address}
+          :locality => 'Somewhere', :region => 'NO', :postal_code => '12345', :country => 'USA', :precision => :address}
       
       assert_equal Location.new(attrs), Location.new(attrs)
       attrs.each do |k,v|
@@ -35,17 +40,27 @@ module Graticule
     end
     
     def test_antipode
-      washington_dc = Location.new(:latitude => 38.898748, :longitude => -77.037684)
       chicago = Location.new(:latitude => 41.85, :longitude => -87.65)
       
-      assert_equal [-38.898748, 102.962316], washington_dc.antipode.coordinates
+      assert_equal [-38.898748, 102.962316], @washington_dc.antipode.coordinates
       assert_equal [-41.85, 92.35], chicago.antipode.coordinates
       assert_equal [-41, -180], Graticule::Location.new(:latitude => 41, :longitude => 0).antipode.coordinates
       assert_equal [-41, 179], Graticule::Location.new(:latitude => 41, :longitude => -1).antipode.coordinates
       assert_equal [-41, -179], Graticule::Location.new(:latitude => 41, :longitude => 1).antipode.coordinates
       
-      assert_equal washington_dc.coordinates, washington_dc.antipode.antipode.coordinates
+      assert_equal @washington_dc.coordinates, @washington_dc.antipode.antipode.coordinates
       assert_equal chicago.coordinates, chicago.antipode.antipode.coordinates
     end
+    
+    def test_to_s
+      assert_equal "1600 Pennsylvania Avenue, NW\nWashington, DC 20500 US",
+        @washington_dc.to_s
+      assert_equal "1600 Pennsylvania Avenue, NW\nWashington, DC 20500",
+        @washington_dc.to_s(:country => false)
+      assert_equal "1600 Pennsylvania Avenue, NW\nWashington, DC 20500",
+        @washington_dc.to_s(:country => false)
+      assert_equal "1600 Pennsylvania Avenue, NW\nWashington, DC 20500\nlatitude: 38.898748, longitude: -77.037684",
+        @washington_dc.to_s(:country => false, :coordinates => true)
+    end
   end
 end