collectiveidea / graticule
- Source
- Commits
- Network (15)
- Issues (6)
- Downloads (5)
- Wiki (1)
- Graphs
-
Branch:
master
Graticule is a geocoding API for looking up address coordinates and performing distance calculations, supporting many popular APIs.
| name | age | message | |
|---|---|---|---|
 |
.autotest | Thu Oct 08 12:09:19 -0700 2009 | |
| |
.gitignore | Thu Feb 04 11:17:40 -0800 2010 | |
| |
CHANGELOG.txt | Mon Sep 21 15:23:31 -0700 2009 | |
| |
LICENSE.txt | Sat Dec 16 08:01:49 -0800 2006 | |
| |
README.txt | Sun Oct 04 17:38:39 -0700 2009 | |
| |
Rakefile | Sat Dec 05 20:57:13 -0800 2009 | |
| |
VERSION | Thu Feb 04 11:18:19 -0800 2010 | |
 |
bin/ | Mon Mar 12 10:54:30 -0700 2007 | |
| |
graticule.gemspec | Thu Feb 04 11:20:13 -0800 2010 | |
| |
init.rb | Fri Dec 15 20:35:27 -0800 2006 | |
| |
lib/ | Thu Feb 04 11:17:40 -0800 2010 | |
| |
site/ | Sun Nov 23 16:02:34 -0800 2008 | |
| |
test/ | Thu Feb 04 11:17:40 -0800 2010 |
README.txt
= Graticule
Graticule is a geocoding API for looking up address coordinates. It supports many popular APIs, including Yahoo,
Google, Geocoder.ca and Geocoder.us.
= 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
= Mailing List
Join us on the mailing list at http://groups.google.com/group/graticule
= 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.
