norman-graticule 0.2.7

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

@@ -0,0 +1,107 @@
+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
+      
+      # <?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
+        )
+        
+        assert_equal location, @geocoder.locate('sf ca')
+      end
+
+      def test_locate_with_first
+        prepare_response(:multiple)
+        location = Location.new(
+          :locality => "Gardiner",
+          :region => "ME",
+          :country => "US",
+          :longitude => -69.802949,
+          :latitude => 44.198024
+        )
+        assert @geocoder.locate(:first, 'Gardiner')
+      end
+
+      def test_locate_with_all
+        prepare_response(:multiple)
+        assert_equal 3, @geocoder.locate(:all, 'Gardiner').size
+      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.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.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.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/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,58 @@
+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_locate_with_first
+      prepare_response(:success)
+      assert_equal @location, @geocoder.locate(:first, '701 First Street, Sunnyvale, CA')
+    end
+
+    def test_locate_with_all
+      prepare_response(:multiple)
+      assert_equal 4, @geocoder.locate(:all, 'Gardiner').size
+    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.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

data/test/unit/graticule/location_test.rb

@@ -0,0 +1,66 @@
+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
+      chicago = Location.new(:latitude => 41.85, :longitude => -87.65)
+      assert_in_delta 594.820, @washington_dc.distance_to(chicago), 1.0
+    end
+    
+    def test_responds_to
+      [: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
+  
+    def test_coordinates
+      l = Location.new(:latitude => 100, :longitude => 50)
+      assert_equal [100, 50], l.coordinates
+    end
+    
+    def test_equal
+      assert_equal Location.new, Location.new
+
+      attrs = {:latitude => 100.5389, :longitude => -147.5893, :street => '123 A Street',
+          :locality => 'Somewhere', :region => 'NO', :postal_code => '12345', :country => 'USA'}
+      
+      assert_equal Location.new(attrs), Location.new(attrs)
+      attrs.each do |k,v|
+        assert_equal Location.new(k => v), Location.new(k => v)
+        assert_not_equal Location.new, Location.new(k => v)
+        assert_not_equal Location.new(attrs), Location.new(attrs.update(k => nil))
+      end
+    end
+    
+    def test_antipode
+      chicago = Location.new(:latitude => 41.85, :longitude => -87.65)
+      
+      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 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

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification 
+name: norman-graticule
+version: !ruby/object:Gem::Version 
+  version: 0.2.7
+platform: ruby
+authors: 
+- Brandon Keepers
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-07-09 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Graticule is a geocoding API that provides a common interface to all the popular services, including Google, Yahoo, Geocoder.us, and MetaCarta.
+email: brandon@opensoul.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG.txt
+- README.txt
+files: 
+- CHANGELOG.txt
+- LICENSE.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- bin/geocode
+- init.rb
+- lib/graticule.rb
+- lib/graticule/cli.rb
+- lib/graticule/distance.rb
+- lib/graticule/distance/haversine.rb
+- lib/graticule/distance/spherical.rb
+- lib/graticule/distance/vincenty.rb
+- lib/graticule/geocoder.rb
+- lib/graticule/geocoder/base.rb
+- lib/graticule/geocoder/bogus.rb
+- lib/graticule/geocoder/geocoder_ca.rb
+- lib/graticule/geocoder/geocoder_us.rb
+- lib/graticule/geocoder/google.rb
+- lib/graticule/geocoder/host_ip.rb
+- lib/graticule/geocoder/local_search_maps.rb
+- lib/graticule/geocoder/map_quest.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
+- lib/graticule/location.rb
+- lib/graticule/version.rb
+has_rdoc: true
+homepage: http://graticule.rubyforge.org
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: API for using all the popular geocoding services.
+test_files: 
+- test/config.yml.default
+- test/fixtures/responses/geocoder_us/success.xml
+- test/fixtures/responses/geocoder_us/unknown.xml
+- test/fixtures/responses/google/badkey.xml
+- test/fixtures/responses/google/limit.xml
+- test/fixtures/responses/google/missing_address.xml
+- test/fixtures/responses/google/only_coordinates.xml
+- test/fixtures/responses/google/partial.xml
+- test/fixtures/responses/google/server_error.xml
+- test/fixtures/responses/google/success.xml
+- test/fixtures/responses/google/unavailable.xml
+- test/fixtures/responses/google/unknown_address.xml
+- test/fixtures/responses/host_ip/private.txt
+- test/fixtures/responses/host_ip/success.txt
+- test/fixtures/responses/host_ip/unknown.txt
+- test/fixtures/responses/local_search_maps/empty.txt
+- test/fixtures/responses/local_search_maps/not_found.txt
+- test/fixtures/responses/local_search_maps/success.txt
+- test/fixtures/responses/meta_carta/bad_address.xml
+- test/fixtures/responses/meta_carta/multiple.xml
+- test/fixtures/responses/meta_carta/success.xml
+- test/fixtures/responses/postcode_anywhere/badkey.xml
+- test/fixtures/responses/postcode_anywhere/canada.xml
+- test/fixtures/responses/postcode_anywhere/empty.xml
+- test/fixtures/responses/postcode_anywhere/success.xml
+- test/fixtures/responses/postcode_anywhere/uk.xml
+- test/fixtures/responses/yahoo/success.xml
+- test/fixtures/responses/yahoo/unknown_address.xml
+- test/mocks/uri.rb
+- test/test_helper.rb
+- test/unit/graticule/distance_test.rb
+- test/unit/graticule/geocoder/geocoder_us_test.rb
+- 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
+- test/unit/graticule/location_test.rb