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

woodhull / graticule Public

forked from collectiveidea/graticule

Notifications You must be signed in to change notification settings
Fork 0
Star 2

Graticule is a geocoding API for looking up address coordinates and performing distance calculations, supporting many popular APIs.

graticule.rubyforge.org/

View license

2 stars 53 forks Branches Tags Activity

Star

Notifications

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 60 Commits
bin		bin
lib		lib
site		site
test		test
.gitignore		.gitignore
CHANGELOG.txt		CHANGELOG.txt
LICENSE.txt		LICENSE.txt
Manifest.txt		Manifest.txt
README.txt		README.txt
Rakefile		Rakefile
init.rb		init.rb

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