PHPackages                             wimski/nominatim-geocoding-api-client - 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. [API Development](/categories/api)
4. /
5. wimski/nominatim-geocoding-api-client

ActiveLibrary[API Development](/categories/api)

wimski/nominatim-geocoding-api-client
=====================================

Nominatim Geocoding API Client

v1.2.0(4y ago)03.8k1MITPHPPHP ^8.0

Since Feb 21Pushed 4y ago1 watchersCompare

[ Source](https://github.com/wimski/nominatim-geocoding-api-client)[ Packagist](https://packagist.org/packages/wimski/nominatim-geocoding-api-client)[ Docs](https://github.com/wimski/nominatim-geocoding-api-client)[ RSS](/packages/wimski-nominatim-geocoding-api-client/feed)WikiDiscussions master Synced today

READMEChangelog (4)Dependencies (11)Versions (5)Used By (1)

[![Latest Stable Version](https://camo.githubusercontent.com/f5fbd4ac02970a20578f7484a988c90ca542dfcac1e8851a15f5df0dad34c5cd/687474703a2f2f706f7365722e707567782e6f72672f77696d736b692f6e6f6d696e6174696d2d67656f636f64696e672d6170692d636c69656e742f76)](https://packagist.org/packages/wimski/nominatim-geocoding-api-client)[![Coverage Status](https://camo.githubusercontent.com/a1adeb8b05e791c4508e4073b57280c6989f4e5fe0263ccb2f8fe086a18df8bd/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f77696d736b692f6e6f6d696e6174696d2d67656f636f64696e672d6170692d636c69656e742f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/wimski/nominatim-geocoding-api-client?branch=master)[![PHPUnit](https://github.com/wimski/nominatim-geocoding-api-client/actions/workflows/phpunit.yml/badge.svg)](https://github.com/wimski/nominatim-geocoding-api-client/actions/workflows/phpunit.yml)[![PHPStan](https://github.com/wimski/nominatim-geocoding-api-client/actions/workflows/phpstan.yml/badge.svg)](https://github.com/wimski/nominatim-geocoding-api-client/actions/workflows/phpstan.yml)

Nominatim Geocoding API Client
==============================

[](#nominatim-geocoding-api-client)

Changelog
---------

[](#changelog)

[View the changelog.](./CHANGELOG.md)

Usage
-----

[](#usage)

### Install package

[](#install-package)

```
composer require wimski/nominatim-geocoding-api-client
```

### Example

[](#example)

```
use Wimski\Nominatim\Client;
use Wimski\Nominatim\Config\NominatimConfig;
use Wimski\Nominatim\GeocoderServices\NominatimGeocoderService;
use Wimski\Nominatim\RequestParameters\ForwardGeocodingQueryRequestParameters;
use Wimski\Nominatim\Transformers\GeocodingResponseTransformer;

$config = new NominatimConfig(
    'my-custom-user-agent',
    'email@provider.net',
);

$service = new NominatimGeocoderService(
    new Client(),
    new GeocodingResponseTransformer(),
    $config,
);

$requestParameters = ForwardGeocodingQueryRequestParameters::make('some query')
    ->addCountryCode('nl')
    ->includeAddressDetails();

$response = $service->requestForwardGeocoding($requestParameters);

// Get data from the response
$latitude = $response->getItems()[0]->getCoordinate()->getLatitude();
```

### PSR HTTP

[](#psr-http)

The `Client` class uses [Discovery](https://docs.php-http.org/en/latest/discovery.html) by default to get instances of the following contracts:

- `Psr\Http\Client\ClientInterface`
- `Psr\Http\Message\RequestFactoryInterface`
- `Psr\Http\Message\UriFactoryInterface`

This means that you need to include (a) PSR compatible package(s) [in your project](https://docs.php-http.org/en/latest/httplug/users.html).

If you already have setup a specific HTTP client configuration in your project, which you would also like to use for Nominatim requests, you can pass that as a constructor argument to the `Client`:

```
$service = new NominatimGeocoderService(
    new Client($myCustomPsrHttpClient),
    new GeocodingResponseTransformer(),
    new NominatimConfig('user-agent', 'email@provider.net'),
);
```

### Services

[](#services)

Services for the following providers are currently available:

- [Nominatim](https://nominatim.org/release-docs/latest/api/Overview/)
- [LocationIQ](https://locationiq.com/docs)
- Generic: without any implementation specific headers or parameters.

Custom services can easily be created by extending the `AbstractGeocoderService`as long as the provider implements the Nominatim spec correctly.

PHPUnit
-------

[](#phpunit)

```
composer run phpunit
```

PHPStan
-------

[](#phpstan)

```
composer run phpstan
```

Credits
-------

[](#credits)

- [wimski](https://github.com/wimski)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity58

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.

###  Release Activity

Cadence

Every ~9 days

Total

4

Last Release

1566d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/12373573?v=4)[Wim Reckman](/maintainers/wimski)[@wimski](https://github.com/wimski)

---

Top Contributors

[![wimski](https://avatars.githubusercontent.com/u/12373573?v=4)](https://github.com/wimski "wimski (33 commits)")

---

Tags

apiclientgeocodingnominatimapiclientgeocodingnominatimreversewimskiforward

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/wimski-nominatim-geocoding-api-client/health.svg)

```
[![Health](https://phpackages.com/badges/wimski-nominatim-geocoding-api-client/health.svg)](https://phpackages.com/packages/wimski-nominatim-geocoding-api-client)
```

###  Alternatives

[telnyx/telnyx-php

Official Telnyx PHP SDK — APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network.

35789.4k2](/packages/telnyx-telnyx-php)[openai-php/client

OpenAI PHP is a supercharged PHP API client that allows you to interact with the Open AI API

5.8k28.0M318](/packages/openai-php-client)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

85036.3k](/packages/flow-php-flow)[getbrevo/brevo-php

Official Brevo provided RESTFul API V3 php library

1003.9M50](/packages/getbrevo-brevo-php)[mollie/mollie-api-php

Mollie API client library for PHP. Mollie is a European Payment Service provider and offers international payment methods such as Mastercard, VISA, American Express and PayPal, and local payment methods such as iDEAL, Bancontact, SOFORT Banking, SEPA direct debit, Belfius Direct Net, KBC Payment Button and various gift cards such as Podiumcadeaukaart and fashioncheque.

60216.0M85](/packages/mollie-mollie-api-php)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)

PHPackages © 2026

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