beste/latlon-geohash

Gustavo Niemeyer's geocoding system

1.3.0 2024-12-20 21:37 UTC

Requires

• php: ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.0

Requires (Dev)

• phpstan/extension-installer: ^1.3.1
• phpstan/phpstan: ^2.0.4
• phpstan/phpstan-phpunit: ^2.0.3
• phpstan/phpstan-strict-rules: ^2.0.1
• phpunit/phpunit: ^10.4.2

MIT

• Jérôme Gamez

• geocoding
• geohash

README

Library to convert a geohash to/from a latitude/longitude point, and to determine bounds of a geohash cell and find neighbours of a geohash.

This is a PHP implementation based on chrisveness/latlon-geohash. More information (with interactive conversion) at www.movable-type.co.uk/scripts/geohash.html.

Usage

use Beste\Geohash;

// encode latitude/longitude point to geohash of given precision (number of
// characters in resulting geohash); if precision is not specified, it is
// inferred from precision of latitude/longitude values.
Geohash::encode(float $lat, float $lon, ?int $precision = null)

// return { lat, lon } of centre of given geohash, to appropriate precision.
Geohash::decode(string $geohash)

// return { sw, ne } bounds of given geohash.
Geohash::bounds(string $geohash)

// return adjacent cell to given geohash in specified direction (n/s/e/w).
Geohash::adjacent(string $geohash, string $direction)

// return all 8 adjacent cells (n/ne/e/se/s/sw/w/nw) to given geohash.
Geohash::neighbours(string $geohash)

Installation

composer require beste/latlon-geohash

Running tests

composer test