graticule 2.3.0 → 2.4.0

data/test/graticule/geocoder/host_ip_test.rb

@@ -0,0 +1,41 @@
+# encoding: UTF-8
+require '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/graticule/geocoder/local_search_maps_test.rb

@@ -0,0 +1,31 @@
+# encoding: UTF-8
+require '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/graticule/geocoder/mapquest_test.rb

@@ -0,0 +1,56 @@
+# encoding: UTF-8
+require 'test_helper'
+
+module Graticule
+  module Geocoder
+    class MapquestTest < Test::Unit::TestCase
+      def setup
+        URI::HTTP.responses = []
+        URI::HTTP.uris = []
+        @geocoder = Mapquest.new('api_key')
+      end
+
+      def test_success
+        prepare_response(:success)
+        location = Location.new(
+          :country => "US",
+          :latitude => 44.15175,
+          :locality => "Lovell",
+          :longitude => -70.893,
+          :postal_code => "04051-3919",
+          :precision => :point,
+          :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)
+        location = Location.new(
+          :country => "US",
+          :latitude => 40.925598,
+          :locality => "Stony Brook",
+          :longitude => -73.141403,
+          :postal_code => nil,
+          :precision => :locality,
+          :region => "NY",
+          :street => nil
+        )
+        assert_equal(location, @geocoder.locate('217 Union St., NY'))
+      end
+
+      def test_query_construction
+        request = Mapquest::Request.new("217 Union St., NY", "api_key")
+        query = %Q{key=api_key&outFormat=xml&inFormat=kvp&location=217%20Union%20St.,%20NY}
+        assert_equal(query, request.query)
+      end
+
+      protected
+
+      def prepare_response(id)
+        URI::HTTP.responses << response('mapquest', id)
+      end
+    end
+  end
+end

data/test/graticule/geocoder/multi_test.rb

@@ -0,0 +1,52 @@
+# encoding: UTF-8
+require '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
+
+      def test_timeout
+        @mock = @mock_geocoders.first
+        def @mock.locate(*x)
+          sleep 1
+        end
+        @geocoder = Multi.new(@mock, :timeout => 0.1)
+        assert_raise(Timeout::Error) { @geocoder.locate('foo') }
+      end
+    end
+  end
+end

data/test/graticule/geocoder/multimap_test.rb

@@ -0,0 +1,53 @@
+# encoding: UTF-8
+require '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', :locality => 'London')
+      assert_equal 'http://clients.multimap.com/API/geocode/1.2/API_KEY?city=London&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/graticule/geocoder/simple_geo_test.rb

@@ -0,0 +1,45 @@
+# encoding: UTF-8
+require 'test_helper'
+
+module Graticule
+  module Geocoder
+    class SimpleGeoTest < Test::Unit::TestCase
+
+      def setup
+        URI::HTTP.responses = []
+        URI::HTTP.uris = []
+        @geocoder = SimpleGeo.new('TOKEN')
+      end
+
+      def test_success
+        return unless prepare_response(:success)
+
+        location = Location.new(
+          :longitude => -117.373982,
+          :latitude => 34.482358,
+          :precision => :unknown
+        )
+        assert_equal location, @geocoder.locate('1600 Amphitheatre Parkway, Mountain View, CA')
+      end
+
+      def test_error
+        prepare_response :error
+        assert_raises(Error) { @geocoder.locate('') }
+      end
+
+      def test_time_zone
+        URI::HTTP.uris = []
+        URI::HTTP.responses = []
+        URI::HTTP.responses << response('simple_geo', :success, 'json')
+        los_angeles = Location.new(:latitude => 34.48, :longitude => -117.37)
+        assert_equal 'America/Los_Angeles', @geocoder.time_zone(los_angeles)
+      end
+
+    private
+
+      def prepare_response(id = :success)
+        URI::HTTP.responses << response('simple_geo', id, 'json')
+      end
+    end
+  end
+end

data/test/graticule/geocoder/yahoo_test.rb

@@ -0,0 +1,50 @@
+# encoding: UTF-8
+require '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 1st Ave",
+          :locality => "Sunnyvale",
+          :region => "CA",
+          :postal_code => "94089-1019",
+          :country => "US",
+          :longitude => -122.025055,
+          :latitude => 37.416397,
+          :precision => :address,
+          :warning => "The exact location could not be found, here is the closest match: 701 First Ave, Sunnyvale, CA 94089"
+        )
+      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/graticule/geocoder/yandex_test.rb

@@ -0,0 +1,42 @@
+# encoding: UTF-8
+require 'test_helper'
+
+module Graticule
+  module Geocoder
+    class YandexTest < Test::Unit::TestCase
+      def setup
+        URI::HTTP.responses = []
+        URI::HTTP.uris = []
+        @geocoder = Yandex.new('APP_ID')
+      end
+
+      def test_success
+        return unless prepare_response(:success)
+
+        location = Location.new(
+          :street => "Моховая улица",
+          :locality => "Москва",
+          :country => "RU",
+          :longitude => 37.612281,
+          :latitude => 55.753342, 
+          :precision => :address
+        )
+        assert_equal location, @geocoder.locate('Россия, Москва, ул. Моховая, д.18')
+      end
+
+      def test_bad_key
+        return unless prepare_response(:badkey)
+
+        assert_raises(CredentialsError) { @geocoder.locate('x') }
+      end
+
+    protected
+
+      def prepare_response(id = :success)
+        URI::HTTP.responses << response('yandex', id)
+      end
+
+    end
+  end
+end
+

data/test/graticule/geocoder_test.rb

@@ -0,0 +1,24 @@
+# encoding: UTF-8
+require '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
+
+  end
+end

data/test/graticule/location_test.rb

@@ -0,0 +1,79 @@
+# encoding: UTF-8
+require '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
+
+    def test_blank?
+      assert Location.new.blank?
+      [:latitude, :longitude, :street, :locality, :region, :postal_code, :country].each do |attr|
+        assert !Location.new(attr => 'Foo').blank?
+      end
+    end
+
+    def test_casts_precision
+      assert_equal Precision::Region, Location.new(:precision => :region).precision
+      assert_equal Precision::Street, Location.new(:precision => Precision::Street).precision
+    end
+  end
+end