PHPackages                             lightools/geocoding - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. lightools/geocoding

AbandonedLibrary[Utility & Helpers](/categories/utility)

lightools/geocoding
===================

Address geocoding with exact results only - may be used for address validation.

06.8kPHP

Since Feb 5Pushed 9y ago1 watchersCompare

[ Source](https://github.com/lightools/geocoding)[ Packagist](https://packagist.org/packages/lightools/geocoding)[ RSS](/packages/lightools-geocoding/feed)WikiDiscussions master Synced 2w ago

READMEChangelogDependenciesVersions (1)Used By (0)

Introduction
------------

[](#introduction)

Simple address geocoding with exact results only - may be used for full address validation. For example address `Revoluční 11, Praha` will be found, but `Revoluční, Praha` will be not.

Installation
------------

[](#installation)

```
$ composer require lightools/geocoding
```

Simple Usage
------------

[](#simple-usage)

```
try {
    $httpClient = new Bitbang\Http\Clients\CurlClient();
    $geocoder = new Lightools\Geocoding\GoogleGeocoder($httpClient);
    $geocoded = $geocoder->geocode('Revoluční 11, Praha');

    echo $geocoded->getLatitude();
    echo $geocoded->getLongitude();
    echo $geocoded->getPostalCode();

} catch (Lightools\Geocoding\GeocodingFailedException $e) {
    // e.g. HTTP request failed
} catch (Lightools\Geocoding\NoExactResultException $e) {
    // invalid or inaccurate address
} catch (Lightools\Geocoding\QuotaLimitException $e) {
    // rate limit exceeded
}
```

### Chaining, caching, configuring

[](#chaining-caching-configuring)

This library is shipped with simple caching geocoder and chain geocoder. You can configure chain geocoder which exceptions will cause skipping to next geocoder by second parameter in constructor. If you want to create your own, just implement interface `IGeocoder`.

For Google geocoder, you can configure any query parameters you want, just call `setParameters` and setup for example language or components. Smartform geocoder has the same method, but there not too much to configure - only target countries.

```
$httpClient = new Bitbang\Http\Clients\CurlClient();

$googleGeocoder = new Lightools\Geocoding\GoogleGeocoder($httpClient);
$googleGeocoder->setParameters(['components' => 'country:CZ']);

$smartformGeocoder = new Lightools\Geocoding\SmartformGeocoder('password', $httpClient);
$smartformGeocoder->setParameters(['countries' => ['CZ']]);

$chainGeocoder = new Lightools\Geocoding\ChainGeocoder([$smartformGeocoder, $googleGeocoder]);
$cachedGeocoder = new Lightools\Geocoding\CachedGeocoder($chainGeocoder, __DIR__ . '/cache/geocoding');

$cachedGeocoder->geocode('Václavské náměstí 837/11, Praha');
```

How to run tests
----------------

[](#how-to-run-tests)

```
$ vendor/bin/tester tests
```

###  Health Score

24

—

LowBetter than 31% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/5b545e3f9d982d538f11bc42b3dc2d186f706cef92c8bc8bc8f8788b08186ea5?d=identicon)[janedbal](/maintainers/janedbal)

---

Top Contributors

[![janedbal](https://avatars.githubusercontent.com/u/1993453?v=4)](https://github.com/janedbal "janedbal (5 commits)")

---

Tags

address-validationgeocoding

### Embed Badge

![Health badge](/badges/lightools-geocoding/health.svg)

```
[![Health](https://phpackages.com/badges/lightools-geocoding/health.svg)](https://phpackages.com/packages/lightools-geocoding)
```

###  Alternatives

[ctidigital/magento2-configurator

Keep magento persistently configured using files

174342.9k](/packages/ctidigital-magento2-configurator)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)