graticule 0.2.7 → 0.2.8

data/CHANGELOG.txt

@@ -1,3 +1,6 @@
+0.2.8 (2008-10-03)
+* fixed missing files from gem
+
 0.2.7 (2008-10-03)
 * Adding Multimap geocoder [Tom Taylor]
 * Added MapQuest geocoder [Andrew Selder]

data/Manifest.txt

@@ -22,6 +22,7 @@ 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/multimap.rb
 lib/graticule/geocoder/postcode_anywhere.rb
 lib/graticule/geocoder/rest.rb
 lib/graticule/geocoder/yahoo.rb
@@ -51,6 +52,9 @@ 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/multimap/missing_params.xml
+test/fixtures/responses/multimap/no_matches.xml
+test/fixtures/responses/multimap/success.xml
 test/fixtures/responses/postcode_anywhere/badkey.xml
 test/fixtures/responses/postcode_anywhere/canada.xml
 test/fixtures/responses/postcode_anywhere/empty.xml
@@ -62,11 +66,13 @@ 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/geocoders.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/multimap_test.rb
 test/unit/graticule/geocoder/postcode_anywhere_test.rb
 test/unit/graticule/geocoder/yahoo_test.rb
 test/unit/graticule/geocoder_test.rb

data/lib/graticule/geocoder/multimap.rb

@@ -0,0 +1,73 @@
+module Graticule #:nodoc:
+  module Geocoder #:nodoc:
+
+    # Multimap geocoding API
+    
+    class Multimap < Rest
+      
+      # This precision information is not complete.
+      # More details should be implemented from:
+      # http://www.multimap.com/share/documentation/clientzone/gqcodes.htm
+      
+      PRECISION = {
+        "6"=> :country,
+        "5" => :state,
+        "4" => :postal_code,
+        "3" => :city,
+        "2" => :street,
+        "1" => :address
+      }
+      
+      # Web services initializer.
+      #
+      # The +api_key+ is the Open API key that uniquely identifies your
+      # application.
+      #
+      # See http://www.multimap.com/openapi/
+      
+      def initialize(api_key)
+        @api_key = api_key
+        @url = URI.parse "http://clients.multimap.com/API/geocode/1.2/#{@api_key}"
+      end
+      
+      # Returns a location for an address in the form of a String, Hash or Location.
+      
+      def locate(address)
+        location = address.is_a?(String) ? address : location_from_params(address)
+        case location
+        when String
+          get :qs => location
+        when Location
+          get "street" => location.street, 
+              "region" => location.region, 
+              "city" => location.city, 
+              "postalCode" => location.postal_code, 
+              "countryCode" => location.country
+        end
+      end
+      
+      def parse_response(xml)
+        r = xml.elements['Results/Location[1]']
+        returning Location.new do |location|
+          
+          location.precision = PRECISION[r.attributes['geocodeQuality']] || :unknown
+          
+          location.street = r.elements['Address/Street'].text.titleize unless r.elements['Address/Street'].nil?
+          location.locality = r.elements['Address/Areas/Area'].text.titleize unless r.elements['Address/Areas/Area'].nil?
+          location.region = r.elements['Address/State'].text.titleize unless r.elements['Address/State'].nil?
+          location.postal_code = r.elements['Address/PostalCode'].text unless r.elements['Address/PostalCode'].nil?
+          location.country = r.elements['Address/CountryCode'].text
+          
+          location.latitude = r.elements['Point/Lat'].text.to_f
+          location.longitude = r.elements['Point/Lon'].text.to_f
+        end
+      end
+      
+      def check_error(xml)
+        error = xml.elements['Results'].attributes['errorCode']
+        raise Error, error unless error.nil?
+      end
+      
+    end
+  end
+end

data/lib/graticule/version.rb

@@ -2,7 +2,7 @@ module Graticule #:nodoc:
   module Version #:nodoc:
     MAJOR = 0
     MINOR = 2
-    TINY = 7
+    TINY = 8
   
     STRING = [MAJOR, MINOR, TINY].join('.')
   end

data/test/fixtures/responses/multimap/missing_params.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8" ?> 
+<Results xmlns="http://clients.multimap.com/API" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
+xsi:schemaLocation="http://clients.multimap.com/API http://clients.multimap.com/Schema/geocode_1.2.xsd" 
+errorCode="MM_GEOCODE_REQUIRED_PARAMETERS_MISSING" locationCount="0" />

data/test/fixtures/responses/multimap/no_matches.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8" ?> 
+<Results xmlns="http://clients.multimap.com/API" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
+xsi:schemaLocation="http://clients.multimap.com/API http://clients.multimap.com/Schema/geocode_1.2.xsd" 
+errorCode="MM_GEOCODE_NO_MATCHES" locationCount="0" />

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

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<Results xmlns="http://clients.multimap.com/API" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
+xsi:schemaLocation="http://clients.multimap.com/API http://clients.multimap.com/Schema/geocode_1.2.xsd" locationCount="1">
+ <Location geocodeQuality="1">
+  <Address>
+    <Street>Oxford Street</Street>
+   <Areas>
+    <Area>LONDON</Area> 
+   </Areas>
+    <PostalCode>W1</PostalCode>
+    <DisplayName>Oxford Street, LONDON, W1</DisplayName> 
+    <CountryCode>GB</CountryCode> 
+  </Address>
+  <Point>
+    <Lat>51.51452</Lat>
+    <Lon>-0.14839</Lon>
+  </Point>
+ </Location>
+</Results>

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: graticule
 version: !ruby/object:Gem::Version 
-  version: 0.2.7
+  version: 0.2.8
 platform: ruby
 authors: 
 - Brandon Keepers
@@ -74,6 +74,7 @@ files:
 - lib/graticule/geocoder/map_quest.rb
 - lib/graticule/geocoder/meta_carta.rb
 - lib/graticule/geocoder/multi.rb
+- lib/graticule/geocoder/multimap.rb
 - lib/graticule/geocoder/postcode_anywhere.rb
 - lib/graticule/geocoder/rest.rb
 - lib/graticule/geocoder/yahoo.rb
@@ -103,6 +104,9 @@ files:
 - 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/multimap/missing_params.xml
+- test/fixtures/responses/multimap/no_matches.xml
+- test/fixtures/responses/multimap/success.xml
 - test/fixtures/responses/postcode_anywhere/badkey.xml
 - test/fixtures/responses/postcode_anywhere/canada.xml
 - test/fixtures/responses/postcode_anywhere/empty.xml
@@ -114,11 +118,13 @@ files:
 - test/test_helper.rb
 - test/unit/graticule/distance_test.rb
 - test/unit/graticule/geocoder/geocoder_us_test.rb
+- test/unit/graticule/geocoder/geocoders.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/multimap_test.rb
 - test/unit/graticule/geocoder/postcode_anywhere_test.rb
 - test/unit/graticule/geocoder/yahoo_test.rb
 - test/unit/graticule/geocoder_test.rb