graticule 0.2.8 → 0.2.9

data/CHANGELOG.txt

@@ -1,3 +1,8 @@
+0.2.9 (2009-04-14)
+* Remove retired MapQuest geocoder
+* Slightly more aggressive error handling for Geocoder.us
+* Extend Numeric with #to_radians and #to_degrees
+
 0.2.8 (2008-10-03)
 * fixed missing files from gem
 

data/Manifest.txt

@@ -7,6 +7,7 @@ bin/geocode
 init.rb
 lib/graticule.rb
 lib/graticule/cli.rb
+lib/graticule/core_ext.rb
 lib/graticule/distance.rb
 lib/graticule/distance/haversine.rb
 lib/graticule/distance/spherical.rb
@@ -19,7 +20,6 @@ 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/multimap.rb
@@ -41,6 +41,7 @@ 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/success_multiple_results.xml
 test/fixtures/responses/google/unavailable.xml
 test/fixtures/responses/google/unknown_address.xml
 test/fixtures/responses/host_ip/private.txt

data/README.txt

@@ -26,4 +26,4 @@ Graticule includes a command line interface (CLI).
 
 = Source
 
-The source code for Graticule is available at http://source.collectiveidea.com/public/geocode/trunk
+The source code for Graticule is available at http://github.com/collectiveidea/graticule. Patches and bug reports are welcome at http://collectiveidea.lighthouseapp.com/projects/20262-graticule

data/lib/graticule.rb

@@ -3,6 +3,7 @@ $:.unshift(File.dirname(__FILE__))
 require 'active_support'
 
 require 'graticule/version'
+require 'graticule/core_ext'
 require 'graticule/location'
 require 'graticule/geocoder'
 require 'graticule/geocoder/base'
@@ -10,7 +11,6 @@ require 'graticule/geocoder/bogus'
 require 'graticule/geocoder/rest'
 require 'graticule/geocoder/google'
 require 'graticule/geocoder/host_ip'
-require 'graticule/geocoder/map_quest'
 require 'graticule/geocoder/multi'
 require 'graticule/geocoder/yahoo'
 require 'graticule/geocoder/geocoder_ca'

data/lib/graticule/core_ext.rb

@@ -0,0 +1,15 @@
+module Graticule
+  module RadiansAndDegrees
+    # Convert from degrees to radians
+    def to_radians
+      ( self / 360.0 ) * Math::PI * 2
+    end
+  
+    # Convert from radians to degrees
+    def to_degrees
+      ( self * 360.0 ) / Math::PI / 2
+    end
+  end
+end
+
+Numeric.send :include, Graticule::RadiansAndDegrees

data/lib/graticule/distance.rb

@@ -13,17 +13,6 @@ module Graticule
       def initialize
         raise NotImplementedError
       end
-      
-      # Convert from degrees to radians
-      def self.deg2rad(deg)
-      	(deg * PI / 180)
-      end
-
-      # Convert from radians to degrees
-      def self.rad2deg(rad)
-      	(rad * 180 / PI)
-      end
-
     end
   end
 end

data/lib/graticule/distance/haversine.rb

@@ -17,10 +17,10 @@ module Graticule
       #   #=> 101.061720831836
       #
       def self.distance(from, to, units = :miles)
-        from_longitude  = deg2rad(from.longitude)
-        from_latitude   = deg2rad(from.latitude)
-        to_longitude    = deg2rad(to.longitude)
-        to_latitude     = deg2rad(to.latitude)
+        from_longitude  = from.longitude.to_radians
+        from_latitude   = from.latitude.to_radians
+        to_longitude    = to.longitude.to_radians
+        to_latitude     = to.latitude.to_radians
 
         latitude_delta  = to_latitude - from_latitude
         longitude_delta = to_longitude - from_longitude

data/lib/graticule/distance/spherical.rb

@@ -16,10 +16,10 @@ module Graticule
       #   #=> 101.061720831853
       #
       def self.distance(from, to, units = :miles)
