aub-graticule 0.2.11

data/.gitignore

@@ -0,0 +1,4 @@
+test/config.yml
+*.gem
+pkg
+coverage

data/CHANGELOG.txt

@@ -0,0 +1,61 @@
+0.2.11 (2009-07-15)
+* Add new MapQuest geocoder [Aubrey Holland]
+
+0.2.10 (2009-04-17)
+* Added #blank? to Location
+
+0.2.9 (2009-04-14)
+* Remove retired MapQuest geocoder
+* Slightly more aggressive error handling for Geocoder.us
+* Extend Numeric with #to_radians and #to_degrees
+
+0.2.8 (2008-10-03)
+* fixed missing files from gem
+
+0.2.7 (2008-10-03)
+* Adding Multimap geocoder [Tom Taylor]
+* Added MapQuest geocoder [Andrew Selder]
+* Fix google geocoder for responses that only return coordinates [Andrew Selder]
+
+0.2.5
+* fixed address mapping for local search maps (again)
+
+0.2.4 (2007-05-15)
+* fixed address mapping for local search maps (Tom Taylor)
+
+0.2.3 (2007-04-27)
+* fixed Google for less precise queries
+* added User-Agent to coerce Google into returning UTF-8 (Jonathan Tron)
+
+0.2.2 (2007-03-27)
+* fixed LocalSearchMaps
+
+0.2.1 (2007-03-19)
+* fixed error in command line interface
+
+0.2.0 (2007-03-17)
+* changed city to locality, state to region, and zip to postal_code
+* added support for PostcodeAnywhere
+* added support for Local Search Maps (James Stewart)
+* added IP-based geocoder
+* moved geocoders to Graticule::Geocoder namespace
+* fixed Google geocoder (again)
+* made Yahoo geocoder consistent with others by returning 1 result
+* geocoders can how take a Hash (:street, :locality, :region, :postal_code, :country)
+  or a Graticule::Location for the #locate call
+
+0.1.3 (2007-02-14)
+* fixed Google geocoder
+* fixed CLI
+
+0.1.2 (2007-02-12)
+* added "geocode" executable. See "geocode --help" for more information
+* declared dependency on ActiveSupport
+
+0.1.1 (2006-12-16)
+* fixed bug in Yahoo that raised error when street address not returned
+* migrated to Hoe (http://seattlerb.rubyforge.org/hoe/)
+* added Haversine, Spherical and Vincenty distance calculations
+
+0.1 (2006-10-31)
+* Initial release

data/LICENSE.txt

@@ -0,0 +1,30 @@
+Copyright 2006 Brandon Keepers, Collective Idea.  All rights reserved.
+
+Original geocoding code:
+  Copyright 2006 Eric Hodel, The Robot Co-op.  All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+3. Neither the names of the authors nor the names of their contributors
+   may be used to endorse or promote products derived from this software
+   without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
+OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
+OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

data/Manifest.txt

@@ -0,0 +1,84 @@
+CHANGELOG.txt
+LICENSE.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/geocode
+init.rb
+lib/graticule.rb
+lib/graticule/cli.rb
+lib/graticule/core_ext.rb
+lib/graticule/distance.rb
+lib/graticule/distance/haversine.rb
+lib/graticule/distance/spherical.rb
+lib/graticule/distance/vincenty.rb
+lib/graticule/geocoder.rb
+lib/graticule/geocoder/base.rb
+lib/graticule/geocoder/bogus.rb
+lib/graticule/geocoder/geocoder_ca.rb
+lib/graticule/geocoder/geocoder_us.rb
+lib/graticule/geocoder/google.rb
+lib/graticule/geocoder/host_ip.rb
+lib/graticule/geocoder/local_search_maps.rb
+lib/graticule/geocoder/mapquest.rb
+lib/graticule/geocoder/meta_carta.rb
+lib/graticule/geocoder/multi.rb
+lib/graticule/geocoder/multimap.rb
+lib/graticule/geocoder/postcode_anywhere.rb
+lib/graticule/geocoder/rest.rb
+lib/graticule/geocoder/yahoo.rb
+lib/graticule/location.rb
+lib/graticule/version.rb
+site/index.html
+site/plugin.html
+site/stylesheets/style.css
+test/config.yml.default
+test/fixtures/responses/geocoder_us/success.xml
+test/fixtures/responses/geocoder_us/unknown.xml
+test/fixtures/responses/google/badkey.xml
+test/fixtures/responses/google/limit.xml
+test/fixtures/responses/google/missing_address.xml
+test/fixtures/responses/google/only_coordinates.xml
+test/fixtures/responses/google/partial.xml
+test/fixtures/responses/google/server_error.xml
+test/fixtures/responses/google/success.xml
+test/fixtures/responses/google/success_multiple_results.xml
+test/fixtures/responses/google/unavailable.xml
+test/fixtures/responses/google/unknown_address.xml
+test/fixtures/responses/host_ip/private.txt
+test/fixtures/responses/host_ip/success.txt
+test/fixtures/responses/host_ip/unknown.txt
+test/fixtures/responses/local_search_maps/empty.txt
+test/fixtures/responses/local_search_maps/not_found.txt
+test/fixtures/responses/local_search_maps/success.txt
+test/fixtures/responses/mapquest/multi_result.xml
+test/fixtures/responses/mapquest/success.xml
+test/fixtures/responses/meta_carta/bad_address.xml
+test/fixtures/responses/meta_carta/multiple.xml
+test/fixtures/responses/meta_carta/success.xml
+test/fixtures/responses/multimap/missing_params.xml
+test/fixtures/responses/multimap/no_matches.xml
+test/fixtures/responses/multimap/success.xml
+test/fixtures/responses/postcode_anywhere/badkey.xml
+test/fixtures/responses/postcode_anywhere/canada.xml
+test/fixtures/responses/postcode_anywhere/empty.xml
+test/fixtures/responses/postcode_anywhere/success.xml
+test/fixtures/responses/postcode_anywhere/uk.xml
+test/fixtures/responses/yahoo/success.xml
+test/fixtures/responses/yahoo/unknown_address.xml
+test/mocks/uri.rb
+test/test_helper.rb
+test/unit/graticule/distance_test.rb
+test/unit/graticule/geocoder/geocoder_us_test.rb
+test/unit/graticule/geocoder/geocoders.rb
+test/unit/graticule/geocoder/google_test.rb
+test/unit/graticule/geocoder/host_ip_test.rb
+test/unit/graticule/geocoder/local_search_maps_test.rb
+test/unit/graticule/geocoder/mapquest_test.rb
+test/unit/graticule/geocoder/meta_carta_test.rb
+test/unit/graticule/geocoder/multi_test.rb
+test/unit/graticule/geocoder/multimap_test.rb
+test/unit/graticule/geocoder/postcode_anywhere_test.rb
+test/unit/graticule/geocoder/yahoo_test.rb
+test/unit/graticule/geocoder_test.rb
+test/unit/graticule/location_test.rb

data/README.txt

@@ -0,0 +1,41 @@
+= Graticule
+
+Graticule is a geocoding API for looking up address coordinates.  It supports many popular APIs, including Yahoo, Google, Geocoder.ca, Geocoder.us, PostcodeAnywhere and MetaCarta.
+
+= Usage
+
+  require 'rubygems'
+  require 'graticule'
+  geocoder = Graticule.service(:google).new "api_key"
+  location = geocoder.locate "61 East 9th Street, Holland, MI"
+
+= Distance Calculation
+
+Graticule includes 3 different distance formulas, Spherical (simplest but least accurate), Vincenty (most accurate and most complicated), and Haversine (somewhere inbetween).
+
+  geocoder.locate("Holland, MI").distance_to(geocoder.locate("Chicago, IL"))
+  #=> 101.997458788177
+  
+= Command Line
+
+Graticule includes a command line interface (CLI).
+
+  $ geocode -s yahoo -a yahookey Washington, DC
+  Washington, DC US
+  latitude: 38.895222, longitude: -77.036758
+
+= How to contribute
+
+If you find what you might think is a bug:
+
+1. Check the GitHub issue tracker to see if anyone else has had the same issue.
+   http://github.com/collectiveidea/graticule/issues/
+2. If you don't see anything, create an issue with information on how to reproduce it.
+
+If you want to contribute an enhancement or a fix:
+
+1. Fork the project on github.
+   http://github.com/collectiveidea/graticule/
+2. Make your changes with tests.
+3. Commit the changes without making changes to the Rakefile, VERSION, or any other files that aren't related to your enhancement or fix
+4. Send a pull request.

data/Rakefile

@@ -0,0 +1,143 @@
+begin
+  require 'jeweler'
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+  exit 1
+end
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rcov/rcovtask'
+
+Jeweler::Tasks.new do |s|
+  s.name = "graticule"
+  s.rubyforge_project = "graticule"
+  s.author = 'Brandon Keepers'
+  s.email = 'brandon@opensoul.org'
+  s.summary = "API for using all the popular geocoding services."
+  s.description = 'Graticule is a geocoding API that provides a common interface to all the popular services, including Google, Yahoo, Geocoder.us, and MetaCarta.'
+  s.homepage = "http://github.com/collectiveidea/graticule"
+  s.add_dependency "activesupport"
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["README.txt"]
+  s.rdoc_options = ["--main", "README.rdoc", "--inline-source", "--line-numbers"]
+  s.test_files = Dir['test/**/*.{yml,rb}']
+end
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Run the unit tests'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentatio'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Graticule'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README.txt')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+namespace :test do
+  desc "just rcov minus html output"
+  Rcov::RcovTask.new(:coverage) do |t|
+    # t.libs << 'test'
+    t.test_files = FileList['test/**/*_test.rb']
+    t.output_dir = 'coverage'
+    t.verbose = true
+    t.rcov_opts = %w(--exclude test,/usr/lib/ruby,/Library/Ruby,$HOME/.gem --sort coverage)
+  end
+end
+
+require 'rake/contrib/sshpublisher'
+namespace :rubyforge do
+
+  desc "Release gem and RDoc documentation to RubyForge"
+  task :release => ["rubyforge:release:gem", "rubyforge:release:docs"]
+
+  namespace :release do
+    desc "Publish RDoc to RubyForge."
+    task :docs => [:rdoc] do
+      config = YAML.load(
+          File.read(File.expand_path('~/.rubyforge/user-config.yml'))
+      )
+
+      host = "#{config['username']}@rubyforge.org"
+      remote_dir = "/var/www/gforge-projects/the-perfect-gem/"
+      local_dir = 'rdoc'
+
+      Rake::SshDirPublisher.new(host, remote_dir, local_dir).upload
+    end
+  end
+end
+
+namespace :test do
+  namespace :cache do
+    desc 'Cache test responses from all the free geocoders'
+    task :free => [:google, :geocoder_us, :host_ip, :local_search_maps, :meta_carta, :yahoo]
+    
+    desc 'Cache test responses from Google'
+    task :google do
+      cache_responses('google')
+    end
+    
+    desc 'Cache test responses from Geocoder.us'
+    task :geocoder_us do
+      cache_responses('geocoder_us')
+    end
+    
+    desc 'Cache test responses from HostIP'
+    task :host_ip do
+      cache_responses('host_ip')
+    end
+
+    desc 'Cache test responses from Local Search Maps'
+    task :local_search_maps do
+      cache_responses('local_search_maps')
+    end
+
+    desc 'Cache test responses from Meta Carta'
+    task :meta_carta do
+      cache_responses('meta_carta')
+    end
+
+    desc 'Cache test responses from Yahoo'
+    task :yahoo do
+      cache_responses('yahoo')
+    end
+
+  end
+end
+
+require 'active_support'
+require 'net/http'
+require 'uri'
+RESPONSES_PATH = File.dirname(__FILE__) + '/test/fixtures/responses'
+
+def cache_responses(service)
+  test_config[service.to_s]['responses'].each do |file,url|
+    File.open("#{RESPONSES_PATH}/#{service}/#{file}", 'w') do |f|
+      f.puts Net::HTTP.get(URI.parse(url))
+    end
+  end
+end
+
+def test_config
+  file = File.dirname(__FILE__) + '/test/config.yml'
+  raise "Copy config.yml.default to config.yml and set the API keys" unless File.exists?(file)
+  @test_config ||= returning(YAML.load(File.read(file))) do |config|
+    config.each do |service,values|
+      values['responses'].each {|file,url| update_placeholders!(values, url) }
+    end
+  end
+end
+
+def update_placeholders!(config, thing)
+  config.each do |option, value|
+    thing.gsub!(":#{option}", value) if value.is_a?(String)
+  end
+end

