Geohash is a latitude/longitude encoding system invented by Gustavo Niemeyer when writing the web service at geohash.org, and put into the public domain. Geohashes offer properties like arbitrary precision, similar prefixes for nearby positions, and the possibility of gradually removing characters from the end of the code to reduce its size (and gradually lose precision).
For more information, see:
This code is available on Rubygems under the name "c_geohash", since the original "geohash" has not been updated since 2008.
Note to @davetroy: If you'd prefer to re-release this under the original name, that would be great. Feel free to drop me a line.
- Encode to Geohash format, to an arbitrary level of precision
- Decode from Geohash format, to an arbitrary level of precision
- C implementation is over 10 times faster than native Ruby code (we checked)
- GCC and a Gnu-ish build environment (for native extensions)
Add to your gemfile:
gem 'c_geohash', require: 'geohash'
GeoHash is very easy to use (and fast) because it's written in C with Ruby bindings.
require 'geohash'
GeoHash.encode(47.6062095, -122.3320708)
# => "c23nb62w20st"
GeoHash.encode(47.6062095, -122.3320708, 6)
# => "c23nb6"
#########
# Decode from geohash
GeoHash.decode("c23nb6")
# => [[47.603759765625, -122.332763671875], [47.6092529296875, -122.32177734375]]
#########
# Calculate adjacent geohash
GeoHash.neighbors("xn774c")
# => ["xn774f", "xn7754", "xn7751", "xn7750", "xn774b", "xn7748", "xn7749", "xn774d"]
You can encode or decode to an arbitrary level of precision:
- Encode latitude and longitude to a geohash with precision digits:
encode(lat, lon, precision=10)
- Decode a geohash to bbox:
decode(geohash)
- Get center from geohash to a latitude and longitude with decimals digits:
center(geohash, decimals=5)
- Install gem dependencies:
bundle install
- If using MRI, compile the C extension:
bundle exec rake compile
(if you're using JRuby, this step is unnecessary) - Run tests:
bundle exec rake test
- written by @davetroy
- updated for Ruby 1.9 by @anthonator
- updated for Ruby 2.x by @tryba