graticule 0.1.3 → 0.2.0

data/lib/graticule/geocoders/yahoo.rb

@@ -1,101 +0,0 @@
-module Graticule #:nodoc:
-  
-  # Yahoo geocoding API.
-  #
-  # http://developer.yahoo.com/maps/rest/V1/geocode.html
-  class YahooGeocoder < RestGeocoder
-
-    PRECISION = {
-      "country"=> :country,
-      "state" => :state,
-      "city" => :city,
-      "zip+4" => :zip,
-      "zip+2" => :zip,
-      "zip" => :zip,
-      "street" => :street,
-      "address" => :address
-    }
-
-    # Web services initializer.
-    #
-    # The +appid+ is the Application ID that uniquely identifies your
-    # application.  See: http://developer.yahoo.com/faq/index.html#appid
-    #
-    # Concrete web services implementations need to set the following instance
-    # variables then call super:
-    #
-    # +host+:: API endpoint hostname
-    # +service_name+:: service name
-    # +version+:: service name version number
-    # +method+:: service method call
-    #
-    # See http://developer.yahoo.com/search/rest.html
-    def initialize(appid)
-      @host = 'api.local.yahoo.com'
-      @service_name = 'MapsService'
-      @version = 'V1'
-      @method = 'geocode'
-      @appid = appid
-      @url = URI.parse "http://#{@host}/#{@service_name}/#{@version}/#{@method}"
-    end
-
-    # Returns a Location for +address+.
-    #
-    # The +address+ can be any of:
-    # * city, state
-    # * city, state, zip
-    # * zip
-    # * street, city, state
-    # * street, city, state, zip
-    # * street, zip
-    def locate(address)
-      get :location => address
-    end
-
-    def parse_response(xml) # :nodoc:
-      locations = []
-
-      xml.elements['ResultSet'].each do |r|
-        location = Location.new
-
-        location.precision = PRECISION[r.attributes['precision']] || :unknown
-
-        if r.attributes.include? 'warning' then
-          location.warning = r.attributes['warning']
-        end
-
-        location.latitude = r.elements['Latitude'].text.to_f
-        location.longitude = r.elements['Longitude'].text.to_f
-
-        location.street = r.elements['Address'].text.titleize unless r.elements['Address'].text.blank?
-        location.city = r.elements['City'].text.titleize unless r.elements['City'].text.blank?
-        location.state = r.elements['State'].text
-        location.zip = r.elements['Zip'].text
-        location.country = r.elements['Country'].text
-
-        locations << location
-      end
-
-      # FIXME: make API consistent and only return 1 location
-      return locations
-    end
-
-    # Extracts and raises an error from +xml+, if any.
-    def check_error(xml) #:nodoc:
-      err = xml.elements['Error']
-      raise Error, err.elements['Message'].text if err
-    end
-
-    # Creates a URL from the Hash +params+.  Automatically adds the appid and
-    # sets the output type to 'xml'.
-    def make_url(params) #:nodoc:
-      params[:appid] = @appid
-      params[:output] = 'xml'
-
-      super params
-    end
-
-  end
-
-  
-end

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

@@ -1,42 +0,0 @@
-require File.dirname(__FILE__) + '/../../../test_helper'
-require File.dirname(__FILE__) + '/geocoders'
-
-module Graticule
-  class GeocoderUsTest < Test::Unit::TestCase
-
-    def setup
-      URI::HTTP.responses = []
-      URI::HTTP.uris = []
-
-      @geocoder = GeocoderUsGeocoder.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

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

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

@@ -1,22 +0,0 @@
-require File.dirname(__FILE__) + '/../../../test_helper'
-require File.dirname(__FILE__) + '/geocoders'
-
-module Graticule
-  class GoogleGeocoderTest < Test::Unit::TestCase
-    # run tests from GeocodersTest
-    include GeocodersTestCase
-    
-    def setup
-      URI::HTTP.responses = []
-      URI::HTTP.uris = []
-      @geocoder = GoogleGeocoder.new(:key => 'APP_ID')
-    end
-    
-    protected
-
-      def prepare_response(id = :success)
-        URI::HTTP.responses << response('google', id)
-      end
-    
-  end
-end

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

@@ -1,70 +0,0 @@
-require File.dirname(__FILE__) + '/../../../test_helper'
-require File.dirname(__FILE__) + '/geocoders'
-
-module Graticule
-  class MetaCartaGeocoderTest < Test::Unit::TestCase
-
-    def setup
-      URI::HTTP.responses = []
-      URI::HTTP.uris = []
-
-      @geocoder = MetaCartaGeocoder.new
-    end
-
-    def test_locate
-      prepare_response(:success)
-
-      expected = MetaCartaGeocoder::Location.new 'Baghdad', 'PPLC', 5672516,
-                                                  'Iraq/Baghdad/Baghdad',
-                                                  44.393889, 33.338611, 0.195185,
-                                                  [[26.238611, 37.293889],
-                                                   [40.438611, 51.493889]]
-
-      location = @geocoder.locate('baghdad')
-      assert_equal expected, location
-      assert_equal [44.393889, 33.338611], location.coordinates
-
-      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 = [
-        MetaCartaGeocoder::Location.new('Seattle', 'PPL', 563374,
-                                         'United States/Washington/King/Seattle',
-                                         -122.33083, 47.60639, nil,
-                                         [[43.806390, -126.130830],
-                                          [51.406390, -118.530830]]),
-        MetaCartaGeocoder::Location.new('Seattle', 'PRT', nil,
-                                         'United States/Seattle',
-                                         -122.333333, 47.6, nil,
-                                         [[43.8, -126.133333],
-                                          [51.4, -118.533333]]),
-      ]
-
-      locations, viewbox = @geocoder.locations('seattle')
-      assert_equal expected, locations
-      assert_equal [[43.8, -126.133333], [51.40639, -118.53083]], viewbox
-
-      assert_equal true, URI::HTTP.responses.empty?
-      assert_equal 1, URI::HTTP.uris.length
-      assert_equal 'http://labs.metacarta.com/GeoParser/?loc=seattle&output=locations',
-                   URI::HTTP.uris.first
-    end
-
-  protected
-    def prepare_response(id = :success)
-      URI::HTTP.responses << response('meta_carta', id)
-    end
-
-  end
-end

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

@@ -1,49 +0,0 @@
-require File.dirname(__FILE__) + '/../../../test_helper'
-require File.dirname(__FILE__) + '/geocoders'
-
-module Graticule
-  class YahooGeocoderTest < Test::Unit::TestCase
-    #include GeocodersTestCase
-
-    def setup
-      URI::HTTP.responses = []
-      URI::HTTP.uris = []
-      @geocoder = YahooGeocoder.new 'APP_ID'
-      @location = Location.new(
-        :street => "701 First Ave",
-        :city => "Sunnyvale",
-        :state => "CA",
-        :zip => "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