library geohash

saikiran/geohash

Geohash Algorithm to encode geographic coordinates to a string of letters and digits

Geohash

Geohash is a php module that provides below functions. * Encoding geographic location into short string of letters and digits. * Decoding string of letters and digits to latitude and longitude. * Identifying the neighbouring geohashes of a provided geohash., _(*1)

Installation

The easiest way to install PHP Geohash is with composer. Find it on Packagist., _(*2)

$ composer require saikiran/geohash

Usage

Encode co-ordinates, _(*3)

use Sk\Geohash\Geohash;

$g = new Geohash();
echo $g->encode(17.38000000, 78.42000000, 5);

The result is, _(*4)

tepfb

Decode geohash into geographical coordinates, _(*5)

use Sk\Geohash\Geohash;

$g = new Geohash();
$coordinates = $g->decode("tepfb", 5);
echo "latitude : " . $coordinates[0] . ",  longitude : " . $coordinates[1];

The result is, _(*6)

latitude : 17.38,  longitude : 78.42

Get geohashes of 8 neighbors of a geohash, _(*7)

use Sk\Geohash\Geohash;

$g = new Geohash();
$hash = $g->encode(25.813646, -80.133761, 7);
$neighbors = $g->getNeighbors($hash);
echo "Hash: $hash\n";
echo "Neighbors: " . json_encode($neighbors) . "\n";

The result is, _(*8)

Hash: 
Neighbors: {"North":"dhx4be2","East":"dhx4be1","South":"dhx4bdb","West":"dhx4b7p","NorthEast":"dhx4be3","SouthEast":"dhx4bdc","SouthWest":"dhx4b6z","NorthWest":"dhx4b7r"}

Running the unit tests

Go to this directory from your project folder, _(*9)

$ cd vendor/saikiran/geohash

Then run these two commands, _(*10)

$ composer install
$ vendor/bin/phpunit tests

See these resources online:

• http://geohash.org
• http://en.wikipedia.org/wiki/Geohash