Functions for Working with Geohash

Geohash

Geohash is the geocode system, which subdivides Earth’s surface into buckets of grid shape and encodes each cell into a short string of letters and digits. It is a hierarchical data structure, so the longer the geohash string is, the more precise the geographic location will be.

If you need to manually convert geographic coordinates to geohash strings, you can use geohash.org

geohashEncode

Encodes latitude and longitude as a geohash-string.

Syntax

geohashEncode(longitude, latitude, [precision])

Input values

• longitude — Longitude part of the coordinate you want to encode. Floating in range[-180°, 180°]. Float.
• latitude — Latitude part of the coordinate you want to encode. Floating in range [-90°, 90°]. Float.
• precision (optional) — Length of the resulting encoded string. Defaults to 12. Integer in the range [1, 12]. Int8.

Returned values

• Alphanumeric string of the encoded coordinate (modified version of the base32-encoding alphabet is used). String.

Example

SELECT geohashEncode(-5.60302734375, 42.593994140625, 0) AS res;

┌─res──────────┐
│ ezs42d000000 │
└──────────────┘

geohashDecode

Decodes any geohash-encoded string into longitude and latitude.

Syntax

geohashDecode(hash_str)

Input values

• hash_str — Geohash-encoded string.

Returned values

• Tuple (longitude, latitude) of Float64 values of longitude and latitude. Tuple(Float64)

Example

SELECT geohashDecode('ezs42') AS res;

┌─res─────────────────────────────┐
│ (-5.60302734375,42.60498046875) │
└─────────────────────────────────┘

geohashesInBox

Returns an array of geohash-encoded strings of given precision that fall inside and intersect boundaries of given box, basically a 2D grid flattened into array.

Syntax

geohashesInBox(longitude_min, latitude_min, longitude_max, latitude_max, precision)

Arguments

• longitude_min — Minimum longitude. Range: [-180°, 180°]. Float.
• latitude_min — Minimum latitude. Range: [-90°, 90°]. Float.
• longitude_max — Maximum longitude. Range: [-180°, 180°]. Float.
• latitude_max — Maximum latitude. Range: [-90°, 90°]. Float.
• precision — Geohash precision. Range: [1, 12]. UInt8.

Returned values

• Array of precision-long strings of geohash-boxes covering provided area, you should not rely on order of items. Array(String).
• [] - Empty array if minimum latitude and longitude values aren’t less than corresponding maximum values.

Example

SELECT geohashesInBox(24.48, 40.56, 24.785, 40.81, 4) AS thasos;

┌─thasos──────────────────────────────────────┐
│ ['sx1q','sx1r','sx32','sx1w','sx1x','sx38'] │
└─────────────────────────────────────────────┘