Add geocoding to client

lib/simple_geo/client.rb

@@ -152,6 +152,11 @@ def get_locate(ip)
         HashUtils.recursively_symbolize_keys(info)
       end
 
+      def geocode(address)
+        info = get Endpoint.geocode(address)
+        HashUtils.recursively_symbolize_keys(info)
+      end
+
       def get(endpoint, data=nil)
         raise NoConnectionEstablished  if @@connection.nil?
         @@connection.get endpoint, data

lib/simple_geo/endpoint.rb

@@ -69,6 +69,10 @@ def locate(ip)
         endpoint_url "locate/#{ip}.json"
       end
 
+      def geocode(address)
+        endpoint_url URI.encode("geocode/address.json?q=\"#{address}\"")
+      end
+
       def endpoint_url(path)
         [REALM, API_VERSION, path].join('/')
       end

spec/client_spec.rb

@@ -1162,6 +1162,21 @@
     end
   end
 
+  context "geocoding an address" do
+    before do
+      @address = '41 Decatur St, San Francisco, CA'
+      url = "http://api.simplegeo.com/0.1/geocode/address.json?q=\"#{@address}\""
+      uri = URI.parse(URI.encode(url))
+      stub_request :get, uri, :fixture_file => 'geocoding.json'
+    end
+
+    it 'should return a hash with the correct info' do 
+      info = SimpleGeo::Client.geocode(@address)
+      info[:features][0][:geometry][:coordinates].should == [-122.406032, 37.772502]
+      info[:address].should == @address
+    end
+  end
+
   # this API call seems to always return a 404
   # context "getting boundary info by id" do
   #   before do

spec/fixtures/geocoding.json

@@ -0,0 +1,25 @@
+{
+   "type" : "FeatureCollection",
+   "features": [
+    {
+     "type" : "Feature",
+     "properties": {
+      "number" : "41",
+      "street" : "Decatur St",
+      "score" : 0.805,
+      "precision" : "range",
+      "zip" : "94103",
+      "prenum" : ""
+      },
+     "geometry": {
+      "type" : "Point",
+      "coordinates": [
+       -122.406032,
+       37.772502
+      ]
+}
+     }
+   ],
+   "address" : "41 Decatur St, San Francisco, CA"
+   }
+