marco-ruby-geonames 0.2.7

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    MGU3Y2I0NGQzNjZjM2ZkMzI2MGJmNTZkYjM2ODMxNTc3YjhkMDQ2Mw==
+  data.tar.gz: !binary |-
+    ZmJkZDA5MGI3ZTdjY2RlNTAzNjFlZmJkMGY2YzM2ZGE5YjEzZTFjNA==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    Yjk5NGM2NzY1ZGI3MmU0YWVhMWM2NDRmZGU0NjhlMzJkY2M4MTUwOGMxMDIy
+    MGYzNDQ4NWEwODUzMWExYWJkOTUwYjIwOGQxZGViYjYwZWFlNThkZTJhMTcx
+    MGRiMTRmZTYwMDA3MTlmODc0Yjk0Mzk4ZWQ5Nzk0ZjM5NDUwYjY=
+  data.tar.gz: !binary |-
+    MGNmYTNkOTEzZTllNTUyOWRlZDk0YTg1YmJkNzlhMzg3ODZmZDNiN2Y2ZTE0
+    YzM0OGUzYTEwZDAxYWUwZmJjZTA4ZGY5YzAxYzJmMmNiZjM0MWUzN2IxNDky
+    ZGM3NmZiNWU0MGUxY2JiNWFjNTc2YTcwOWUxYTNhOTdhY2ExYzM=

data/README.markdown