data/VERSION

@@ -0,0 +1 @@
+0.2.11

data/bin/geocode

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'graticule/cli'
+
+Graticule::Cli.start ARGV

data/graticule.gemspec

@@ -0,0 +1,143 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{graticule}
+  s.version = "0.2.11"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Brandon Keepers"]
+  s.date = %q{2009-07-20}
+  s.default_executable = %q{geocode}
+  s.description = %q{Graticule is a geocoding API that provides a common interface to all the popular services, including Google, Yahoo, Geocoder.us, and MetaCarta.}
+  s.email = %q{brandon@opensoul.org}
+  s.executables = ["geocode"]
+  s.extra_rdoc_files = [
+    "README.txt"
+  ]
+  s.files = [
+    ".gitignore",
+     "CHANGELOG.txt",
+     "LICENSE.txt",
+     "Manifest.txt",
+     "README.txt",
+     "Rakefile",
+     "VERSION",
+     "bin/geocode",
+     "graticule.gemspec",
+     "init.rb",
+     "lib/graticule.rb",
+     "lib/graticule/cli.rb",
+     "lib/graticule/core_ext.rb",
+     "lib/graticule/distance.rb",
+     "lib/graticule/distance/haversine.rb",
+     "lib/graticule/distance/spherical.rb",
+     "lib/graticule/distance/vincenty.rb",
+     "lib/graticule/geocoder.rb",
+     "lib/graticule/geocoder/base.rb",
+     "lib/graticule/geocoder/bogus.rb",
+     "lib/graticule/geocoder/geocoder_ca.rb",
+     "lib/graticule/geocoder/geocoder_us.rb",
+     "lib/graticule/geocoder/google.rb",
+     "lib/graticule/geocoder/host_ip.rb",
+     "lib/graticule/geocoder/local_search_maps.rb",
+     "lib/graticule/geocoder/mapquest.rb",
+     "lib/graticule/geocoder/meta_carta.rb",
+     "lib/graticule/geocoder/multi.rb",
+     "lib/graticule/geocoder/multimap.rb",
+     "lib/graticule/geocoder/postcode_anywhere.rb",
+     "lib/graticule/geocoder/rest.rb",
+     "lib/graticule/geocoder/yahoo.rb",
+     "lib/graticule/location.rb",
+     "lib/graticule/version.rb",
+     "site/index.html",
+     "site/plugin.html",
+     "site/stylesheets/style.css",
+     "test/config.yml.default",
+     "test/fixtures/responses/geocoder_us/success.xml",
+     "test/fixtures/responses/geocoder_us/unknown.xml",
+     "test/fixtures/responses/google/badkey.xml",
+     "test/fixtures/responses/google/limit.xml",
+     "test/fixtures/responses/google/missing_address.xml",
+     "test/fixtures/responses/google/only_coordinates.xml",
+     "test/fixtures/responses/google/partial.xml",
+     "test/fixtures/responses/google/server_error.xml",
+     "test/fixtures/responses/google/success.xml",
+     "test/fixtures/responses/google/success_multiple_results.xml",
+     "test/fixtures/responses/google/unavailable.xml",
+     "test/fixtures/responses/google/unknown_address.xml",
+     "test/fixtures/responses/host_ip/private.txt",
+     "test/fixtures/responses/host_ip/success.txt",
+     "test/fixtures/responses/host_ip/unknown.txt",
+     "test/fixtures/responses/local_search_maps/empty.txt",
+     "test/fixtures/responses/local_search_maps/not_found.txt",
+     "test/fixtures/responses/local_search_maps/success.txt",
+     "test/fixtures/responses/mapquest/multi_result.xml",
+     "test/fixtures/responses/mapquest/success.xml",
+     "test/fixtures/responses/meta_carta/bad_address.xml",
+     "test/fixtures/responses/meta_carta/multiple.xml",
+     "test/fixtures/responses/meta_carta/success.xml",
+     "test/fixtures/responses/multimap/missing_params.xml",
+     "test/fixtures/responses/multimap/no_matches.xml",
+     "test/fixtures/responses/multimap/success.xml",
+     "test/fixtures/responses/postcode_anywhere/badkey.xml",
+     "test/fixtures/responses/postcode_anywhere/canada.xml",
+     "test/fixtures/responses/postcode_anywhere/empty.xml",
+     "test/fixtures/responses/postcode_anywhere/success.xml",
+     "test/fixtures/responses/postcode_anywhere/uk.xml",
+     "test/fixtures/responses/yahoo/success.xml",
+     "test/fixtures/responses/yahoo/unknown_address.xml",
+     "test/mocks/uri.rb",
+     "test/test_helper.rb",
+     "test/unit/graticule/distance_test.rb",
+     "test/unit/graticule/geocoder/geocoder_us_test.rb",
+     "test/unit/graticule/geocoder/geocoders.rb",
+     "test/unit/graticule/geocoder/google_test.rb",
+     "test/unit/graticule/geocoder/host_ip_test.rb",
+     "test/unit/graticule/geocoder/local_search_maps_test.rb",
+     "test/unit/graticule/geocoder/mapquest_test.rb",
+     "test/unit/graticule/geocoder/meta_carta_test.rb",
+     "test/unit/graticule/geocoder/multi_test.rb",
+     "test/unit/graticule/geocoder/multimap_test.rb",
+     "test/unit/graticule/geocoder/postcode_anywhere_test.rb",
+     "test/unit/graticule/geocoder/yahoo_test.rb",
+     "test/unit/graticule/geocoder_test.rb",
+     "test/unit/graticule/location_test.rb"
+  ]
+  s.homepage = %q{http://github.com/collectiveidea/graticule}
+  s.rdoc_options = ["--main", "README.rdoc", "--inline-source", "--line-numbers"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{graticule}
+  s.rubygems_version = %q{1.3.3}
+  s.summary = %q{API for using all the popular geocoding services.}
+  s.test_files = [
+    "test/mocks/uri.rb",
+     "test/test_helper.rb",
+     "test/unit/graticule/distance_test.rb",
+     "test/unit/graticule/geocoder/geocoder_us_test.rb",
+     "test/unit/graticule/geocoder/geocoders.rb",
+     "test/unit/graticule/geocoder/google_test.rb",
+     "test/unit/graticule/geocoder/host_ip_test.rb",
+     "test/unit/graticule/geocoder/local_search_maps_test.rb",
+     "test/unit/graticule/geocoder/mapquest_test.rb",
+     "test/unit/graticule/geocoder/meta_carta_test.rb",
+     "test/unit/graticule/geocoder/multi_test.rb",
+     "test/unit/graticule/geocoder/multimap_test.rb",
+     "test/unit/graticule/geocoder/postcode_anywhere_test.rb",
+     "test/unit/graticule/geocoder/yahoo_test.rb",
+     "test/unit/graticule/geocoder_test.rb",
+     "test/unit/graticule/location_test.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activesupport>, [">= 0"])
+    else
+      s.add_dependency(%q<activesupport>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<activesupport>, [">= 0"])
+  end
+end

data/init.rb

@@ -0,0 +1,2 @@
+
+require 'graticule'

data/lib/graticule/cli.rb

@@ -0,0 +1,64 @@
+require 'graticule'
+require 'optparse'
+
+module Graticule
+  
+  # A command line interface for geocoding.  From the command line, run:
+  #
+  #   geocode 49423 
+  #
+  # Outputs:
+  #
+  #   # Holland, MI 49423 US
+  #   # latitude: 42.7654, longitude: -86.1085
+  #
+  # == Usage: geocode [options] location
+  # 
+  # Options: 
+  #     -s, --service service            Geocoding service
+  #     -a, --apikey apikey              API key for the selected service
+  #     -h, --help                       Help
+  class Cli
+    
+    def self.start(args, out = STDOUT)
+      options = { :service => :yahoo, :api_key => 'YahooDemo' }
+      
+      OptionParser.new do |opts|
+        opts.banner = "Usage: geocode [options] location"
+        opts.separator ""
+        opts.separator "Options: "
+
+        opts.on("-s service", %w(yahoo google geocoder_us metacarta), "--service service", "Geocoding service") do |service|
+          options[:service] = service
+        end
+        
+        opts.on("-a apikey", "--apikey apikey", "API key for the selected service")
+        
+        opts.on_tail("-h", "--help", "Help") do
+          puts opts
+          exit
+        end
+      end.parse! args
+
+      options[:location] = args.join(" ")
+      
+      result = Graticule.service(options[:service]).new(*options[:api_key].split(',')).locate(options[:location])
+      location = (result.is_a?(Array) ? result.first : result)
+      if location
+        out << location.to_s(:coordinates => true)
+        exit 0
+      else
+        out << "Location not found"
+        exit 1
+      end
+    rescue Graticule::CredentialsError
+      $stderr.puts "Invalid API key. Pass your #{options[:service]} API key using the -a option. "
+    rescue OptionParser::InvalidArgument, OptionParser::InvalidOption,
+        Graticule::Error => error
+      $stderr.puts error.message
+    end
+    
+    
+  end
+end
+

data/lib/graticule/core_ext.rb

@@ -0,0 +1,15 @@
+module Graticule
+  module RadiansAndDegrees
+    # Convert from degrees to radians
+    def to_radians
+      ( self / 360.0 ) * Math::PI * 2
+    end
+  
+    # Convert from radians to degrees
+    def to_degrees
+      ( self * 360.0 ) / Math::PI / 2
+    end
+  end
+end
+
+Numeric.send :include, Graticule::RadiansAndDegrees

data/lib/graticule/distance/haversine.rb

@@ -0,0 +1,40 @@
+module Graticule
+  module Distance
+    #
+    # The Haversine Formula works better at small distances than the Spherical Law of Cosines
+    #
+    # Thanks to Chris Veness (http://www.movable-type.co.uk/scripts/LatLong.html)
+    # for distance formulas.
+    #
+    class Haversine < DistanceFormula
+      
+      # Calculate the distance between two Locations using the Haversine formula
+      #
+      #   Graticule::Distance::Haversine.distance(
+      #     Graticule::Location.new(:latitude => 42.7654, :longitude => -86.1085),
+      #     Graticule::Location.new(:latitude => 41.849838, :longitude => -87.648193)
+      #   )
+      #   #=> 101.061720831836
+      #
+      def self.distance(from, to, units = :miles)
+        from_longitude  = from.longitude.to_radians
+        from_latitude   = from.latitude.to_radians
+        to_longitude    = to.longitude.to_radians
+        to_latitude     = to.latitude.to_radians
+
+        latitude_delta  = to_latitude - from_latitude
+        longitude_delta = to_longitude - from_longitude
+
+        a = sin(latitude_delta/2)**2 + 
+            cos(from_latitude) * 
+            cos(to_latitude) * 
+            sin(longitude_delta/2)**2
+
+        c = 2 * atan2(sqrt(a), sqrt(1-a))
+
+        d = EARTH_RADIUS[units.to_sym] * c
+      end
+
+    end
+  end
+end