Go geohash library offering encoding and decoding for string and integer geohashes.
Fetch the package with
go get github.com/mmcloughlin/geohash
And import it into your programs with
import "github.com/mmcloughlin/geohash"func ConvertIntToString(hash uint64, chars uint) stringConvertIntToString converts an integer geohash to the equivalent string geohash with chars characters. The provided integer geohash is interpreted to have 5*chars bits of precision.
func ConvertStringToInt(hash string) (uint64, uint)ConvertStringToInt converts a string geohash to the equivalent integer geohash. Returns the integer hash and its precision.
func Decode(hash string) (lat, lng float64)Decode the string geohash to a (lat, lng) point.
func DecodeCenter(hash string) (lat, lng float64)DecodeCenter decodes the string geohash to the central point of the bounding box.
func DecodeInt(hash uint64) (lat, lng float64)DecodeInt decodes the provided 64-bit integer geohash to a (lat, lng) point.
func DecodeIntWithPrecision(hash uint64, bits uint) (lat, lng float64)DecodeIntWithPrecision decodes the provided integer geohash with bits of precision to a (lat, lng) point.
func Encode(lat, lng float64) stringEncode the point (lat, lng) as a string geohash with the standard 12 characters of precision.
func EncodeInt(lat, lng float64) uint64EncodeInt encodes the point (lat, lng) to a 64-bit integer geohash.
func EncodeIntWithPrecision(lat, lng float64, bits uint) uint64EncodeIntWithPrecision encodes the point (lat, lng) to an integer with the specified number of bits.
func EncodeWithPrecision(lat, lng float64, chars uint) stringEncodeWithPrecision encodes the point (lat, lng) as a string geohash with the specified number of characters of precision (max 12).
func Neighbor(hash string, direction Direction) stringNeighbor returns a geohash string that corresponds to the provided geohash's neighbor in the provided direction
func NeighborInt(hash uint64, direction Direction) uint64NeighborInt returns a uint64 that corresponds to the provided hash's neighbor in the provided direction at 64-bit precision.
func NeighborIntWithPrecision(hash uint64, bits uint, direction Direction) uint64NeighborIntWithPrecision returns a uint64s that corresponds to the provided hash's neighbor in the provided direction at the given precision.
func Neighbors(hash string) []stringNeighbors returns a slice of geohash strings that correspond to the provided geohash's neighbors.
func NeighborsInt(hash uint64) []uint64NeighborsInt returns a slice of uint64s that correspond to the provided hash's neighbors at 64-bit precision.
func NeighborsIntWithPrecision(hash uint64, bits uint) []uint64NeighborsIntWithPrecision returns a slice of uint64s that correspond to the provided hash's neighbors at the given precision.
func Validate(hash string) errorValidate the string geohash.
type Box struct {
MinLat float64
MaxLat float64
MinLng float64
MaxLng float64
}Box represents a rectangle in latitude/longitude space.
func BoundingBox(hash string) BoxBoundingBox returns the region encoded by the given string geohash.
func BoundingBoxInt(hash uint64) BoxBoundingBoxInt returns the region encoded by the given 64-bit integer geohash.
func BoundingBoxIntWithPrecision(hash uint64, bits uint) BoxBoundingBoxIntWithPrecision returns the region encoded by the integer geohash with the specified precision.
func (b Box) Center() (lat, lng float64)Center returns the center of the box.
func (b Box) Contains(lat, lng float64) boolContains decides whether (lat, lng) is contained in the box. The containment test is inclusive of the edges and corners.
func (b Box) Round() (lat, lng float64)Round returns a point inside the box, making an effort to round to minimal precision.
type Direction intDirection represents directions in the latitute/longitude space.
const (
North Direction = iota
NorthEast
East
SouthEast
South
SouthWest
West
NorthWest
)Cardinal and intercardinal directions