> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Documentation for Geohash

# Functions for Working with Geohash

<h2 id="geohash">
  Geohash
</h2>

[Geohash](https://en.wikipedia.org/wiki/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](http://geohash.co/)

<h2 id="geohashencode">
  geohashEncode
</h2>

Encodes latitude and longitude as a [geohash](#geohash)-string.

**Syntax**

```sql theme={null}
geohashEncode(longitude, latitude, [precision])
```

**Input values**

* `longitude` — Longitude part of the coordinate you want to encode. Floating in range`[-180°, 180°]`. [Float](/reference/data-types/float).
* `latitude` — Latitude part of the coordinate you want to encode. Floating in range `[-90°, 90°]`. [Float](/reference/data-types/float).
* `precision` (optional) — Length of the resulting encoded string. Defaults to `12`. Integer in the range `[1, 12]`. [Int8](/reference/data-types/int-uint).

<Note>
  - All coordinate parameters must be of the same type: either `Float32` or `Float64`.
  - For the `precision` parameter, any value less than `1` or greater than `12` is silently converted to `12`.
</Note>

**Returned values**

* Alphanumeric string of the encoded coordinate (modified version of the base32-encoding alphabet is used). [String](/reference/data-types/string).

**Example**

```sql title="Query" theme={null}
SELECT geohashEncode(-5.60302734375, 42.593994140625, 0) AS res;
```

```text title="Response" theme={null}
┌─res──────────┐
│ ezs42d000000 │
└──────────────┘
```

<h2 id="geohashdecode">
  geohashDecode
</h2>

Decodes any [geohash](#geohash)-encoded string into longitude and latitude.

**Syntax**

```sql theme={null}
geohashDecode(hash_str)
```

**Input values**

* `hash_str` — Geohash-encoded string.

**Returned values**

* Tuple `(longitude, latitude)` of `Float64` values of longitude and latitude. [Tuple](/reference/data-types/tuple)([Float64](/reference/data-types/float))

**Example**

```sql theme={null}
SELECT geohashDecode('ezs42') AS res;
```

```text theme={null}
┌─res─────────────────────────────┐
│ (-5.60302734375,42.60498046875) │
└─────────────────────────────────┘
```

<h2 id="geohashesinbox">
  geohashesInBox
</h2>

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

**Syntax**

```sql theme={null}
geohashesInBox(longitude_min, latitude_min, longitude_max, latitude_max, precision)
```

**Arguments**

* `longitude_min` — Minimum longitude. Range: `[-180°, 180°]`. [Float](/reference/data-types/float).
* `latitude_min` — Minimum latitude. Range: `[-90°, 90°]`. [Float](/reference/data-types/float).
* `longitude_max` — Maximum longitude. Range: `[-180°, 180°]`. [Float](/reference/data-types/float).
* `latitude_max` — Maximum latitude. Range: `[-90°, 90°]`. [Float](/reference/data-types/float).
* `precision` — Geohash precision. Range: `[1, 12]`. [UInt8](/reference/data-types/int-uint).

<Note>
  All coordinate parameters must be of the same type: either `Float32` or `Float64`.
</Note>

**Returned values**

* Array of precision-long strings of geohash-boxes covering provided area, you should not rely on order of items. [Array](/reference/data-types/array)([String](/reference/data-types/string)).
* `[]` - Empty array if minimum latitude and longitude values aren't less than corresponding maximum values.

<Note>
  Function throws an exception if resulting array is over 10'000'000 items long.
</Note>

**Example**

```sql title="Query" theme={null}
SELECT geohashesInBox(24.48, 40.56, 24.785, 40.81, 4) AS thasos;
```

```text title="Response" theme={null}
┌─thasos──────────────────────────────────────┐
│ ['sx1q','sx1r','sx32','sx1w','sx1x','sx38'] │
└─────────────────────────────────────────────┘
```