MIT-LICENSE @@ -10,6 +10,18 @@ Set the default geocoder in the bottom of your environment.rb file. Example: Geocode.geocoder = Yahoo::Geocode.new 'your_api_key' +Then, in each model you want to make geocodable, add "acts_as_geocodable". For example, + +class Stores < ActiveRecord::Base + acts_as_geocodable +end + +Alternatively, you if you use the address methods below (or provide setters), you can automatically update the address fields if the geocoding process returns more accurate data + +class Stores < ActiveRecord::Base + acts_as_geocodable :normalize_address => true +end + Each Model that acts_as_geocodable needs to have a some sort of address. This is always referenced via the provided full_address method. You can use any field names for you addresses, but if they are different than mine (street, city, state, zip), you will have to provide your own full_address method that concatenates them together. def full_address README @@ -1,3 +1,26 @@ +# While modified by Daniel Morrison, this file mostly written by Rick Olson. +# +# Copyright (c) 2006 Rick Olson +# +# Permission is hereby granted, free of charge, to any person obtaining +# a copy of this software and associated documentation files (the +# "Software"), to deal in the Software without restriction, including +# without limitation the rights to use, copy, modify, merge, publish, +# distribute, sublicense, and/or sell copies of the Software, and to +# permit persons to whom the Software is furnished to do so, subject to +# the following conditions: +# +# The above copyright notice and this permission notice shall be +# included in all copies or substantial portions of the Software. +# +# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE +# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION +# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +# $:.unshift(File.dirname(__FILE__) + '/../lib') require 'test/unit' test/test_helper.rb 3345500da6cb16d6c19d43f2fd13a69472a2ed13 Daniel Morrison daniel@collectiveidea.com http://github.com/collectiveidea/acts_as_geocodable/commit/d9e33a35e35dfc95ecfab23689181caebaa90e8c d9e33a35e35dfc95ecfab23689181caebaa90e8c 2006-10-01T22:08:33-07:00 2006-10-01T22:08:33-07:00 Updated README and added license information 7fe673fa16008ef51d0f9cb551324689d62b61ed Daniel Morrison daniel@collectiveidea.com