-        from_longitude   = deg2rad(from.longitude)
-        from_latitude    = deg2rad(from.latitude)
-        to_longitude  = deg2rad(to.longitude)
-        to_latitude   = deg2rad(to.latitude)
+        from_longitude  = from.longitude.to_radians
+        from_latitude   = from.latitude.to_radians
+        to_longitude    = to.longitude.to_radians
+        to_latitude     = to.latitude.to_radians
 
         Math.acos(
             Math.sin(from_latitude) *

data/lib/graticule/distance/vincenty.rb

@@ -18,10 +18,10 @@ module Graticule
       #   #=> 101.070118000159
       #
       def self.distance(from, to, units = :miles)
-        from_longitude   = deg2rad(from.longitude)
-        from_latitude    = deg2rad(from.latitude)
-        to_longitude  = deg2rad(to.longitude)
-        to_latitude   = deg2rad(to.latitude)
+        from_longitude  = from.longitude.to_radians
+        from_latitude   = from.latitude.to_radians
+        to_longitude    = to.longitude.to_radians
+        to_latitude     = to.latitude.to_radians
         
         earth_major_axis_radius = EARTH_MAJOR_AXIS_RADIUS[units.to_sym]
         earth_minor_axis_radius = EARTH_MINOR_AXIS_RADIUS[units.to_sym]

data/lib/graticule/geocoder/geocoder_us.rb

@@ -42,6 +42,8 @@ module Graticule #:nodoc:
 
       def check_error(xml) #:nodoc:
         raise AddressError, xml.text if xml.text =~ /couldn't find this address! sorry/
+        raise Error, xml.text if xml.text =~ /Your browser sent a request that this server could not understand./
+        raise Error, xml.text if !(xml.text =~ /geo:Point/)
       end
 
     end

data/lib/graticule/geocoder/google.rb

@@ -47,11 +47,11 @@ module Graticule #:nodoc:
             'xal' => "urn:oasis:names:tc:ciq:xsdschema:xAL:2.0")
 
           if address
-            l.street = value(address.elements['//ThoroughfareName/text()'])
-            l.locality = value(address.elements['//LocalityName/text()'])
-            l.region = value(address.elements['//AdministrativeAreaName/text()'])
-            l.postal_code = value(address.elements['//PostalCodeNumber/text()'])
-            l.country = value(address.elements['//CountryNameCode/text()'])
+            l.street = value(address.elements['.//ThoroughfareName/text()'])
+            l.locality = value(address.elements['.//LocalityName/text()'])
+            l.region = value(address.elements['.//AdministrativeAreaName/text()'])
+            l.postal_code = value(address.elements['.//PostalCodeNumber/text()'])
+            l.country = value(address.elements['.//CountryNameCode/text()'])
             l.precision = PRECISION[address.attribute('Accuracy').value.to_i] || :unknown
           end
         end

data/lib/graticule/location.rb

@@ -15,7 +15,7 @@ module Graticule
     end
     
     def attributes
-      [:latitude, :longitude, :street, :locality, :region, :postal_code, :country].inject({}) do |result,attr|
+      [:latitude, :longitude, :street, :locality, :region, :postal_code, :country, :precision].inject({}) do |result,attr|
         result[attr] = self.send(attr) unless self.send(attr).blank?
         result
       end

data/lib/graticule/version.rb

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

data/site/stylesheets/style.css

@@ -54,10 +54,6 @@ a {
   padding: 1em 0;
 }
 
