GitHub - woodhull/graticule: Graticule is a geocoding API for looking up address coordinates and performing distance calculations, supporting many popular APIs.

This branch is 1 commit ahead of, 182 commits behind collectiveidea/graticule:master.

Name	Name	Last commit message	Last commit date
Latest commit Nathan Woodhull Slightly more aggressive error handling for Geocoder.us. Sometimes ge… Feb 12, 2009 4fd3e97 · Feb 12, 2009 History 60 Commits
bin	bin	added international geocoders	Mar 12, 2007
lib	lib	Slightly more aggressive error handling for Geocoder.us. Sometimes ge…	Feb 12, 2009
site	site	removed unnecessary style	Nov 24, 2008
test	test	Fix Google geocode result parsing to handle multiple result nodes in …	Jan 29, 2009
.gitignore	.gitignore	fix warnings when running tests	Aug 3, 2008
CHANGELOG.txt	CHANGELOG.txt	Added new files to manifest	Oct 4, 2008
LICENSE.txt	LICENSE.txt	released 0.1.1	Dec 16, 2006
Manifest.txt	Manifest.txt	Remove MapQuest geocoder that has been retired	Jan 8, 2009
README.txt	README.txt	Remove references to subversion	Nov 24, 2008
Rakefile	Rakefile	added rake tasks to update cached responses	Apr 25, 2007
init.rb	init.rb	migrated to hoe	Dec 16, 2006

Repository files navigation

= 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://github.com/collectiveidea/graticule. Patches and bug reports are welcome at http://collectiveidea.lighthouseapp.com/projects/20262-graticule