geohash

The core part of the Geohash algorithm and the first initiative to similar solution was documented in a report of G.M. Morton in 1966, "A Computer Oriented Geodetic Data Base and a New Technique in File Sequencing". The Morton work was used for efficient implementations of Z-order curve, like in [https://github.com/yinqiwen/geohash-int this modern (2014) Geohash-integer version] (based on directly interleaving 64-bit integers), but his geocode proposal was not human-readable and was not popular.

Apparently, in the late 2000s, G. Niemeyer still didn't know about Morton's work, and reinvented it, adding the use of base32 representation. In February 2008, together with the announcement of the system, he launched the website http://geohash.org, which allows users to convert geographic coordinates to short URLs which uniquely identify positions on the Earth, so that referencing them in emails, forums, and websites is more convenient.

Many variations have been developed, including OpenStreetMap's short link

The OpenStreetMap's short link, [https://wiki.openstreetmap.org/wiki/Shortlink documented in wiki.openstreetmap.org], was released [https://github.com/openstreetmap/openstreetmap-website/blob/1d8e66016c4cdf465d06198cfbbfe76613ed3bfc/lib/short_link.rb in 2009], is near the same source-code [https://github.com/openstreetmap/openstreetmap-website/blob/master/lib/short_link.rb 10 years after]. It is strongly based on Morton's interlace algorithm.

(using base64 instead of base32) in 2009, the 64-bit Geohash

The "Geohash binary 64 bits" have classic solutions, as [https://github.com/yinqiwen/geohash-int yinqiwen/geohash-int], and optimized solutions, as [https://mmcloughlin.com/posts/geohash-assembly mmcloughlin/geohash-assembly].

in 2014, the exotic Hilbert-Geohash{{cite thesis |last1=Vukovic |first1=Tibor |title=Hilbert-Geohash - Hashing Geographical Point Data Using the Hilbert Space-Filling Curve |journal=70 |date=2016 |hdl=11250/2404058 |hdl-access=free }} in 2016, and others.

To obtain the Geohash, the user provides an address to be geocoded, or latitude and longitude coordinates, in a single input box (most commonly used formats for latitude and longitude pairs are accepted), and performs the request.

Besides showing the latitude and longitude corresponding to the given Geohash, users who navigate to a Geohash at geohash.org are also presented with an embedded map, and may download a GPX file, or transfer the waypoint directly to certain GPS receivers. Links are also provided to external sites that may provide further details around the specified

location.

For example, the coordinate pair 57.64911,10.40744 (near the tip of the peninsula of Jutland, Denmark) produces a slightly shorter hash of u4pruydqqvj.

The main usages of Geohashes are:

• As a unique identifier.
• To represent point data, e.g. in databases.

Geohashes have also been proposed to be used for geotagging.

When used in a database, the structure of geohashed data has two advantages. First, data indexed by geohash will have all points for a given rectangular area in contiguous slices (the number of slices depends on the precision required and the presence of geohash "fault lines"). This is especially useful in database systems where queries on a single index are much easier or faster than multiple-index queries. Second, this index structure can be used for a quick-and-dirty proximity search: the closest points are often among the closest geohashes.

A formal description for Computational and Mathematical views.

For exact latitude and longitude translations Geohash is a spatial index of base 4, because it transforms the continuous latitude and longitude space coordinates into a hierarchical discrete grid, using a recurrent four-partition of the space. To be a compact code it uses base 32 and represents its values by the following alphabet, that is the "standard textual representation".

The "Geohash alphabet" (32ghs) uses all digits 0-9 and all lower case letters except "a", "i", "l" and "o".

For example, using the table above and the constant $B=32$, the Geohash ezs42 can be converted to a decimal representation by ordinary positional notation:

: [ezs42]_32ghs = $[(e\; \backslash times\; B^4)\; +\; (z\; \backslash times\; B^3)\; +\; (s\; \backslash times\; B^2)\; +\; (4\; \backslash times\; B^1)\; +\; (2\; \backslash times\; B^0)]\_\{32ghs\}$

: = $[e]\_\{32ghs\}\; \backslash times\; B^4\; +\; [z]\_\{32ghs\}\; \backslash times\; B^3\; +\; [s]\_\{32ghs\}\; \backslash times\; B^2\; +\; [4]\_\{32ghs\}\; \backslash times\; B^1\; +\; [2]\_\{32ghs\}\; \backslash times\; B^0$

: = $[13]\_\{10\}\; \backslash times\; B^4\; +\; [31]\_\{10\}\; \backslash times\; B^3\; +\; [24]\_\{10\}\; \backslash times\; B^2\; +\; [4]\_\{10\}\; \backslash times\; B^1\; +\; [2]\_\{10\}\; \backslash times\; B^0$

: = $13\; \backslash times\; 1048576\; +\; 31\; \backslash times\; 32768\; +\; 24\; \backslash times\; 1024\; +\; 4\; \backslash times\; 32\; +\; 2\; \backslash times\; 1$ = $13631488\; +\; 1015808\; +\; 24576\; +\; 128\; +\; 2\; =\; 14672002$

The geometry of the Geohash has a mixed spatial representation:

• Geohashes with 2, 4, 6, ... e digits (even digits) are represented by Z-order curve in a "regular grid" where decoded pair (latitude, longitude) has uniform uncertainty, valid as Geo URI.
• Geohashes with 1, 3, 5, ... d digits (odd digits) are represented by "И-order curve". Latitude and longitude of the decoded pair has different uncertainty (longitude is truncated).

File:Geohash-OddEvenDigits.png

File:MortonCurve64grid-mergingCells.png

It is possible to build the "И-order curve" from the Z-order curve by merging neighboring cells and indexing the resulting rectangular grid by the function $j\; =\; \backslash left\backslash lfloor\backslash frac\{i\}\{2\}\backslash right\backslash rfloor$. The illustration shows how to obtain the grid of 32 rectangular cells from the grid of 64 square cells.

The most important property of Geohash for humans is that it preserves spatial hierarchy in the code prefixes.
For example, in the "1 Geohash digit grid" illustration of 32 rectangles, above, the spatial region of the code e (rectangle of greyish blue circle at position 4,3) is preserved with prefix e in the "2 digit grid" of 1024 rectangles (scale showing em and greyish green to blue circles at grid).

Using the hash ezs42 as an example, here is how it is decoded into a decimal latitude and longitude. The first step is decoding it from textual "base 32ghs", as showed above, to obtain the binary representation:

: $[e]\_\{32ghs\}=[13]\_\{10\}=[01101]\_2$

: $[z]\_\{32ghs\}=[31]\_\{10\}=[11111]\_2$

: $[s]\_\{32ghs\}=[24]\_\{10\}=[11000]\_2$

: $[4]\_\{32ghs\}=[4]\_\{10\}=[00100]\_2$

: $[2]\_\{32ghs\}=[2]\_\{10\}=[00010]\_2$.

This operation results in the bits 01101 11111 11000 00100 00010. Starting to count from the left side with the digit 0 in the first position, the digits in the even positions form the longitude code (0111110000000), while the digits in the odd positions form the latitude code (101111001001).

Each binary code is then used in a series of divisions, considering one bit at a time, again from the left to the right side. For the latitude value, the interval −90 to +90 is divided by 2, producing two intervals: −90 to 0, and 0 to +90. Since the first bit is 1, the higher interval is chosen, and becomes the current interval. The procedure is repeated for all bits in the code. Finally, the latitude value is the center of the resulting interval. Longitudes are processed in an equivalent way, keeping in mind that the initial interval is −180 to +180.

For example, in the latitude code 101111001001, the first bit is 1, so we know our latitude is somewhere between 0 and 90. Without any more bits, we'd guess the latitude was 45, giving us an error of ±45. Since more bits are available, we can continue with the next bit, and each subsequent bit halves this error. This table shows the effect of each bit. At each stage, the relevant half of the range is highlighted in green; a low bit selects the lower range, a high bit selects the upper range.

The column "mean value" shows the latitude, simply the mean value of the range. Each subsequent bit makes this value more precise.

(The numbers in the above table have been rounded to 3 decimal places for clarity)

Final rounding should be done carefully in a way that

:$\backslash min\; \backslash le\; \backslash mathrm\{round\}(value)\; \backslash le\; \backslash max$

So while rounding 42.605 to 42.61 or 42.6 is correct, rounding to 43 is not.

Geohashes can be used to find points in proximity to each other based on a common prefix. However, edge case locations close to each other but on opposite sides of the 180 degree meridian will result in Geohash codes with no common prefix (different longitudes for near physical locations). Points close to the North and South poles will have very different geohashes (different longitudes for near physical locations).

Two close locations on either side of the Equator (or Greenwich meridian) will not have a long common prefix since they belong to different 'halves' of the world. Put simply, one location's binary latitude (or longitude) will be 011111... and the other 100000...., so they will not have a common prefix and most bits will be flipped. This can also be seen as a consequence of relying on the Z-order curve (which could more appropriately be called an N-order visit in this case) for ordering the points, as two points close by might be visited at very different times. However, two points with a long common prefix will be close by.

In order to do a proximity search, one could compute the southwest corner (low geohash with low latitude and longitude) and northeast corner (high geohash with high latitude and longitude) of a bounding box and search for geohashes between those two. This search will retrieve all points in the z-order curve between the two corners, which can be far too many points. This method also breaks down at the 180 meridians and the poles. Solr uses a filter list of prefixes, by computing the prefixes of the nearest squares close to the geohash [https://web.archive.org/web/20140513235817/http://lucenerevolution.org/sites/default/files/Lucene%20Rev%20Preso%20Smiley%20Spatial%20Search.pdf].

Since a geohash (in this implementation) is based on coordinates of longitude and latitude the distance between two geohashes reflects the distance in latitude/longitude coordinates between two points, which does not translate to actual distance, see Haversine formula.

Example of non-linearity for latitude-longitude system:

• At the Equator (0 Degrees) the length of a degree of longitude is 111.320 km, while a degree of latitude measures 110.574 km, an error of 0.67%.
• At 30 Degrees (Mid Latitudes) the error is 110.852/96.486 = 14.89%
• At 60 Degrees (High Arctic) the error is 111.412/55.800 = 99.67%, reaching infinity at the poles.

Note that these limitations are not due to geohashing, and not due to latitude-longitude coordinates, but due to the difficulty of mapping coordinates on a sphere (non linear and with wrapping of values, similar to modulo arithmetic) to two dimensional coordinates and the difficulty of exploring a two dimensional space uniformly. The first is related to Geographical coordinate system and Map projection, and the other to Hilbert curve and z-order curve. Once a coordinate system is found that represents points linearly in distance and wraps up at the edges, and can be explored uniformly, applying geohashing to those coordinates will not suffer from the limitations above.

While it is possible to apply geohashing to an area with a Cartesian coordinate system, it would then only apply to the area where the coordinate system applies.

Despite those issues, there are possible workarounds, and the algorithm has been successfully used in Elasticsearch,[https://www.elastic.co/guide/en/elasticsearch/reference/current/geo-shape.html geo_shape Datatype in Elasticsearch] MongoDB,[http://www.mongodb.org/display/DOCS/Geospatial+Indexing Geospatial Indexing in MongoDB] HBase, Redis,[https://redis.io/commands/geohash Redis-commands Guide] and Accumulo[https://geomesa.github.io/assets/outreach/SpatioTemporalIndexing_IEEEcopyright.pdf Spatio-temporal Indexing in Non-relational Distributed Databases] to implement proximity searches.

{{main|Geocodes}}

File:Comparing-Geoash-Hilbert.png the Hilbert curve is the best alternative for Morton curve, used for example in the S2-geometry.
Codes with even number of digits (2, 4, ...) are mapped to regular grids, but codes of odd number (1, 3, ...) must be mapped to an irregular intermediary grid, with cells [https://mathoverflow.net/q/357117/153024 indexed by degenerated curves].]]

An alternative to storing Geohashes as strings in a database are [http://www.cs.umd.edu/~hjs/pubs/SametVisualComputer89.pdf Locational codes], which are also called spatial keys and similar to QuadTiles.[http://karussell.wordpress.com/2012/05/23/spatial-keys-memory-efficient-geohashes/ Spatial Keys][https://wiki.openstreetmap.org/wiki/QuadTiles QuadTiles]

In some geographical information systems and Big Data spatial databases, a Hilbert curve based indexation can be used as an alternative to Z-order curve, like in the S2 Geometry library."S2 Geometry Library" for optimized spatial indexation, https://s2geometry.io {{Webarchive|url=https://web.archive.org/web/20231211175507/https://s2geometry.io/ |date=2023-12-11 }}

In 2019 a front-end was designed by QA Locate{{Cite web|last=|first=|date=|title=QA Locate {{!}} The Power of Precision Location Intelligence|url=https://www.qalocate.com/|archive-url=|archive-date=|access-date=2020-06-10|website=QA Locate|language=en-US}} in what they called GeohashPhrase{{Cite web|date=2019-09-17|title=GeohashPhrase|url=https://www.qalocate.com/solutions/geohashphrase/|access-date=2020-06-10|website=QA Locate|language=en-US}} to use phrases to code Geohashes for easier communication via spoken English language. There were plans to make GeohashPhrase open source.{{Cite web|last=thelittlenag|date=2019-11-11|title=At QA Locate we've been working on a solution that we call GeohashPhrase {{!}} Hacker News|url=https://news.ycombinator.com/item?id=21219374|archive-url=|archive-date=|access-date=2020-06-10|website=news.ycombinator.com}}

{{div col}}

• C-squares (2002)
• FixPhrase
• GeoKey (2018, proprietary)
• Ghana Post GPS (2017)
• International Postcode system using Cubic Meters (CubicPostcode.com)
• Maidenhead Locator System (1980)
• Makaney Code (2011)
• MapCode (2008)
• Military Grid Reference System
• Natural Area Code
• Open Location Code (2014, aka. "plus codes", Google Maps)
• QRA locator (1959)
• Universal Transverse Mercator coordinate system
• verbal-id
• what3words (2013, proprietary)
• WhatFreeWords
• wherewords.id
• wolo.codes
• GEOREF (similar 2-digit hierarchy code)
• Xaddress
• 3Geonames (2018, open source)

{{div col end}}

The Geohash algorithm was put in the public domain by its inventor in a public announcement on February 26, 2008.[http://forums.groundspeak.com/GC/index.php?showtopic=186412 geohash.org announcement post in groundspeak.com forum. See also Wayback of 2018 at https://web.archive.org/web/20180309054335/https://forums.geocaching.com/GC/index.php?/topic/186412-geohashorg/ web.archive.org/web/20180309054335]

While comparable algorithms have been successfully patented[http://www.freepatentsonline.com/20050023524.html Compact text encoding of latitude/longitude coordinates - Patent 20050023524] and

had copyright claimed upon,[http://www.gps-practice-and-fun.com/nacgeo.html#Microsoft Does Microsoft Infringe the Natural Area Coding System?] {{webarchive|url=https://web.archive.org/web/20101228091709/http://www.gps-practice-and-fun.com/nacgeo.html |date=2010-12-28 }}{{Cite web |url=http://www.nacgeo.com/nacsite/licensing/ |title=The Natural Area Coding System - Legal and Licensing |access-date=2008-02-26 |archive-date=2019-05-23 |archive-url=https://web.archive.org/web/20190523074747/http://www.nacgeo.com/nacsite/licensing/ |url-status=dead }} GeoHash is based on an entirely different algorithm and approach.

Geohash is standardized as CTA-5009.{{Cite web |title=Fast and Readable Geographical Hashing (CTA-5009) |url=https://shop.cta.tech/products/fast-and-readable-geographical-hashing-cta-5009 |access-date=2024-03-04 |website=Consumer Technology Association® |language=en}}  This standard follows the Wikipedia article as of the 2023 version but provides additional detail in a formal (normative) reference. In the absence of an official specification since the creation of Geohash, the CTA WAVE organization published CTA-5009 to aid in broader adoption and compatibility across implementers in the industry.

• List of geodesic-geocoding systems
• Geohash-36 (is not a Geohash-variant)
• Grid (spatial index)
• Maidenhead Locator System
• Military Grid Reference System
• Morton number (number theory)
• Natural Area Code
• Numbering scheme
• Open Location Code (plus code)
• space-filling curves
• what3words
• Z-order curve

{{reflist|30em}}

• {{official website|http://geohash.org/}}
• [https://github.com/adrianulbona/jts-discretizer Geohash approximations for JTS geometries]
• [https://geohash.measurement.earth/ The Geohash Playground]

{{geocoding-systems}}

Category:Geographic coordinate systems

Category:Geocodes

Category:2008 introductions