geokit/geokit

# Geocoder CA geocoder implementation.  Requires the Geokit::Geocoders::GEOCODER_CA variable to
# contain true or false based upon whether authentication is to occur.  Conforms to the
# interface set by the Geocoder class.
#
# Returns a response like:
# <?xml version="1.0" encoding="UTF-8" ?>
# <geodata>
#   <latt>49.243086</latt>
#   <longt>-123.153684</longt>
# </geodata>
module Geokit
  module Geocoders
    class CaGeocoder < Geocoder
      config :key

      private

      # Template method which does the geocode lookup.
      def self.do_geocode(loc, _=nil)
        process :xml, submit_url(loc), GeoLoc.new
      end

      def self.parse_xml(xml, loc)
        loc.lat = xml.elements['//latt'].text
        loc.lng = xml.elements['//longt'].text
        loc.city = xml.elements['//city'].text
        loc.street_number = xml.elements['//stnumber'].text
        loc.street_address = xml.elements['//staddress'].text
        loc.state = xml.elements['//prov'].text
        loc.zip = xml.elements['//postal'].text
        loc.success = true
        loc
      end

      # Formats the request in the format acceptable by the CA geocoder.
      def self.submit_url(loc)
        loc_str = loc.is_a?(GeoLoc) ? loc.to_geocodeable_s : loc
        args = ["locate=#{Geokit::Inflector.url_escape(loc_str)}"]
        args << "auth=#{key}" if key
        args << 'geoit=xml'
        'http://geocoder.ca/?' + args.join('&')
      end
    end
  end
end