@@ -0,0 +1,82 @@
+# Geonames Ruby API
+
+Ruby library for [Geonames Web Services](http://www.geonames.org/export/)
+
+Created by [TouchBase Counsulting](http://www.tbcn.ca/geonames) to support GIS processes for [Carpool Connect](http://www.carpoolconnect.com/). Inspired by the Geonames [Java Client API library](http://www.geonames.org/source-code/).
+
+## Installing ruby-geonames
+
+Install from the command line:
+
+    sudo gem install elecnix-ruby-geonames
+
+## Examples
+
+The following exercises several of the Geonames web services, [full list of services](http://www.geonames.org/export/).
+
+**Load the the geonames API**
+
+    require 'geonames'
+
+**get list of places near by longitude/longitude location**
+
+    places_nearby = Geonames::WebService.find_nearby_place_name 43.900120387, -78.882869834
+    p places_nearby
+
+outputs:
+
+`[#<Geonames::Toponym:0x6c8c98 @population=nil, @geoname_id='6094578', @longitude=-78.849568878, @feature_class_name=nil, @country_name='Canada', @latitude=43.900120387, @feature_class='P', @country_code='CA', @name='Oshawa', @feature_code_name=nil, @elevation=nil, @distance=2.6679930307932, @alternate_names=nil, @feature_code='PPL'>]`
+
+**get timezone for longitude/longitude location**
+
+    timezone = Geonames::WebService.timezone 43.900120387, -78.882869834
+    p timezone
+
+**get country code for longitude/longitude location**
+
+    country_code = Geonames::WebService.country_code 43.900120387, -78.882869834
+    p country_code
+
+**get country sub-division info for longitude/longitude location**
+
+    country_subdivision = Geonames::WebService.country_subdivision 43.900120387, -78.882869834
+    p country_subdivision
+
+**get postal codes for a given location**
+
+    postal_code_sc = Geonames::PostalCodeSearchCriteria.new
+    postal_code_sc.place_name = "Oshawa"
+    postal_codes = Geonames::WebService.postal_code_search postal_code_sc
+    p postal_codes
+
+**get nearby postal codes for a place name**
+
+    postal_code_sc = Geonames::PostalCodeSearchCriteria.new
+    postal_code_sc.place_name = "Oshawa"
+    postal_codes_nearby = Geonames::WebService.find_nearby_postal_codes postal_code_sc
+    p postal_codes_nearby
+
+## Language Support
+
+Geonames uses 'en' as the default locale. You can change the requested language like this:
+
+    Geonames.lang = 'de'
+
+In a Rails application, you could set the language from the I18n.locale:
+
+    Geonames.lang = I18n.locale
+
+## Commercial Service Support
+
+If you use the commercial service, you should put something like this in your configuration:
+
+    Geonames.username = 'username'
+    Geonames.base_url = 'http://ws.geonames.net'
+
+In a Rails application, this could go into `config/initializers/geonames.rb`.
+
+# Contributors
+
+    1. Adam Wisniewski
+    2. Nicolas Marchildon (elecnix)
+

data/lib/address.rb

@@ -0,0 +1,25 @@
+#=============================================================================
+#
+# Copyright 2007 Adam Wisniewski <adamw@tbcn.ca> 
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not
+# use this file except in compliance with the License. You may obtain a copy of
+# the License at 
+#
+#  http://www.apache.org/licenses/LICENSE-2.0 
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations under
+# the License.
+#
+#=============================================================================
+
+module Geonames
+  class Address
+    
+  end
+end
+
+

data/lib/bounding_box.rb

@@ -0,0 +1,18 @@
+module Geonames
+  class BoundingBox
+    attr_reader :north_point, :south_point, :east_point, :west_point
+    attr_writer :north_point, :south_point, :east_point, :west_point
+    
+    def initialize(north=0.0, south=0.0, east=0.0, west=0.0)
+      self.north_point = north
+      self.south_point = south
+      self.east_point = east
+      self.west_point = west
+    end
+    
+    def contains?(point)
+      #todo implement me
+      return false
+    end
+  end
+end

data/lib/country_info.rb

@@ -0,0 +1,36 @@
+module Geonames
+  class CountryInfo
+    attr_reader :country_code, :country_name, :iso_numeric, :iso_alpha_3
+    attr_reader :fips_code, :continent, :capital, :area_sq_km, :population
+    attr_reader :currency_code, :geoname_id
+    
+    attr_writer :country_code, :country_name, :iso_numeric, :iso_alpha_3
+    attr_writer :fips_code, :continent, :capital, :area_sq_km, :population
+    attr_writer :currency_code, :geoname_id
+    
+    def initialize
+      @langs = []
+      @bounding_box = BoundingBox.new()
+    end
+    
+    def bounding_box
+      return @bounding_box
+    end
+    
+    def bounding_box=(new_bb)
+      @bounding_box = new_bb
+    end
+    
+    def set_bounding_box(north, south, east, west)
+      @bounding_box = BoundingBox.new(north, south, east, west)
+    end
+    
+    def languages
+      return @langs
+    end
+    
+    def languages=(new_langs)
+      @langs = new_langs
+    end
+  end
+end

data/lib/country_subdivision.rb

@@ -0,0 +1,35 @@
+#=============================================================================
+#
+# Copyright 2007 Adam Wisniewski <adamw@tbcn.ca> 
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not
+# use this file except in compliance with the License. You may obtain a copy of
+# the License at 
+#
+#  http://www.apache.org/licenses/LICENSE-2.0 
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations under
+# the License.
+#
+#=============================================================================
+
+module Geonames
+    class CountrySubdivision
+        attr :country_code
+        attr :country_name
+        attr :admin_code_1
+        attr :admin_name_1
+        attr :code_fips
+        attr :code_iso
+        
+        attr_writer :country_code, :country_name
+        attr_writer :admin_name_1, :admin_code_1
+        attr_writer :code_fips, :code_iso
+        
+    end
+end
+
+

data/lib/geonames.rb

@@ -0,0 +1,61 @@
+#=============================================================================
+#
+# Copyright 2007 Adam Wisniewski <adamw@tbcn.ca> 
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not
+# use this file except in compliance with the License. You may obtain a copy of
+# the License at 
+#
+#  http://www.apache.org/licenses/LICENSE-2.0 
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations under
+# the License.
+#
+#=============================================================================
+
+require 'cgi'
+require 'net/http'
+require 'rexml/document'
+
+require 'web_service'
+require 'toponym'
+require 'toponym_search_result'
+require 'toponym_search_criteria'
+require 'postal_code'
+require 'postal_code_search_criteria'
+require 'timezone'
+require 'country_subdivision'
+require 'wikipedia_article'
+require 'intersection'
+
+module Geonames
+  autoload :Config,  'geonames/config'
+
+  GEONAMES_SERVER = "http://ws.geonames.org"
+  USER_AGENT = "geonames ruby webservice client 0.1"
+
+  class << self
+
+    def config
+      Thread.current[:geonames_config] ||= Geonames::Config.new
+    end
+
+    %w(lang username base_url).each do |method|
+      module_eval <<-DELEGATORS, __FILE__, __LINE__ + 1
+        def #{method}
+          config.#{method}
+        end
+
+        def #{method}=(value)
+          config.#{method} = (value)
+        end
+      DELEGATORS
+    end
+
+  end
+
+end
+

data/lib/intersection.rb

@@ -0,0 +1,42 @@
+#=============================================================================
+#
+# Copyright 2007 Adam Wisniewski <adamw@tbcn.ca> 
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not
+# use this file except in compliance with the License. You may obtain a copy of
+# the License at 
+#
+#  http://www.apache.org/licenses/LICENSE-2.0 
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations under
+# the License.
+#
+#=============================================================================
+
+module Geonames
+    class Intersection
+        attr :street_1
+        attr :street_2
+        attr :latitude
+        attr :longitude
+        attr :distance
+        attr :postal_code
+        attr :place_name
+        attr :country_code
+        attr :admin_code_1
+        attr :admin_name_2
+        attr :admin_code_2
+        attr :admin_name_1
+        
+        attr_writer :street_1, :street_2
+        attr_writer :postal_code, :place_name, :country_code
+        attr_writer :latitude, :longitude, :admin_name_1
+        attr_writer :admin_code_1, :admin_name_2, :admin_code_2
+        attr_writer :distance 
+    end
+end
+
+

data/lib/main.rb

@@ -0,0 +1,63 @@
+#=============================================================================
+#
+# Copyright 2007 Adam Wisniewski <adamw@tbcn.ca> 
+# Contributions by Andrew Turner, High Earth Orbit
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not
+# use this file except in compliance with the License. You may obtain a copy of
+# the License at 
+#
+#  http://www.apache.org/licenses/LICENSE-2.0 
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations under
+# the License.
+#
+#=============================================================================
+
+require 'geonames'
+require 'pp'
+
+# get the nearest intersection
+intersection = Geonames::WebService.find_nearest_intersection 40.7574053333333, -73.9734773333333
+puts intersection.street_1 #=> Park Ave
+puts intersection.street_2 #=> E 51st St
+
+# get wikipedia articles by lat / long
+articles_nearby = Geonames::WebService.find_nearby_wikipedia :lat => 43.900120387, :long => -78.882869834
+p articles_nearby
+
+# get wikipedia articles by bounding box
+articles_nearby = Geonames::WebService.find_bounding_box_wikipedia :north => 43.900120387, :east => -78.882869834, :south => 43.82, :west => 79.0
+p articles_nearby
+
+# get list of places near by longitude/longitude location
+places_nearby = Geonames::WebService.find_nearby_place_name 43.900120387, -78.882869834
+p places_nearby
+
+# get timezone for longitude/longitude location
+timezone = Geonames::WebService.timezone 43.900120387, -78.882869834
+p timezone
+
+# get country code for longitude/longitude location
+country_code = Geonames::WebService.country_code 43.900120387, -78.882869834
+p country_code
+
+# get country sub-division info for longitude/longitude location
+country_subdivision = Geonames::WebService.country_subdivision 43.900120387, -78.882869834
+p country_subdivision
+
+# get postal codes for a given location
+postal_code_sc = Geonames::PostalCodeSearchCriteria.new
+postal_code_sc.place_name = "Oshawa"
+postal_codes = Geonames::WebService.postal_code_search postal_code_sc
+p postal_codes
+
+# get nearby postal codes for a place name
+postal_code_sc = Geonames::PostalCodeSearchCriteria.new
+postal_code_sc.place_name = "Oshawa"
+postal_codes_nearby = Geonames::WebService.find_nearby_postal_codes postal_code_sc
+p postal_codes_nearby
+

data/lib/postal_code.rb

@@ -0,0 +1,40 @@
+#=============================================================================
+#
+# Copyright 2007 Adam Wisniewski <adamw@tbcn.ca> 
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not
+# use this file except in compliance with the License. You may obtain a copy of
+# the License at 
+#
+#  http://www.apache.org/licenses/LICENSE-2.0 
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations under
+# the License.
+#
+#=============================================================================
+
+module Geonames
+    class PostalCode
+        attr :postal_code
+        attr :place_name
+        attr :country_code
+        attr :latitude
+        attr :longitude
+        attr :admin_name_1
+        attr :admin_code_1
+        attr :admin_name_2
+        attr :admin_code_2
+        attr :distance
+        
+        attr_writer :postal_code, :place_name, :country_code
+        attr_writer :latitude, :longitude, :admin_name_1
+        attr_writer :admin_code_1, :admin_name_2, :admin_code_2
+        attr_writer :distance
+        
+    end
+end
+
+

data/lib/postal_code_search_criteria.rb

@@ -0,0 +1,84 @@
+#=============================================================================
+#
+# Copyright 2007 Adam Wisniewski <adamw@tbcn.ca> 
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not
+# use this file except in compliance with the License. You may obtain a copy of
+# the License at 
+#
+#  http://www.apache.org/licenses/LICENSE-2.0 
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations under
+# the License.
+#
+#=============================================================================
+
+module Geonames
+    class PostalCodeSearchCriteria
+
+	attr :postal_code
+        attr :place_name
+        attr :country_code
+        attr :latitude
+        attr :longitude
+        attr :style
+        attr :max_rows
+        attr :is_or_operator
+        attr :radius
+        
+        attr_writer :postal_code, :place_name, :country_code
+        attr_writer :latitude, :longitude, :style
+        attr_writer :max_rows,  :is_or_operator, :radius
+        
+        def initialize
+          @is_or_operator = false
+        end
+
+        def to_query_params_string
+            url = ''
+
+            if !@postal_code.nil? 
+              url = url + "&postalcode=" + CGI::escape( @postal_code )
+            end
+            
+            if !@place_name.nil? 
+              url = url + "&placename=" + CGI::escape( @place_name )
+            end
+            
+            if !@latitude.nil?
+                url = url + "&lat=" + CGI::escape( @latitude.to_s )
+            end
+            
+            if !@longitude.nil?
+                url = url + "&lng=" + CGI::escape( @longitude.to_s )
+            end
+
+            if !@style.nil?
+                url = url + "&style=" + CGI::escape( @style )
+            end
+            
+            if !@country_code.nil? 
+              url = url + "&country=" + CGI::escape( @country_code )
+            end
+            
+            if !@max_rows.nil? 
+              url = url + "&maxRows=" + CGI::escape( @max_rows.to_s )
+            end
+
+            if !@radius.nil? 
+              url = url + "&radius=" + CGI::escape( @radius.to_s )
+            end
+            
+            if @is_or_operator 
+              url = url + "&operator=OR"
+            end
+            
+            url
+        end
+    end
+end
+
+