public
Description: Graticule is a geocoding API for looking up address coordinates and performing distance calculations, supporting many popular APIs.
Homepage: http://graticule.rubyforge.org/
Clone URL: git://github.com/collectiveidea/graticule.git
Click here to lend your support to: graticule and make a donation at www.pledgie.com !
name age message
file .gitignore Sun Aug 03 13:35:44 -0700 2008 fix warnings when running tests [brandon]
file CHANGELOG.txt Sat Oct 04 13:43:48 -0700 2008 Added new files to manifest [brandon]
file LICENSE.txt Sat Dec 16 08:01:49 -0800 2006 released 0.1.1 [brandon]
file Manifest.txt Sat Oct 04 13:43:48 -0700 2008 Added new files to manifest [brandon]
file README.txt Sat Mar 17 13:43:36 -0700 2007 added tests for local search maps and host ip [brandon]
file Rakefile Wed Apr 25 15:12:38 -0700 2007 added rake tasks to update cached responses [brandon]
directory bin/ Mon Mar 12 10:54:30 -0700 2007 added international geocoders [brandon]
file init.rb Fri Dec 15 20:35:27 -0800 2006 migrated to hoe [brandon]
directory lib/ Sat Oct 04 13:43:48 -0700 2008 Added new files to manifest [brandon]
directory site/ Tue Apr 24 11:40:39 -0700 2007 fixed google for queries like "sf ca" [brandon]
directory test/ Sat Oct 04 13:49:05 -0700 2008 Fixing broken test. [danielmorrison]
README.txt
= 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

= Source

The source code for Graticule is available at http://source.collectiveidea.com/public/geocode/trunk