simplegeo 0.0.3 → 0.1.0

data/spec/client_spec.rb

@@ -0,0 +1,1180 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Client" do
+  before do
+    SimpleGeo::Client.set_credentials 'token', 'secret'
+  end
+
+  context "getting a record" do
+    context "with an id for an existing record" do
+      before do
+        stub_request :get,
+          'http://api.simplegeo.com/0.1/records/com.simplegeo.global.geonames/5373629.json',
+          :fixture_file => 'get_record.json'
+      end
+
+      it "should return a single record with the correct attributes" do
+        record = SimpleGeo::Client.get_record('com.simplegeo.global.geonames', 5373629)
+        record.class.should == SimpleGeo::Record
+        record.id.should == '5373629'
+        record.type.should == 'place'
+        record.layer.should == 'com.simplegeo.global.geonames'
+        record.created.should == Time.at(1269832510)
+        record.lat.should == 37.759650000000001
+        record.lon.should == -122.42608
+        record.properties.should == {
+          :layer => "com.simplegeo.global.geonames",
+          :elevation => "22",
+          :gtopo30 => "60",
+          :feature_code => "PRK",
+          :last_modified => "2006-01-15",
+          :country_code => "US",
+          :alternatenames => "",
+          :timezone => "America/Los_Angeles",
+          :population => "0",
+          :name => "Mission Dolores Park",
+          :feature_class => "L",
+          :cc2 => "",
+          :admin1 => "CA",
+          :admin3 => "",
+          :admin2 => "075",
+          :admin4 => "",
+          :asciiname => "Mission Dolores Park"
+        }
+      end
+    end
+
+    context "with an id for a nonexistant record" do
+      before do
+        stub_request :get,
+          'http://api.simplegeo.com/0.1/records/com.simplegeo.global.geonames/foo.json',
+          :fixture_file => 'no_such_record.json', :status => 404
+      end
+
+      it "should raise a NotFound exception" do
+        lambda {
+          SimpleGeo::Client.get_record('com.simplegeo.global.geonames', 'foo')
+        }.should raise_exception(SimpleGeo::NotFound)
+      end
+    end
+  end
+
+  #TODO: verify request data contains correct record data
+  context "adding/updating a record" do
+    before do
+      stub_request :put,
+        'http://api.simplegeo.com/0.1/records/io.path.testlayer/1234.json',
+        :status => 202
+    end
+
+    it "should create or update the record" do
+      lambda {
+        record = SimpleGeo::Record.new({
+          :id => '1234',
+          :created => Time.at(1269832510),
+          :lat => 37.759650000000001,
+          :lon => -122.42608,
+          :layer => 'io.path.testlayer',
+          :properties => {
+            :test_property => 'foobar'
+          }
+        })
+        SimpleGeo::Client.add_record(record)
+      }.should_not raise_exception
+    end
+  end
+
+  context "deleting a record" do
+    before do
+      stub_request :delete,
+        'http://api.simplegeo.com/0.1/records/io.path.testlayer/1234.json',
+        :status => 202
+    end
+
+    it "should delete the record" do
+      lambda {
+        SimpleGeo::Client.delete_record('io.path.testlayer', '1234')
+      }.should_not raise_exception
+    end
+  end
+
+  context "getting multiple records" do
+    context "with ids for two existing records" do
+      before do
+        stub_request :get,
+          'http://api.simplegeo.com/0.1/records/com.simplegeo.us.business/41531696,41530629.json',
+          :fixture_file => 'get_records.json'
+      end
+
+      it "should return an array of records with the correct attributes" do
+        records = SimpleGeo::Client.get_records('com.simplegeo.us.business', ['41531696', '41530629'])
+        records.size.should == 2
+        records[0].id.should == '41530629'
+        records[0].type.should == 'place'
+        records[0].layer.should == 'com.simplegeo.us.business'
+        records[0].created.should == Time.at(1271985142)
+        records[0].lat.should == 37.760350000000003
+        records[0].lon.should == -122.419043
+        records[0].properties.should == {
+          :state => "CA",
+          :census_block_group => "2",
+          :street_type => "St",
+          :city => "San Francisco",
+          :census_block_id => "002",
+          :plus4 => "1811",
+          :cbsa => "41860",
+          :time_zone => "4",
+          :censustract => "020800",
+          :pubdate => "2009-12-01",
+          :std_name => "Beauty Bar",
+          :phone_number => "0323",
+          :state_fips => "06",
+          :company_sics => [
+            {
+              :sic => "72310000",
+              :industry_class => "7",
+              :relevancy => "1",
+              :naics_description => "BEAUTY SALONS",
+              :naics => "812112",
+              :sic_4 => "7231",
+              :description => "BEAUTY SHOPS",
+              :sic_4_description => "BEAUTY SHOPS"
+            },
+            {
+              :sic => "58130101",
+              :industry_class => "5",
+              :relevancy => "2",
+              :naics_description => "DRINKING PLACES (ALCOHOLIC BEVERAGES)",
+              :naics => "72241",
+              :sic_4 => "5813",
+              :description => "BAR (DRINKING PLACES)",
+              :sic_4_description => "DRINKING PLACES"
+            },
+            {
+              :sic => "58120310",
+              :industry_class => "5",
+              :relevancy => "3",
+              :naics_description => "LIMITED-SERVICE RESTAURANTS",
+              :naics => "722211",
+              :sic_4 => "5812",
+              :description => "GRILLS, ( EATING PLACES)",
+              :sic_4_description => "EATING PLACES"
+            }
+          ],
+          :dpv_confirm => "Y",
+          :zip => "94110",
+          :dpc => "996",
+          :street_name => "Mission",
+          :carrier_route => "C036",
+          :area_code => "415",
+          :company_headings => [
+            {
+              :category_name => "Bars, Taverns & Cocktail Lounges",
+              :condensed_name => "BARS GRILLS & PUBS",
+              :normalized_id => "138001000",
+              :category_id => "138000000",
+              :normalized_name => "BARS GRILLS & PUBS",
+              :condensed_id => "138001000"
+            }
+          ],
+          :mlsc => "4",
+          :val_date => "2010-03-22",
+          :confidence_score => "100",
+          :exppubcity => "San Francisco",
+          :housenumber => "2299",
+          :z4_type => "S",
+          :exchange => "285",
+          :business_name => "Beauty Bar",
+          :county_fips => "075",
+          :ll_match_level => "R",
+          :dso => "1",
+          :company_phones => [
+            {
+              :val_flag => "C",
+              :val_date => "2010-03-22",
+              :phone_type => "P",
+              :dnc => "",
+              :exchange => "285",
+              :phone_number => "0323",
+              :areacode => "415"
+            }
+          ],
+          :msa => "7360",
+          :val_flag => "C"
+        }
+        records[1].id.should == '41531696'
+        records[1].type.should == 'place'
+        records[1].layer.should == 'com.simplegeo.us.business'
+        records[1].created.should == Time.at(1271985146)
+        records[1].lat.should == 37.755470000000003
+        records[1].lon.should == -122.420646
+        records[1].properties.should == {
+          :carrier_route => "C010",
+          :pubdate => "2009-12-01",
+          :ll_match_level => "R",
+          :street_name => "22nd",
+          :std_name => "Latin American Club",
+          :val_flag => "C",
+          :census_block_id => "004",
+          :company_headings => [
+            {
+              :normalized_id => "138004000",
+              :condensed_name => "NIGHT CLUBS",
+              :condensed_id => "138004000",
+              :normalized_name => "NIGHT CLUBS",
+              :category_id => "138000000",
+              :category_name => "Bars, Taverns & Cocktail Lounges"
+            }
+          ],
+          :company_sics => [
+            {
+              :sic_4 => "5813",
+              :relevancy => "1",
+              :description => "NIGHT CLUBS",
+              :naics => "72241",
+              :sic => "58130200",
+              :industry_class => "5",
+              :sic_4_description => "DRINKING PLACES",
+              :naics_description => "DRINKING PLACES (ALCOHOLIC BEVERAGES)"
+            }
+          ],
+          :city => "San Francisco",
+          :county_fips => "075",
+          :zip => "94110",
+          :mlsc => "4",
+          :dso => "1",
+          :state => "CA",
+          :dpv_confirm => "Y",
+          :housenumber => "3286",
+          :msa => "7360",
+          :phone_number => "2732",
+          :exchange => "647",
+          :area_code => "415",
+          :censustract => "020800",
+          :state_fips => "06",
+          :street_type => "St",
+          :business_name => "Latin American Club",
+          :plus4 => "3033",
+          :val_date => "2010-03-22",
+          :dnc => "T",
+          :confidence_score => "100",
+          :time_zone => "4",
+          :cbsa => "41860",
+          :dpc => "862",
+          :company_phones => [
+            {
+              :phone_number => "2732",
+              :phone_type => "P",
+              :val_date => "2010-03-22",
+              :dnc => "T",
+              :exchange => "647",
+              :areacode => "415",
+              :val_flag => "C"
+            }
+          ],
+          :census_block_group => "4",
+          :z4_type => "S"
+        }
+      end
+    end
+
+    context "with ids for nonexistant records" do
+      before do
+        stub_request :get,
+          'http://api.simplegeo.com/0.1/records/com.simplegeo.global.geonames/foo,bar.json',
+          :fixture_file => 'nonetype_not_iterable.json', :status => 500
+      end
+
+      it "should raise a NotFound exception" do
+        lambda {
+          SimpleGeo::Client.get_records('com.simplegeo.global.geonames', ['foo', 'bar'])
+        }.should raise_exception(SimpleGeo::ServerError)
+      end
+    end
+  end
+
+  context "adding multiple records" do
+    before do
+      stub_request :post,
+        'http://api.simplegeo.com/0.1/records/io.path.testlayer.json',
+        :status => 202
+    end
+
+    it "should create or update the record" do
+      layer = 'io.path.testlayer'
+      lambda {
+        records = [
+          SimpleGeo::Record.new({
+            :id => '1234',
+            :created => Time.at(1269832510),
+            :lat => 37.759650000000001,
+            :lon => -122.42608,
+            :layer => layer,
+            :properties => {
+              :test_property => 'foobar'
+            }
+          }),
+          SimpleGeo::Record.new({
+            :id => '5678',
+            :created => Time.at(1269832510),
+            :lat => 37.755470000000003,
+            :lon => -122.420646,
+            :layer => layer,
+            :properties => {
+              :mad_prop => 'baz'
+            }
+          })
+        ]
+        SimpleGeo::Client.add_records(layer, records)
+      }.should_not raise_exception
+    end
+  end
+
+  context "getting a record's history" do
+    before do
+      stub_request :get,
+        'http://api.simplegeo.com/0.1/records/com.simplegeo.global.geonames/5373629/history.json',
+        :fixture_file => 'get_history.json'
+    end
+
+    it "should create or update the record" do
+      history = SimpleGeo::Client.get_history('com.simplegeo.global.geonames', '5373629')
+      history.should == [
+        {
+          :created => Time.at(1269832510),
+          :lat => 37.759650000000001,
+          :lon => -122.42608
+        }
+      ]
+    end
+  end
+
+  context "getting nearby records" do
+    before do
+      @expected_records = {
+        :next_cursor => "QVSEifz7gri4J0w8FSQJ06Z5S5lOw6gZ75Co-fBbBQJEr7XMqN32bjMKNc9kwLKqKyqtVvxR_t5hgWW6XDgPnPTY",
+        :records => [
+          {
+            :distance => 0,
+            :record => SimpleGeo::Record.new(
+              :id => "5373629",
+              :lon => -122.42608,
+              :lat => 37.75965,
+              :type => "place",
+              :layer => "com.simplegeo.global.geonames",
+              :created => Time.at(1269832510),
+              :properties => {
+                :admin4 => "",
+                :feature_code => "PRK",
+                :feature_class => "L",
+                :last_modified => "2006-01-15",
+                :asciiname => "Mission Dolores Park",
+                :cc2 => "",
+                :country_code => "US",
+                :admin1 => "CA",
+                :alternatenames => "",
+                :admin3 => "",
+                :elevation => "22",
+                :layer => "com.simplegeo.global.geonames",
+                :timezone => "America/Los_Angeles",
+                :name => "Mission Dolores Park",
+                :gtopo30 => "60",
+                :admin2 => "075",
+                :population => "0"
+              }
+            )
+          },
+          {
+            :distance => 57.557068918956581,
+            :record => SimpleGeo::Record.new(
+              :id => "5352852",
+              :lon => -122.42553,
+              :lat => 37.75937,
+              :type => "place",
+              :layer => "com.simplegeo.global.geonames",
+              :created => Time.at(1269832039),
+              :properties => {
+                :admin4 => "",
+                :feature_code => "CH",
+                :feature_class => "S",
+                :last_modified => "2006-01-15",
+                :asciiname => "Golden Gate Lutheran Church",
+                :cc2 => "",
+                :country_code => "US",
+                :admin1 => "CA",
+                :alternatenames => "",
+                :admin3 => "",
+                :elevation => "23",
+                :layer => "com.simplegeo.global.geonames",
+                :timezone => "America/Los_Angeles",
+                :name=> "Golden Gate Lutheran Church",
+                :gtopo30 => "60",
+                :admin2 => "075",
+                :population => "0"
+              }
+            )
+          }
+        ]
+      }
+    end
+
+    context "by lat and lon" do
+      before do
+        stub_request :get,
+          'http://api.simplegeo.com/0.1/records/com.simplegeo.global.geonames/nearby/37.75965,-122.42608.json',
+          :fixture_file => 'get_nearby.json'
+      end
+
+      it "should return a hash of nearby records" do
+        records = SimpleGeo::Client.get_nearby_records('com.simplegeo.global.geonames',
+          :lat => 37.759650000000001,
+          :lon => -122.42608)
+        records.should == @expected_records
+      end
+    end
+
+    context "by geohash" do
+      before do
+        stub_request :get,
+          'http://api.simplegeo.com/0.1/records/com.simplegeo.global.geonames/nearby/9q8yy1ujcsfm.json',
+          :fixture_file => 'get_nearby.json'
+      end
+
+      it "should return a hash of nearby records" do
+        records = SimpleGeo::Client.get_nearby_records('com.simplegeo.global.geonames',
+          :geohash => '9q8yy1ujcsfm')
+        records.should == @expected_records
+      end
+    end
+
+    context "with no nearby records" do
+      before do
+        stub_request :get,
+          'http://api.simplegeo.com/0.1/records/com.simplegeo.global.geonames/nearby/37.75965,-122.42608.json',
+          :fixture_file => 'empty_feature_collection.json'
+      end
+
+      it "should return a hash of nearby records" do
+        records = SimpleGeo::Client.get_nearby_records('com.simplegeo.global.geonames',
+          :lat => 37.759650000000001,
+          :lon => -122.42608)
+        records.should == { :next_cursor => nil, :records => [] }
+      end
+    end
+  end
+
+  context "getting a nearby address" do
+    before do
+      stub_request :get,
+        'http://api.simplegeo.com/0.1/nearby/address/37.75965,-122.42608.json',
+        :fixture_file => 'nearby_address.json'
+    end
+
+    it "should return a hash with the address information" do
+      nearby_address = SimpleGeo::Client.get_nearby_address(37.759650000000001, -122.42608)
+      nearby_address.should == {
+        :state_name => "California",
+        :street_number => "580",
+        :country => "US",
+        :street => "Dolores St",
+        :postal_code => "",
+        :county_name => "San Francisco",
+        :county_code => "075",
+        :state_code => "CA",
+        :place_name => "San Francisco"
+      }
+    end
+  end
+
+  context "getting layer information" do
+    context "for an existing layer" do
+      before do
+        stub_request :get,
+          'http://api.simplegeo.com/0.1/layer/io.path.testlayer.json',
+          :fixture_file => 'layer_info.json'
+      end
+
+      it "should return a hash containing the layer information" do
+        layer_info = SimpleGeo::Client.get_layer_information('io.path.testlayer')
+        layer_info.should == {
+          :name => "io.path.testlayer",
+          :public => false,
+          :callback_urls => []
+        }
+      end
+    end
+
+    context "for a nonexistant layer" do
+      before do
+        stub_request :get,
+          'http://api.simplegeo.com/0.1/layer/io.path.testlayer.json',
+          :status => 404
+      end
+
+      it "should raise a NotFound exception" do
+        lambda {
+          SimpleGeo::Client.get_layer_information('io.path.testlayer')
+        }.should raise_exception(SimpleGeo::NotFound)
+      end
+    end
+  end
+
+  context "getting SpotRank information for a day, hour and location" do
+    before do
+      stub_request :get,
+        'http://api.simplegeo.com/0.1/density/sat/16/37.75965,-122.42608.json',
+        :fixture_file => 'get_density_by_hour.json'
+    end
+
+    it "should return a hash containing the density information" do
+      density_info = SimpleGeo::Client.get_density(37.75965, -122.42608, 'sat', '16' )
+      density_info.should == {
+        :city_rank => 10,
+        :local_rank => 8,
+        :trending_rank => 0,
+        :dayname => "sat",
+        :hour => 16,
+        :worldwide_rank => 8,
+        :geometry => {
+          :type => "Polygon",
+          :coordinates => [
+            [ 37.7587890625, -122.4267578125 ],
+            [ 37.759765625, -122.4267578125 ],
+            [ 37.759765625, -122.42578125 ],
+            [ 37.7587890625, -122.42578125 ],
+            [ 37.7587890625, -122.4267578125 ]
+          ]
+        }
+      }
+    end
+  end
+
+  context "getting SpotRank information for a day and location" do
+    before do
+      stub_request :get,
+        'http://api.simplegeo.com/0.1/density/sat/37.75965,-122.42608.json',
+        :fixture_file => 'get_density_by_day.json'
+    end
+
+    it "should return an array of hashes containing the density information" do
+      density_info = SimpleGeo::Client.get_density(37.75965, -122.42608, 'sat')
+      density_info.should == [
+        {
+          :geometry => {
+            :type => "Polygon",
+            :coordinates => [
+              [ 37.7587890625, -122.4267578125 ],
+              [ 37.759765625, -122.4267578125 ],
+              [ 37.759765625, -122.42578125 ],
+              [ 37.7587890625, -122.42578125 ],
+              [ 37.7587890625, -122.4267578125 ]
+            ]
+          },
+          :hour => 0,
+          :trending_rank => 2,
+          :local_rank => 4,
+          :city_rank => 10,
+          :worldwide_rank => 4,
+          :dayname => "sat"
+        },
+        {
+          :geometry => {
+            :type => "Polygon",
+            :coordinates => [
+              [ 37.7587890625, -122.4267578125 ],
+              [ 37.759765625, -122.4267578125 ],
+              [ 37.759765625, -122.42578125 ],
+              [ 37.7587890625, -122.42578125 ],
+              [ 37.7587890625, -122.4267578125 ]
+            ]
+          },
+          :hour => 1,
+          :trending_rank => -2,
+          :local_rank => 6,
+          :city_rank => 10,
+          :worldwide_rank => 6,
+          :dayname => "sat"
+        },
+        {
+          :geometry => {
+            :type => "Polygon",
+            :coordinates => [
+              [ 37.7587890625, -122.4267578125 ],
+              [ 37.759765625, -122.4267578125 ],
+              [ 37.759765625, -122.42578125 ],
+              [ 37.7587890625, -122.42578125 ],
+              [ 37.7587890625, -122.4267578125 ]
+            ]
+          },
+          :hour => 2,
+          :trending_rank => 2,
+          :local_rank => 2,
+          :city_rank => 10,
+          :worldwide_rank => 2,
+          :dayname => "sat"
+        },
+        {
+          :geometry => {
+            :type => "Polygon",
+            :coordinates => [
+              [ 37.7587890625, -122.4267578125 ],
+              [ 37.759765625, -122.4267578125 ],
+              [ 37.759765625, -122.42578125 ],
+              [ 37.7587890625, -122.42578125 ],
+              [ 37.7587890625, -122.4267578125 ]
+            ]
+          },
+          :hour => 3,
+          :trending_rank => -2,
+          :local_rank => 6,
+          :city_rank => 10,
+          :worldwide_rank => 6,
+          :dayname => "sat"
+        },
+        {
+          :geometry => {
+            :type => "Polygon",
+            :coordinates => [
+              [ 37.7587890625, -122.4267578125 ],
+              [ 37.759765625, -122.4267578125 ],
+              [ 37.759765625, -122.42578125 ],
+              [ 37.7587890625, -122.42578125 ],
+              [ 37.7587890625, -122.4267578125 ]
+            ]
+          },
+          :hour => 4,
+          :trending_rank => -2,
+          :local_rank => 4,
+          :city_rank => 10,
+          :worldwide_rank => 4,
+          :dayname => "sat"
+        },
+        {
+           :geometry => {
+             :type => "Polygon",
+             :coordinates => [
+               [ 37.7587890625, -122.4267578125 ],
+               [ 37.759765625, -122.4267578125 ],
+               [ 37.759765625, -122.42578125 ],
+               [ 37.7587890625, -122.42578125 ],
+               [ 37.7587890625, -122.4267578125 ]
+             ]
+           },
+          :hour => 6,
+          :trending_rank => 2,
+          :local_rank => 2,
+          :city_rank => 10,
+          :worldwide_rank => 2,
+          :dayname => "sat"
+        },
+        {
+          :geometry => {
+             :type => "Polygon",
+             :coordinates => [
+               [ 37.7587890625, -122.4267578125 ],
+               [ 37.759765625, -122.4267578125 ],
+               [ 37.759765625, -122.42578125 ],
+               [ 37.7587890625, -122.42578125 ],
+               [ 37.7587890625, -122.4267578125 ]
+             ]
+           },
+          :hour => 7,
+          :trending_rank => 1,
+          :local_rank => 5,
+          :city_rank => 10,
+          :worldwide_rank => 5,
+          :dayname => "sat"
+        },
+        {
+           :geometry => {
+             :type => "Polygon",
+             :coordinates => [
+               [ 37.7587890625, -122.4267578125 ],
+               [ 37.759765625, -122.4267578125 ],
+               [ 37.759765625, -122.42578125 ],
+               [ 37.7587890625, -122.42578125 ],
+               [ 37.7587890625, -122.4267578125 ]
+             ]
+           },
+          :hour => 8,
+          :trending_rank => 0,
+          :local_rank => 6,
+          :city_rank => 10,
+          :worldwide_rank => 6,
+          :dayname => "sat"
+        },
+        {
+           :geometry => {
+             :type => "Polygon",
+             :coordinates => [
+               [ 37.7587890625, -122.4267578125 ],
+               [ 37.759765625, -122.4267578125 ],
+               [ 37.759765625, -122.42578125 ],
+               [ 37.7587890625, -122.42578125 ],
+               [ 37.7587890625, -122.4267578125 ]
+             ]
+           },
+          :hour => 9,
+          :trending_rank => 0,
+          :local_rank => 6,
+          :city_rank => 10,
+          :worldwide_rank => 6,
+          :dayname => "sat"
+        },
+        {
+           :geometry => {
+             :type => "Polygon",
+             :coordinates => [
+               [ 37.7587890625, -122.4267578125 ],
+               [ 37.759765625, -122.4267578125 ],
+               [ 37.759765625, -122.42578125 ],
+               [ 37.7587890625, -122.42578125 ],
+               [ 37.7587890625, -122.4267578125 ]
+             ]
+           },
+          :hour => 10,
+          :trending_rank => 2,
+          :local_rank => 6,
+          :city_rank => 10,
+          :worldwide_rank => 6,
+          :dayname => "sat"
+        },
+        {
+          :geometry => {
+            :type => "Polygon",
+            :coordinates => [
+              [ 37.7587890625, -122.4267578125 ],
+              [ 37.759765625, -122.4267578125 ],
+              [ 37.759765625, -122.42578125 ],
+              [ 37.7587890625, -122.42578125 ],
+              [ 37.7587890625, -122.4267578125 ]
+            ]
+          },
+          :hour => 11,
+          :trending_rank => -1,
+          :local_rank => 8,
+          :city_rank => 10,
+          :worldwide_rank => 8,
+          :dayname => "sat"
+        },
+        {
+           :geometry => {
+             :type => "Polygon",
+             :coordinates => [
+               [ 37.7587890625, -122.4267578125 ],
+               [ 37.759765625, -122.4267578125 ],
+               [ 37.759765625, -122.42578125 ],
+               [ 37.7587890625, -122.42578125 ],
+               [ 37.7587890625, -122.4267578125 ]
+             ]
+           },
+          :hour => 12,
+          :trending_rank => 1,
+          :local_rank => 7,
+          :city_rank => 10,
+          :worldwide_rank => 7,
+          :dayname => "sat"
+        },
+        {
+           :geometry => {
+             :type => "Polygon",
+             :coordinates => [
+               [ 37.7587890625, -122.4267578125 ],
+               [ 37.759765625, -122.4267578125 ],
+               [ 37.759765625, -122.42578125 ],
+               [ 37.7587890625, -122.42578125 ],
+               [ 37.7587890625, -122.4267578125 ]
+             ]
+           },
+          :hour => 13,
+          :trending_rank => 0,
+          :local_rank => 8,
+          :city_rank => 10,
+          :worldwide_rank => 8,
+          :dayname => "sat"
+        },
+        {
+           :geometry => {
+             :type => "Polygon",
+             :coordinates => [
+               [ 37.7587890625, -122.4267578125 ],
+               [ 37.759765625, -122.4267578125 ],
+               [ 37.759765625, -122.42578125 ],
+               [ 37.7587890625, -122.42578125 ],
+               [ 37.7587890625, -122.4267578125 ]
+             ]
+           },
+          :hour => 14,
+          :trending_rank => 0,
+          :local_rank => 8,
+          :city_rank => 10,
+          :worldwide_rank => 8,
+          :dayname => "sat"
+        },
+        {
+           :geometry => {
+             :type => "Polygon",
+             :coordinates => [
+               [ 37.7587890625, -122.4267578125 ],
+               [ 37.759765625, -122.4267578125 ],
+               [ 37.759765625, -122.42578125 ],
+               [ 37.7587890625, -122.42578125 ],
+               [ 37.7587890625, -122.4267578125 ]
+             ]
+           },
+          :hour => 15,
+          :trending_rank => 0,
+          :local_rank => 8,
+          :city_rank => 10,
+          :worldwide_rank => 8,
+          :dayname => "sat"
+        },
+        {
+           :geometry => {
+             :type => "Polygon",
+             :coordinates => [
+               [ 37.7587890625, -122.4267578125 ],
+               [ 37.759765625, -122.4267578125 ],
+               [ 37.759765625, -122.42578125 ],
+               [ 37.7587890625, -122.42578125 ],
+               [ 37.7587890625, -122.4267578125 ]
+             ]
+           },
+          :hour => 16,
+          :trending_rank => 0,
+          :local_rank => 8,
+          :city_rank => 10,
+          :worldwide_rank => 8,
+          :dayname => "sat"
+        },
+        {
+           :geometry => {
+             :type => "Polygon",
+             :coordinates => [
+               [ 37.7587890625, -122.4267578125 ],
+               [ 37.759765625, -122.4267578125 ],
+               [ 37.759765625, -122.42578125 ],
+               [ 37.7587890625, -122.42578125 ],
+               [ 37.7587890625, -122.4267578125 ]
+             ]
+           },
+          :hour => 17,
+          :trending_rank => 0,
+          :local_rank => 8,
+          :city_rank => 10,
+          :worldwide_rank => 8,
+          :dayname => "sat"
+        },
+        {
+           :geometry => {
+             :type => "Polygon",
+             :coordinates => [
+               [ 37.7587890625, -122.4267578125 ],
+               [ 37.759765625, -122.4267578125 ],
+               [ 37.759765625, -122.42578125 ],
+               [ 37.7587890625, -122.42578125 ],
+               [ 37.7587890625, -122.4267578125 ]
+             ]
+           },
+          :hour => 18,
+          :trending_rank => 0,
+          :local_rank => 8,
+          :city_rank => 10,
+          :worldwide_rank => 8,
+          :dayname => "sat"
+        },
+        {
+           :geometry => {
+             :type => "Polygon",
+             :coordinates => [
+               [ 37.7587890625, -122.4267578125 ],
+               [ 37.759765625, -122.4267578125 ],
+               [ 37.759765625, -122.42578125 ],
+               [ 37.7587890625, -122.42578125 ],
+               [ 37.7587890625, -122.4267578125 ]
+             ]
+           },
+          :hour => 19,
+          :trending_rank => 0,
+          :local_rank => 8,
+          :city_rank => 10,
+          :worldwide_rank => 8,
+          :dayname => "sat"
+        },
+        {
+           :geometry => {
+             :type => "Polygon",
+             :coordinates => [
+               [ 37.7587890625, -122.4267578125 ],
+               [ 37.759765625, -122.4267578125 ],
+               [ 37.759765625, -122.42578125 ],
+               [ 37.7587890625, -122.42578125 ],
+               [ 37.7587890625, -122.4267578125 ]
+             ]
+           },
+          :hour => 20,
+          :trending_rank => 0,
+          :local_rank => 8,
+          :city_rank => 10,
+          :worldwide_rank => 8,
+          :dayname => "sat"
+        },
+        {
+           :geometry => {
+             :type => "Polygon",
+             :coordinates => [
+               [ 37.7587890625, -122.4267578125 ],
+               [ 37.759765625, -122.4267578125 ],
+               [ 37.759765625, -122.42578125 ],
+               [ 37.7587890625, -122.42578125 ],
+               [ 37.7587890625, -122.4267578125 ]
+             ]
+           },
+          :hour => 21,
+          :trending_rank => -2,
+          :local_rank => 8,
+          :city_rank => 10,
+          :worldwide_rank => 8,
+          :dayname => "sat"
+        },
+        {
+           :geometry => {
+             :type => "Polygon",
+             :coordinates => [
+               [ 37.7587890625, -122.4267578125 ],
+               [ 37.759765625, -122.4267578125 ],
+               [ 37.759765625, -122.42578125 ],
+               [ 37.7587890625, -122.42578125 ],
+               [ 37.7587890625, -122.4267578125 ]
+             ]
+           },
+          :hour => 22,
+          :trending_rank => 0,
+          :local_rank => 5,
+          :city_rank => 10,
+          :worldwide_rank => 6,
+          :dayname => "sat"
+        },
+        {
+          :geometry => {
+             :type => "Polygon",
+             :coordinates => [
+               [ 37.7587890625, -122.4267578125 ],
+               [ 37.759765625, -122.4267578125 ],
+               [ 37.759765625, -122.42578125 ],
+               [ 37.7587890625, -122.42578125 ],
+               [ 37.7587890625, -122.4267578125 ]
+             ]
+           },
+          :hour => 23,
+          :trending_rank => 1,
+          :local_rank => 5,
+          :city_rank => 10,
+          :worldwide_rank => 5,
+          :dayname => "sat"
+        }
+      ]
+    end
+  end
+
+  context "getting contains info for a set of coordinates" do
+    before do
+      stub_request :get,
+        'http://api.simplegeo.com/0.1/contains/37.7587890625,-122.4267578125.json',
+        :fixture_file => 'contains.json'
+    end
+
+    it "should return a hash with the correct info" do
+      info = SimpleGeo::Client.get_contains(37.7587890625, -122.4267578125)
+      info.should == [
+        {
+          :bounds =>
+          [
+            -122.435188,
+             37.756093,
+             -122.42555,
+             37.763030999999998
+          ],
+           :type => "Census Tract",
+           :id => "Census_Tract:06075020600:9q8yy1",
+           :abbr => "",
+           :name => "06075020600"
+        },
+        {
+          :bounds =>
+          [
+            -123.17382499999999,
+             37.639829999999996,
+             -122.28178,
+             37.929823999999996
+          ],
+           :type => "County",
+           :id => "County:San_Francisco:9q8yvv",
+           :abbr => "",
+           :name => "San Francisco"
+        },
+        {
+          :bounds =>
+          [
+            -123.17382499999999,
+             37.639829999999996,
+             -122.28178,
+             37.929823999999996
+          ],
+           :type => "City",
+           :id => "City:San_Francisco:9q8yvv",
+           :abbr => "",
+           :name => "San Francisco"
+        },
+        {
+          :bounds =>
+          [
+            -122.612285,
+             37.708131000000002,
+             -122.28178,
+             37.929823999999996
+          ],
+           :type => "Congressional District",
+           :id => "Congressional_District:Congressional_Di:9q8yyn",
+           :abbr => "",
+           :name => "Congressional District 8"
+        },
+        {
+          :bounds =>
+          [
+            -179.14247147726383,
+             18.930137634111077,
+             179.78114994357418,
+             71.412179667308919
+          ],
+           :type => "Country",
+           :id => "Country:United_States_of:9z12zg",
+           :abbr => "",
+           :name => "United States of America"
+        },
+        {
+          :bounds =>
+          [
+            -122.428882,
+             37.758029999999998,
+             -122.42138199999999,
+             37.772263000000002
+          ],
+           :type => "Neighborhood",
+           :id => "Neighborhood:Mission_Dolores:9q8yy4",
+           :abbr => "",
+           :name => "Mission Dolores"
+        },
+        {
+          :bounds =>
+          [
+            -122.51666666668193,
+             37.191666666628507,
+             -121.73333333334497,
+             38.041666666640907
+          ],
+           :type => "Urban Area",
+           :id => "Urban_Area:San_Francisco1:9q9jsg",
+           :abbr => "",
+           :name => "San Francisco1"
+        },
+        {
+          :bounds =>
+          [
+            -122.451553,
+             37.746687000000001,
+             -122.424773,
+             37.770451999999999
+          ],
+           :type => "Postal",
+           :id => "Postal:94114:9q8yvc",
+           :abbr => "",
+           :name => "94114"
+        },
+        {
+          :bounds =>
+          [
+            -124.48200299999999,
+             32.528832000000001,
+             -114.13121099999999,
+             42.009516999999995
+          ],
+           :type => "Province",
+           :id => "Province:CA:9qdguu",
+           :abbr => "CA",
+           :name => "California"
+        }
+      ]
+    end
+  end
+
+  context "getting overlaps info for a set of coordinates" do
+    before do
+      stub_request :get,
+        'http://api.simplegeo.com/0.1/overlaps/32.528832,-124.482003,42.009517,-114.131211.json',
+        :fixture_file => 'overlaps.json'
+    end
+
+    it "should return a hash with the correct info" do
+      info = SimpleGeo::Client.get_overlaps(32.528832000000001, -124.48200299999999,
+        42.009516999999995, -114.13121099999999)
+      info.should == [
+        {
+          :bounds =>
+          [
+            -122.998802,
+             42.002634,
+             -122.597843,
+             42.266379000000001
+          ],
+           :type => "Census Tract",
+           :id => "Census_Tract:41029002300:9r2xt4",
+           :abbr => "",
+           :name => "41029002300"
+        },
+        {
+          :bounds =>
+          [
+            -123.858086,
+             41.995095999999997,
+             -123.22998200000001,
+             42.272435999999999
+          ],
+           :type => "Census Tract",
+           :id => "Census_Tract:41033361600:9r2psc",
+           :abbr => "",
+           :name => "41033361600"
+        },
+        {
+          :bounds =>
+          [
+            -123.231629,
+             42.003022000000001,
+             -122.907515,
+             42.433349
+          ],
+           :type => "Census Tract",
+           :id => "Census_Tract:41029003002:9r2ryf",
+           :abbr => "",
+           :name => "41029003002"
+        }
+      ]
+    end
+  end
+
+  # this API call seems to always return a 404
+  # context "getting boundary info by id" do
+  #   before do
+  #     stub_request :get,
+  #       'http://api.simplegeo.com/0.1/boundary/Neighborhood:Mission_Dolores:9q8yy4.json',
+  #       :fixture_file => 'boundary.json'
+  #   end
+  #
+  #   it "should return a hash with the correct info" do
+  #     info = SimpleGeo::Client.get_boundary("Neighborhood:Mission_Dolores:9q8yy4")
+  #     info.should == [
+  #
+  #     ]
+  #   end
+  # end
+end