geonames 0.2.2 → 0.3.3

data/spec/fixtures/timezone/america_toronto.xml.http

@@ -0,0 +1,24 @@
+HTTP/1.1 200 OK
+Date: Sat, 13 Nov 2010 18:03:56 GMT
+Server: Apache/2.2.13 (Linux/SUSE)
+Cache-Control: no-cache
+Access-Control-Allow-Origin: *
+Transfer-Encoding: chunked
+Content-Type: text/xml;charset=UTF-8
+
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<geonames>
+<timezone>
+<countryCode>CA</countryCode>
+<countryName>Canada</countryName>
+<lat>43.900120387</lat>
+<lng>-78.882869834</lng>
+<timezoneId>America/Toronto</timezoneId>
+<dstOffset>-4.0</dstOffset>
+<gmtOffset>-5.0</gmtOffset>
+<rawOffset>-5.0</rawOffset>
+<time>2010-11-13 13:03</time>
+<sunrise>2010-11-13 07:07</sunrise>
+<sunset>2010-11-13 16:51</sunset>
+</timezone>
+</geonames>

data/spec/fixtures/wikipedia_bounding_box/wyoming.xml.http

@@ -0,0 +1,154 @@
+HTTP/1.1 200 OK
+Date: Sun, 14 Nov 2010 04:46:36 GMT
+Server: Apache/2.2.13 (Linux/SUSE)
+Cache-Control: no-cache
+Access-Control-Allow-Origin: *
+Transfer-Encoding: chunked
+Content-Type: text/xml;charset=UTF-8
+
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<geonames>
+<entry>
+<lang>en</lang>
+<title>Wyoming</title>
+<summary>The State of Wyoming  is a state in the western region of the United States of America. The majority of the state is dominated by the mountain ranges and rangelands of the Rocky Mountain West, while the easternmost section of the state is a high altitude prairie region known as the High Plains. The tenth largest U.S. state by size, Wyoming is the least populous, with a U.S (...)</summary>
+<feature>state</feature>
+<countryCode>US</countryCode>
+<population>0</population>
+<elevation>0</elevation>
+<lat>43</lat>
+<lng>-107.5</lng>
+<wikipediaUrl>http://en.wikipedia.org/wiki/Wyoming</wikipediaUrl>
+<thumbnailImg/>
+</entry>
+<entry>
+<lang>en</lang>
+<title>USS Orlando (PF-99)</title>
+<summary>USS ''Orlando'' (PF-99), a ''Tacoma''-class frigate, was the only ship of the United States Navy to be named for Orlando, Florida. She was authorized with the hull classification symbol PG-207 but reclassified PF-99 in April 1943. Her keel was laid down 2 August 1943 under a Maritime Commission Contract by American Ship Building Company, in Cleveland, Ohio (...)</summary>
+<feature/>
+<countryCode>  </countryCode>
+<population>0</population>
+<elevation>0</elevation>
+<lat>43</lat>
+<lng>165</lng>
+<wikipediaUrl>http://en.wikipedia.org/wiki/USS_Orlando_%28PF-99%29</wikipediaUrl>
+<thumbnailImg/>
+</entry>
+<entry>
+<lang>en</lang>
+<title>Point Edward, Ontario</title>
+<summary>Point Edward is a village (adjacent to Sarnia, Ontario) in the Canadian province of Ontario. Point Edward sits opposite Port Huron, Michigan at the mouth of the St. Clair River. As of 2006, the population was 2,019. The population in 2001 was 2,101. (A population change of -3.9%). The area is 3.27 square kilometres. In the summer of 2003, Point Edward celebrated its 125th anniversary (...)</summary>
+<feature>city</feature>
+<countryCode>CA</countryCode>
+<population>0</population>
+<elevation>0</elevation>
+<lat>43</lat>
+<lng>-82.4</lng>
+<wikipediaUrl>http://en.wikipedia.org/wiki/Point_Edward%2C_Ontario</wikipediaUrl>
+<thumbnailImg/>
+</entry>
+<entry>
+<lang>en</lang>
+<title>Greys River</title>
+<summary>with its confluence near Alpine in northern Lincoln County, Wyoming, USA. The river is about 65 miles (105 km.) in length, starting high up in the Wyoming Range, 40 miles south of the town of Alpine. The river eventually flows into the Snake River forming the Snake River Canyon."Greys River." ''Merriam-Webster's Geographical Dictionary'', 3rd ed. 2001 (...)</summary>
+<feature>adm2nd</feature>
+<countryCode>  </countryCode>
+<population>0</population>
+<elevation>0</elevation>
+<lat>43</lat>
+<lng>-110.8</lng>
+<wikipediaUrl>http://en.wikipedia.org/wiki/Greys_River</wikipediaUrl>
+<thumbnailImg/>
+</entry>
+<entry>
+<lang>en</lang>
+<title>Ömnögovi Province</title>
+<summary>(provinces) of Mongolia, located in the south of the country, in the Gobi Desert. Its capital is Dalanzadgad. The province is rich in mineral deposits, including gold and copper. Ömnögovi includes several well known tourist areas, including the Flaming Cliffs, Gobi Gurvansaikhan National Park and Khongoryn Els - The Singing Sand Dunes.  (...)</summary>
+<feature/>
+<countryCode>  </countryCode>
+<population>0</population>
+<elevation>0</elevation>
+<lat>43</lat>
+<lng>104.25</lng>
+<wikipediaUrl>http://en.wikipedia.org/wiki/%C3%96mn%C3%B6govi_Province</wikipediaUrl>
+<thumbnailImg/>
+</entry>
+<entry>
+<lang>en</lang>
+<title>Genesee County, New York</title>
+<summary>Genesee County is a county located in Western New York, United States. As of the 2000 census, the population was 60,370.[http://quickfacts.census.gov/qfd/states/36/36037.html U.S. Census Bureau, State &amp; County QuickFacts, Genesee County, New York] Its name is from the Seneca Indian word Gen-nis'-hee-yo meaning "The Beautiful Valley (...)</summary>
+<feature>adm2nd</feature>
+<countryCode>  </countryCode>
+<population>0</population>
+<elevation>0</elevation>
+<lat>43</lat>
+<lng>-78.19</lng>
+<wikipediaUrl>http://en.wikipedia.org/wiki/Genesee_County%2C_New_York</wikipediaUrl>
+<thumbnailImg/>
+</entry>
+<entry>
+<lang>en</lang>
+<title>Welland County, Ontario</title>
+<summary>Welland County (area, excluding cities was 226,970 acres) is a historic county in the Canadian province of Ontario. The county was formed in 1851 from Lincoln County. The county was named from the Welland River. The river got its name from John Grave Simcoe who named it after a stream in Lincolnshire, England (...)</summary>
+<feature>adm2nd</feature>
+<countryCode>CA</countryCode>
+<population>0</population>
+<elevation>0</elevation>
+<lat>43</lat>
+<lng>-79.0833</lng>
+<wikipediaUrl>http://en.wikipedia.org/wiki/Welland_County%2C_Ontario</wikipediaUrl>
+<thumbnailImg/>
+</entry>
+<entry>
+<lang>en</lang>
+<title>Middlesex County, Ontario</title>
+<summary>Middlesex County is a census division located in Western Ontario. The administrative centre of the county is the city of London, though the city is now separated from the jurisdiction of the county. The population of the county in 2006 was 422,333, of which 70,000 live outside of the city of London but the entire county is within the London census metropolitan area (...)</summary>
+<feature>adm2nd</feature>
+<countryCode>CA</countryCode>
+<population>0</population>
+<elevation>0</elevation>
+<lat>43</lat>
+<lng>-81.5</lng>
+<wikipediaUrl>http://en.wikipedia.org/wiki/Middlesex_County%2C_Ontario</wikipediaUrl>
+<thumbnailImg/>
+</entry>
+<entry>
+<lang>en</lang>
+<title>Otofuke, Hokkaidō</title>
+<summary>located in Katō District, Tokachi, Hokkaidō, Japan. As of 2004, the town has an estimated population of 41,935 and a density of 89.97 persons per km². The total area is 466.09 km².  (...)</summary>
+<feature>city</feature>
+<countryCode>JP</countryCode>
+<population>0</population>
+<elevation>0</elevation>
+<lat>43</lat>
+<lng>143.2</lng>
+<wikipediaUrl>http://en.wikipedia.org/wiki/Otofuke%2C_Hokkaid%C5%8D</wikipediaUrl>
+<thumbnailImg/>
+</entry>
+<entry>
+<lang>en</lang>
+<title>Yuni, Hokkaidō</title>
+<summary>is a town located in Yūbari District, Sorachi, Hokkaidō, Japan. As of 2004, the town has an estimated population of 6,677 and a density of 49.88 persons per km². The total area is 133.86 km².  (...)</summary>
+<feature>city</feature>
+<countryCode>JP</countryCode>
+<population>0</population>
+<elevation>0</elevation>
+<lat>43</lat>
+<lng>141.7833</lng>
+<wikipediaUrl>http://en.wikipedia.org/wiki/Yuni%2C_Hokkaid%C5%8D</wikipediaUrl>
+<thumbnailImg/>
+</entry>
+<entry>
+<lang>en</lang>
+<title>Kushiro, Hokkaidō (town)</title>
+<summary>located in Kushiro District, Kushiro Subprefecture, Hokkaidō, Japan. As of September 30, 2004 it has an estimated population of 22,602 and an area of 252.57 km².  (...)</summary>
+<feature>city</feature>
+<countryCode>JP</countryCode>
+<population>0</population>
+<elevation>0</elevation>
+<lat>43</lat>
+<lng>144.4667</lng>
+<wikipediaUrl>http://en.wikipedia.org/wiki/Kushiro%2C_Hokkaid%C5%8D_%28town%29</wikipediaUrl>
+<thumbnailImg/>
+</entry>
+</geonames>

data/spec/geonames/postal_code_search_criteria_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+module Geonames
+  describe PostalCodeSearchCriteria do
+    describe "#to_query_params_string" do
+      context "with a numeric latitude" do
+        let(:latitude) { 25.123 }
+        before(:each) { subject.latitude = latitude }
+        it("contains the lat parameter") { subject.to_query_params_string.should =~ /lat=#{latitude}/ }
+      end
+
+      context "with a numeric longitude" do
+        let(:longitude) { -52.123 }
+        before(:each) { subject.longitude = longitude }
+        it("contains the lng parameter") { subject.to_query_params_string.should =~ /lng=#{longitude}/ }
+      end
+
+      context "with a numeric max_rows" do
+        let(:max_rows) { 1 }
+        before(:each) { subject.max_rows = max_rows }
+        it("contains the maxRows parameter") { subject.to_query_params_string.should =~ /maxRows=#{max_rows}/ }
+      end
+
+      context "with a style" do
+        let(:style) { "SHORT" }
+        before(:each) { subject.style = style }
+        it("contains the style parameter") { subject.to_query_params_string.should =~ /style=#{style}/ }
+      end
+    end
+  end
+end

data/spec/geonames/web_service/country_code_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+module Geonames
+  describe WebService do
+    describe ".country_code" do
+      subject { WebService.country_code(latitude, longitude) }
+      let(:response) { File.read File.join(File.dirname(__FILE__), '..', '..', 'fixtures', 'countrycode', fixture) }
+
+      before { FakeWeb.register_uri :get, /\/countrycode\?.*lat=#{latitude}&lng=#{longitude}/, :response => response }
+      let(:fixture) { "canada.xml.http" }
+
+      let(:latitude)  { +43.900120387 }
+      let(:longitude) { -78.882869834 }
+
+      it { should be_a_kind_of(Array) }
+
+      it "returns Toponym instances" do
+        subject.each do |element|
+          element.should be_a_kind_of Toponym
+        end
+      end
+    end
+  end
+end

data/spec/geonames/web_service/country_info_spec.rb

@@ -0,0 +1,42 @@
+require 'spec_helper'
+
+module Geonames
+  describe WebService do
+    describe ".country_info" do
+      subject { country_info }
+      let(:country_info) { WebService.country_info(country_code) }
+      let(:response) { File.read File.join(File.dirname(__FILE__), '..', '..', 'fixtures', 'country_info', fixture) }
+
+      context "with a country code of 'TH'" do
+        before { FakeWeb.register_uri :get, /\/countryInfo\?.*&country=#{country_code}/, :response => response }
+        let(:fixture) { "thailand.xml.http" }
+        let(:country_code) { "TH" }
+
+        it { should be_a_kind_of(CountryInfo) }
+
+        its(:country_code)  { should == 'TH' }
+        its(:country_name)  { should == 'Thailand' }
+        its(:iso_numeric)   { should == 764 }
+        its(:iso_alpha_3)   { should == 'THA' }
+        its(:fips_code)     { should == 'TH' }
+        its(:continent)     { should == 'AS' }
+        its(:capital)       { should == 'Bangkok' }
+        its(:area_sq_km)    { should == 514000.0 }
+        its(:population)    { should == 67089500 }
+        its(:currency_code) { should == 'THB' }
+        its(:geoname_id)    { should == 1605651 }
+        its(:languages)     { should == ['th', 'en'] }
+
+        describe "#bounding_box" do
+          subject { country_info.bounding_box }
+
+          it { should be_a_kind_of(BoundingBox) }
+          its(:north_point) { should == 20.463194 }
+          its(:south_point) { should == 5.61 }
+          its(:east_point)  { should == 105.639389 }
+          its(:west_point)  { should == 97.345642 }
+        end
+      end
+    end
+  end
+end

data/spec/geonames/web_service/country_subdivision_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+module Geonames
+  describe WebService do
+    describe ".country_subdivision" do
+      subject { WebService.country_subdivision(latitude, longitude) }
+      let(:response) { File.read File.join(File.dirname(__FILE__), '..', '..', 'fixtures', 'country_subdivision', fixture) }
+
+      before { FakeWeb.register_uri :get, /\/countrySubdivision\?.*lat=#{latitude}&lng=#{longitude}/, :response => response }
+      let(:fixture) { "ontario.xml.http" }
+
+      let(:latitude)  { +43.900120387 }
+      let(:longitude) { -78.882869834 }
+
+      it { should be_a_kind_of(Array) }
+
+      it "returns CountrySubdivision instances" do
+        subject.each do |element|
+          element.should be_a_kind_of CountrySubdivision
+        end
+      end
+    end
+  end
+end

data/spec/geonames/web_service/find_bounding_box_wikipedia_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+module Geonames
+  describe WebService do
+    describe ".find_bounding_box_wikipedia" do
+      subject { WebService.find_bounding_box_wikipedia({ :north => north, :east => east, :south => south, :west => west }) }
+      let(:response) { File.read File.join(File.dirname(__FILE__), '..', '..', 'fixtures', 'wikipedia_bounding_box', fixture) }
+
+      # TODO Why doesn't mocking the following regex work?
+      # /\/wikipediaBoundingBox\?.*north=#{north}&east=#{east}&south=#{south}&west=#{west}/
+      before { FakeWeb.register_uri :get, /\/wikipediaBoundingBox\?/, :response => response }
+      let(:fixture) { "wyoming.xml.http" }
+
+      let(:north) { +43.900120387 }
+      let(:east)  { -78.882869834 }
+      let(:south) { +43.82 }
+      let(:west)  { +79.0  }
+
+      it { should be_a_kind_of(Array) }
+
+      it "returns WikipediaArticle instances" do
+        subject.each do |element|
+          element.should be_a_kind_of WikipediaArticle
+        end
+      end
+    end
+  end
+end

data/spec/geonames/web_service/find_nearby_place_name_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+module Geonames
+  describe WebService do
+    describe ".find_nearby_place_name" do
+      subject { WebService.find_nearby_place_name(latitude, longitude) }
+      let(:response) { File.read File.join(File.dirname(__FILE__), '..', '..', 'fixtures', 'find_nearby_place_name', fixture) }
+
+      before { FakeWeb.register_uri :get, /\/findNearbyPlaceName\?.*lat=#{latitude}&lng=#{longitude}/, :response => response }
+      let(:fixture) { "oshawa.xml.http" }
+
+      let(:latitude)  { +43.900120387 }
+      let(:longitude) { -78.882869834 }
+
+      it { should be_a_kind_of(Array) }
+
+      it "returns Toponym instances" do
+        subject.each do |element|
+          element.should be_a_kind_of Toponym
+        end
+      end
+    end
+  end
+end

data/spec/geonames/web_service/find_nearby_postal_codes_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+module Geonames
+  describe WebService do
+    describe ".find_nearby_postal_codes" do
+      subject { WebService.find_nearby_postal_codes(criteria) }
+      let(:response) { File.read File.join(File.dirname(__FILE__), '..', '..', 'fixtures', 'find_nearby_postal_codes', fixture) }
+
+      context "lookup by place name" do
+        before { FakeWeb.register_uri :get, /\/findNearbyPostalCodes\?.*&placename=Oshawa/, :response => response }
+        let(:fixture) { "oshawa.xml.http" }
+
+        let :criteria do
+          Geonames::PostalCodeSearchCriteria.new.tap do |criteria|
+            criteria.place_name = "Oshawa"
+          end
+        end
+
+        it { should be_a_kind_of(Array) }
+
+        it "returns PostalCode instances" do
+          subject.each do |element|
+            element.should be_a_kind_of PostalCode
+          end
+        end
+      end
+    end
+  end
+end

data/spec/geonames/web_service/find_nearby_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+
+module Geonames
+  describe WebService do
+    describe ".find_nearby" do
+      subject { WebService.find_nearby(latitude, longitude) }
+      let(:response) { File.read File.join(File.dirname(__FILE__), '..', '..', 'fixtures', 'find_nearby', fixture) }
+
+      before { FakeWeb.register_uri :get, /\/findNearby\?.*lat=#{latitude}&lng=#{longitude}/, :response => response }
+      let(:fixture) { "wilkinson.xml.http" }
+
+      let(:latitude)  { +37.501707 }
+      let(:longitude) { -122.468838 }
+
+      it { should be_a_kind_of(Array) }
+
+      it "returns Toponym instances" do
+        subject.each do |element|
+          element.should be_a_kind_of Toponym
+        end
+      end
+    end
+
+    describe ".find_nearby with full-style" do
+      let(:latitude)  { 48.18 }
+      let(:longitude) { 14.11 }
+      
+      before { FakeWeb.register_uri :get, /\/findNearby\?.*lat=#{latitude}&lng=#{longitude}/, :response => response }
+      let(:fixture) { "marchtrenk.xml.http" }
+      let(:response) { File.read File.join(File.dirname(__FILE__), '..', '..', 'fixtures', 'find_nearby', fixture) }
+
+      subject { WebService.find_nearby(latitude, longitude, style: 'FULL') }
+
+      it "return full Toponym instance" do
+        subject.each do |element|
+          element.should be_a_kind_of Toponym
+        end
+      end
+    end
+  end
+end

data/spec/geonames/web_service/find_nearby_wikipedia_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+module Geonames
+  describe WebService do
+    describe ".find_nearby_wikipedia" do
+      subject { WebService.find_nearby_wikipedia({ :lat => latitude, :long => longitude }) }
+      let(:response) { File.read File.join(File.dirname(__FILE__), '..', '..', 'fixtures', 'find_nearby_wikipedia', fixture) }
+
+      before { FakeWeb.register_uri :get, /\/findNearbyWikipedia\?.*lat=#{latitude}&lng=#{longitude}/, :response => response }
+      let(:fixture) { "general_motors_centre.xml.http" }
+
+      let(:latitude)  { +43.900120387 }
+      let(:longitude) { -78.882869834 }
+
+      context "lookup by latitude and longitude" do
+        it { should be_a_kind_of(Array) }
+
+        it "returns WikipediaArticle instances" do
+          subject.each do |element|
+            element.should be_a_kind_of WikipediaArticle
+          end
+        end
+      end
+    end
+  end
+end