module GeoHash

begin¶ ↑

geohash.rb Geohash library for pure ruby Distributed under the MIT License

end¶ ↑

Constants

BASE32
BITS
BORDERS
NEIGHBORS
VERSION

Public Class Methods

adjacent(geohash, dir) click to toggle source

Calculate adjacents geohash

# File lib/pr_geohash.rb, line 66
def adjacent(geohash, dir)
  base, lastChr = geohash[0..-2], geohash[-1,1]
  type = (geohash.length % 2)==1 ? :odd : :even
  if BORDERS[dir][type].include?(lastChr)
    base = adjacent(base, dir)
  end
  base + BASE32[NEIGHBORS[dir][type].index(lastChr),1]
end

decode(geohash) click to toggle source

Decode from geohash

geohash: geohash code
return: decoded bounding box [[north latitude, west longitude],[south latitude, east longitude]]

# File lib/pr_geohash.rb, line 22
def decode(geohash)
  latlng = [[-90.0, 90.0], [-180.0, 180.0]]
  is_lng = 1
  geohash.downcase.scan(/./) do |c|
    BITS.each do |mask|
      latlng[is_lng][(BASE32.index(c) & mask)==0 ? 1 : 0] = (latlng[is_lng][0] + latlng[is_lng][1]) / 2
      is_lng ^= 1
    end
  end
  latlng.transpose
end

encode(latitude, longitude, precision=12) click to toggle source

Encode latitude and longitude into geohash

# File lib/pr_geohash.rb, line 37
def encode(latitude, longitude, precision=12)
  latlng = [latitude, longitude]
  points = [[-90.0, 90.0], [-180.0, 180.0]]
  is_lng = 1
  (0...precision).map {
    ch = 0
    5.times do |bit|
      mid = (points[is_lng][0] + points[is_lng][1]) / 2
      points[is_lng][latlng[is_lng] > mid ? 0 : 1] = mid
      ch |=  BITS[bit] if latlng[is_lng] > mid
      is_lng ^= 1
    end
    BASE32[ch,1]
  }.join
end

neighbors(geohash) click to toggle source

Calculate neighbors (8 adjacents) geohash

# File lib/pr_geohash.rb, line 56
def neighbors(geohash)
  [[:top, :right], [:right, :bottom], [:bottom, :left], [:left, :top]].map{ |dirs|
    point = adjacent(geohash, dirs[0])
    [point, adjacent(point, dirs[1])]
  }.flatten
end

Private Instance Methods