-pre {
-  background-color: #2A2A2A;
-}
-
 dl {
   background-color: #DDD;
   padding: 1em;

data/test/fixtures/responses/google/success_multiple_results.xml

@@ -0,0 +1,88 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<kml xmlns='http://earth.google.com/kml/2.0'><Response>
+  <name>Queen St West</name>
+  <Status>
+    <code>200</code>
+    <request>geocode</request>
+  </Status>
+  <Placemark id='p1'>
+    <address>Queen St W, Toronto, ON, Canada</address>
+    <AddressDetails Accuracy='6' xmlns='urn:oasis:names:tc:ciq:xsdschema:xAL:2.0'><Country><CountryNameCode>CA</CountryNameCode><CountryName>Canada</CountryName><AdministrativeArea><AdministrativeAreaName>ON</AdministrativeAreaName><Locality><LocalityName>Toronto</LocalityName><Thoroughfare><ThoroughfareName>Queen St W</ThoroughfareName></Thoroughfare></Locality></AdministrativeArea></Country></AddressDetails>
+    <ExtendedData>
+      <LatLonBox east='-79.3792510' south='43.6387420' west='-79.4460830' north='43.6524210'/>
+    </ExtendedData>
+    <Point><coordinates>-79.4125590,43.6455030,0</coordinates></Point>
+  </Placemark>
+  <Placemark id='p2'>
+    <address>Queen St W, Brampton, ON, Canada</address>
+    <AddressDetails Accuracy='6' xmlns='urn:oasis:names:tc:ciq:xsdschema:xAL:2.0'><Country><CountryNameCode>CA</CountryNameCode><CountryName>Canada</CountryName><AdministrativeArea><AdministrativeAreaName>ON</AdministrativeAreaName><Locality><LocalityName>Brampton</LocalityName><Thoroughfare><ThoroughfareName>Queen St W</ThoroughfareName></Thoroughfare></Locality></AdministrativeArea></Country></AddressDetails>
+    <ExtendedData>
+      <LatLonBox east='-79.7599410' south='43.6477210' west='-79.8030440' north='43.6859000'/>
+    </ExtendedData>
+    <Point><coordinates>-79.7814960,43.6665410,0</coordinates></Point>
+  </Placemark>
+  <Placemark id='p3'>
+    <address>Queen St W, Levin, 5510, New Zealand</address>
+    <AddressDetails Accuracy='6' xmlns='urn:oasis:names:tc:ciq:xsdschema:xAL:2.0'><Country><CountryNameCode>NZ</CountryNameCode><CountryName>New Zealand</CountryName><Locality><LocalityName>Levin</LocalityName><Thoroughfare><ThoroughfareName>Queen St W</ThoroughfareName></Thoroughfare><PostalCode><PostalCodeNumber>5510</PostalCodeNumber></PostalCode></Locality></Country></AddressDetails>
+    <ExtendedData>
+      <LatLonBox east='175.2872230' south='-40.6221080' west='175.2645080' north='-40.6111560'/>
+    </ExtendedData>
+    <Point><coordinates>175.2753040,-40.6170160,0</coordinates></Point>
+  </Placemark>
+  <Placemark id='p4'>
+    <address>Queen St W, Mt Forest, ON, Canada</address>
+    <AddressDetails Accuracy='6' xmlns='urn:oasis:names:tc:ciq:xsdschema:xAL:2.0'><Country><CountryNameCode>CA</CountryNameCode><CountryName>Canada</CountryName><AdministrativeArea><AdministrativeAreaName>ON</AdministrativeAreaName><Locality><LocalityName>Mt Forest</LocalityName><Thoroughfare><ThoroughfareName>Queen St W</ThoroughfareName></Thoroughfare><PostalCode><PostalCodeNumber>N0G</PostalCodeNumber></PostalCode></Locality></AdministrativeArea></Country></AddressDetails>
+    <ExtendedData>
+      <LatLonBox east='-80.7320620' south='43.9748569' west='-80.7542680' north='43.9811521'/>
+    </ExtendedData>
+    <Point><coordinates>-80.7434380,43.9779890,0</coordinates></Point>
+  </Placemark>
+  <Placemark id='p5'>
+    <address>Queen St W, St Marys, ON, Canada</address>
+    <AddressDetails Accuracy='6' xmlns='urn:oasis:names:tc:ciq:xsdschema:xAL:2.0'><Country><CountryNameCode>CA</CountryNameCode><CountryName>Canada</CountryName><AdministrativeArea><AdministrativeAreaName>ON</AdministrativeAreaName><Locality><LocalityName>St Marys</LocalityName><Thoroughfare><ThoroughfareName>Queen St W</ThoroughfareName></Thoroughfare><PostalCode><PostalCodeNumber>N4X</PostalCodeNumber></PostalCode></Locality></AdministrativeArea></Country></AddressDetails>
+    <ExtendedData>
+      <LatLonBox east='-81.1442510' south='43.2548039' west='-81.1674090' north='43.2610991'/>
+    </ExtendedData>
+    <Point><coordinates>-81.1556430,43.2579490,0</coordinates></Point>
+  </Placemark>
+  <Placemark id='p6'>
+    <address>Queen St W, Barrie, ON, Canada</address>
+    <AddressDetails Accuracy='6' xmlns='urn:oasis:names:tc:ciq:xsdschema:xAL:2.0'><Country><CountryNameCode>CA</CountryNameCode><CountryName>Canada</CountryName><AdministrativeArea><AdministrativeAreaName>ON</AdministrativeAreaName><Locality><LocalityName>Barrie</LocalityName><Thoroughfare><ThoroughfareName>Queen St W</ThoroughfareName></Thoroughfare><PostalCode><PostalCodeNumber>L0L</PostalCodeNumber></PostalCode></Locality></AdministrativeArea></Country></AddressDetails>
+    <ExtendedData>
+      <LatLonBox east='-79.8661300' south='44.5748470' west='-79.8859520' north='44.5835790'/>
+    </ExtendedData>
+    <Point><coordinates>-79.8762460,44.5791840,0</coordinates></Point>
+  </Placemark>
+  <Placemark id='p7'>
+    <address>Queen St W, Owen Sound, ON, Canada</address>
+    <AddressDetails Accuracy='6' xmlns='urn:oasis:names:tc:ciq:xsdschema:xAL:2.0'><Country><CountryNameCode>CA</CountryNameCode><CountryName>Canada</CountryName><AdministrativeArea><AdministrativeAreaName>ON</AdministrativeAreaName><Locality><LocalityName>Owen Sound</LocalityName><Thoroughfare><ThoroughfareName>Queen St W</ThoroughfareName></Thoroughfare><PostalCode><PostalCodeNumber>N0H</PostalCodeNumber></PostalCode></Locality></AdministrativeArea></Country></AddressDetails>
+    <ExtendedData>
+      <LatLonBox east='-81.1333070' south='44.6303544' west='-81.1489540' north='44.6366496'/>
+    </ExtendedData>
+    <Point><coordinates>-81.1428830,44.6334130,0</coordinates></Point>
+  </Placemark>
+  <Placemark id='p8'>
+    <address>Queen St W, Mississauga, ON, Canada</address>
+    <AddressDetails Accuracy='6' xmlns='urn:oasis:names:tc:ciq:xsdschema:xAL:2.0'><Country><CountryNameCode>CA</CountryNameCode><CountryName>Canada</CountryName><AdministrativeArea><AdministrativeAreaName>ON</AdministrativeAreaName><Locality><LocalityName>Mississauga</LocalityName><Thoroughfare><ThoroughfareName>Queen St W</ThoroughfareName></Thoroughfare><PostalCode><PostalCodeNumber>L5H</PostalCodeNumber></PostalCode></Locality></AdministrativeArea></Country></AddressDetails>
+    <ExtendedData>
+      <LatLonBox east='-79.5927510' south='43.5315270' west='-79.6117140' north='43.5498140'/>
+    </ExtendedData>
+    <Point><coordinates>-79.6023990,43.5407460,0</coordinates></Point>
+  </Placemark>
+  <Placemark id='p9'>
+    <address>Queen St W, Cambridge, ON, Canada</address>
+    <AddressDetails Accuracy='6' xmlns='urn:oasis:names:tc:ciq:xsdschema:xAL:2.0'><Country><CountryNameCode>CA</CountryNameCode><CountryName>Canada</CountryName><AdministrativeArea><AdministrativeAreaName>ON</AdministrativeAreaName><Locality><LocalityName>Cambridge</LocalityName><Thoroughfare><ThoroughfareName>Queen St W</ThoroughfareName></Thoroughfare><PostalCode><PostalCodeNumber>N3C</PostalCodeNumber></PostalCode></Locality></AdministrativeArea></Country></AddressDetails>
+    <ExtendedData>
+      <LatLonBox east='-80.3108330' south='43.4202100' west='-80.3287680' north='43.4312910'/>
+    </ExtendedData>
+    <Point><coordinates>-80.3202040,43.4267810,0</coordinates></Point>
+  </Placemark>
+  <Placemark id='p10'>
+    <address>Queen St W, Sault Ste. Marie, ON, Canada</address>
+    <AddressDetails Accuracy='6' xmlns='urn:oasis:names:tc:ciq:xsdschema:xAL:2.0'><Country><CountryNameCode>CA</CountryNameCode><CountryName>Canada</CountryName><AdministrativeArea><AdministrativeAreaName>ON</AdministrativeAreaName><Locality><LocalityName>Sault Ste. Marie</LocalityName><Thoroughfare><ThoroughfareName>Queen St W</ThoroughfareName></Thoroughfare><PostalCode><PostalCodeNumber>P6A</PostalCodeNumber></PostalCode></Locality></AdministrativeArea></Country></AddressDetails>
+    <ExtendedData>
+      <LatLonBox east='-84.3411900' south='46.5155194' west='-84.3592850' north='46.5218146'/>
+    </ExtendedData>
+    <Point><coordinates>-84.3506780,46.5187300,0</coordinates></Point>
+  </Placemark>
+</Response></kml>

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

@@ -25,6 +25,27 @@ module Graticule
         assert_equal location, @geocoder.locate('1600 Amphitheatre Parkway, Mountain View, CA')
       end
       
+
+      # The #locate parameters are broad, so the XML response contains 
+      # multiple results at street-level precision. We expect to get the 
+      # first result back, and it should not contain a postal code.
+      def test_success_multiple_results
+        return unless prepare_response(:success_multiple_results)
+
+        location = Location.new(
+          :street => "Queen St W",
+          :locality => "Toronto",
+          :region => "ON",
+          :postal_code => nil,
+          :country => "CA",
+          :longitude => -79.4125590,
+          :latitude => 43.6455030,
+          :precision => :street
+        )
+        assert_equal location, @geocoder.locate('Queen St West, Toronto, ON 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)
@@ -43,7 +64,8 @@ module Graticule
           :region => "CA",
           :country => "US",
           :longitude => -122.418333,
-          :latitude => 37.775000
+          :latitude => 37.775000,
+          :precision => :city
         )
         
         assert_equal location, @geocoder.locate('sf ca')

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

@@ -11,7 +11,6 @@ module Graticule
         @location = Location.new(
           :street => "Oxford Street",
           :locality => "London",
-          :region => "London",
           :postal_code => "W1",
           :country => "GB",
           :longitude => -0.14839,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: graticule
 version: !ruby/object:Gem::Version 
-  version: 0.2.8
+  version: 0.2.9
 platform: ruby
 authors: 
 - Brandon Keepers
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-10-03 00:00:00 -04:00
+date: 2009-04-14 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -30,7 +30,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.7.0
+        version: 1.8.2
     version: 
 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
@@ -59,6 +59,7 @@ files:
 - init.rb
 - lib/graticule.rb
 - lib/graticule/cli.rb
+- lib/graticule/core_ext.rb
 - lib/graticule/distance.rb
 - lib/graticule/distance/haversine.rb
 - lib/graticule/distance/spherical.rb
@@ -71,7 +72,6 @@ files:
 - 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/multimap.rb
@@ -93,6 +93,7 @@ files:
 - test/fixtures/responses/google/partial.xml
 - test/fixtures/responses/google/server_error.xml
 - test/fixtures/responses/google/success.xml
+- test/fixtures/responses/google/success_multiple_results.xml
 - test/fixtures/responses/google/unavailable.xml
 - test/fixtures/responses/google/unknown_address.xml
 - test/fixtures/responses/host_ip/private.txt
@@ -152,7 +153,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: graticule
-rubygems_version: 1.2.0
+rubygems_version: 1.3.1
 signing_key: 
 specification_version: 2
 summary: API for using all the popular geocoding services.

data/lib/graticule/geocoder/map_quest.rb

@@ -1,109 +0,0 @@
-module Graticule #:nodoc:
-  module Geocoder #:nodoc:
-
-    # First you need a Mapquest API key.  You can register for one here:
-    # http://www.mapquest.com/features/main.adp?page=developer_tools_oapi
-    #
-    # Then you create a MapquestGeocode object and start locating addresses:
-    #
-    #   gg = Graticule.service(:map_quest).new(MAPS_API_KEY)
-    #   location = gg.locate :street => '1600 Amphitheater Pkwy', :locality => 'Mountain View', :region => 'CA'
-    #   p location.coordinates
-    #
-    class MapQuest < Rest
-      # http://trc.mapquest.com
-
-      PRECISION = {
-        0 => :unknown,
-        'COUNTRY' => :country,
-        'STATE' => :state,
-        'COUNTY' => :state,
-        'CITY' => :city,
-        'ZIP' => :zip,'ZIP7' => :zip,'ZIP9' => :zip,
-        'INTERSECTIONS' => :street,
-        'STREET' => :street,
-        'ADDRESS' => :address
-      }
-
-      # Creates a new MapquestGeocode that will use Mapquest API key +key+.
-      #
-      # WARNING: The MapQuest API Keys tend to be already URI encoded. If this is the case
-      # be sure to URI.unescape the key in the call to new
-      def initialize(key)
-        @key = key
-        @url = URI.parse 'http://web.openapi.mapquest.com/oapi/transaction'
-      end
-
-      # Locates +address+ returning a Location
-      def locate(address)
-        get map_attributes(location_from_params(address))
-      end
-
-    private
-
-      def map_attributes(location)
-        mapping = {:street => :address, :locality => :city, :region => :stateProvince, :postal_code => :postalcoe, :country => :country}
-        mapping.keys.inject({}) do |result,attribute|
-          result[mapping[attribute]] = location.attributes[attribute] unless location.attributes[attribute].blank?
-          result
-        end
-      end
-      
-      # Extracts a Location from +xml+.
-      def parse_response(xml) #:nodoc:
-        address = REXML::XPath.first(xml, '/advantage/geocode/locations/location')
-
-        Location.new \
-        :street => value(address.elements['//address/text()']),
-        :locality => value(address.elements['//city/text()']),
-        :region => value(address.elements['//stateProvince/text()']),
-        :postal_code => value(address.elements['//postalCode/text()']),
-        :country => value(address.elements['//country/text()']),
-        :latitude => value(address.elements['//latitude/text()']),
-        :longitude => value(address.elements['//longitude/text()']),
-        :precision => PRECISION[address.elements['//geocodeQuality'].text] || :unknown
-      end
-
-      # Extracts and raises an error from +xml+, if any.
-      def check_error(xml) #:nodoc:
-        return unless xml.elements['//error']
-        status = xml.elements['//error/code'].text.to_i
-        msg = xml.elements['//error/text'].text
-        case status
-        when 255..299 then
-          raise CredentialsError, msg
-        when 400..500 then
-          raise AddressError, msg
-        when 600.699 then
-          raise Error, msg
-        when 900 then
-          raise AddressError, 'invalid latitude'
-        when 901 then
-          raise AddressError, 'invalid longitude'
-        when 902 then
-          raise AddressError, 'error parsing params'
-        when 9902 then
-          raise CredentialsError, 'invalid key'
-        when 9904 then
-          raise CredentialsError, 'key missing'
-        else
-          raise Error, "unknown error #{status}: #{msg}"
-        end
-      end
-
-      # Creates a URL from the Hash +params+.  Automatically adds the key and
-      # sets the output type to 'xml'.
-      def make_url(params) #:nodoc:
-        super params.merge({:key => @key, :transaction => 'geocode', :ambiguities => 0})
-      end
-
-      def value(element)
-        element.value if element
-      end
-
-      def text(element)
-        element.text if element
-      end
-    end
-  end
-end