Contents

module Geokit
  module Geocoders
    # Another geocoding web service
    # http://www.geonames.org
    class GeonamesGeocoder < Geocoder
      config :key, :premium

      private

      # Template method which does the geocode lookup.
      def self.do_geocode(address)
        process :xml, submit_url(address)
      end

      def self.submit_url(address)
        if key.nil? || key.empty?
          raise(Geokit::Geocoders::GeocodeError, "Geonames requires a key to use their service.")
        end

        address_str = address.is_a?(GeoLoc) ? address.to_geocodeable_s : address
        # geonames need a space seperated search string
        address_str.gsub!(/,/, " ")
        params = "/postalCodeSearch?placename=#{Geokit::Inflector.url_escape(address_str)}&maxRows=10"

        if premium
          "http://ws.geonames.net#{params}&username=#{key}"
        else
          "http://api.geonames.org#{params}&username=#{key}"
        end
      end

      XML_MAPPINGS = {
        city:         "name",
        state_name:   "adminName1",
        state_code:   "adminCode1",
        zip:          "postalcode",
        country_code: "countryCode",
        lat:          "lat",
        lng:          "lng",
      }

      def self.parse_xml(xml)
        count = xml.elements["geonames/totalResultsCount"]
        return GeoLoc.new unless !count.nil? && count.text.to_i > 0
        loc = new_loc
        # only take the first result
        set_mappings(loc, xml.elements["geonames/code"], XML_MAPPINGS)
        loc.success = true
        loc
      end
    end
  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
geokit-1.10.0	lib/geokit/geocoders/geonames.rb