PHPackages                             geocoder-php/nominatim-provider - 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. geocoder-php/nominatim-provider

ActiveLibrary[API Development](/categories/api)

geocoder-php/nominatim-provider
===============================

Geocoder Nominatim adapter

5.8.0(1y ago)354.4M↓11.1%820MITPHPPHP ^8.0CI failing

Since Jul 1Pushed 5mo ago3 watchersCompare

[ Source](https://github.com/geocoder-php/nominatim-provider)[ Packagist](https://packagist.org/packages/geocoder-php/nominatim-provider)[ Docs](http://geocoder-php.org/Geocoder/)[ RSS](/packages/geocoder-php-nominatim-provider/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (14)Used By (20)

Nominatim Geocoder provider
===========================

[](#nominatim-geocoder-provider)

[![Build Status](https://camo.githubusercontent.com/18f4138ffab28766d27f762f78836aba8c63102f702d08404696a85c681036cd/68747470733a2f2f7472617669732d63692e6f72672f67656f636f6465722d7068702f6e6f6d696e6174696d2d70726f76696465722e7376673f6272616e63683d6d6173746572)](http://travis-ci.org/geocoder-php/nominatim-provider)[![Latest Stable Version](https://camo.githubusercontent.com/65dfe312c97be65834d363d4451ce8c3c4326e60e6a3e0cdcf05d6c4e46aa648/68747470733a2f2f706f7365722e707567782e6f72672f67656f636f6465722d7068702f6e6f6d696e6174696d2d70726f76696465722f762f737461626c65)](https://packagist.org/packages/geocoder-php/nominatim-provider)[![Total Downloads](https://camo.githubusercontent.com/fda1258b555a5001c549df8704c37c866dee49e82af30bb02bc422fadd18fb95/68747470733a2f2f706f7365722e707567782e6f72672f67656f636f6465722d7068702f6e6f6d696e6174696d2d70726f76696465722f646f776e6c6f616473)](https://packagist.org/packages/geocoder-php/nominatim-provider)[![Monthly Downloads](https://camo.githubusercontent.com/a1f85fba13b5d5e133cfd7b2eb425198ef871352c8a6d48ab86a42df9c7f936f/68747470733a2f2f706f7365722e707567782e6f72672f67656f636f6465722d7068702f6e6f6d696e6174696d2d70726f76696465722f642f6d6f6e74686c792e706e67)](https://packagist.org/packages/geocoder-php/nominatim-provider)[![Code Coverage](https://camo.githubusercontent.com/da0a514cc232628090290a60572554503c06cba4e16026c267cf8d7a8edd64a2/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f67656f636f6465722d7068702f6e6f6d696e6174696d2d70726f76696465722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/geocoder-php/nominatim-provider)[![Quality Score](https://camo.githubusercontent.com/bc08f5c804dacb962e76c0b74bb1b0268969ee599146ea77cafbab88f5f3dfa1/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f67656f636f6465722d7068702f6e6f6d696e6174696d2d70726f76696465722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/geocoder-php/nominatim-provider)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)

This is the Nominatim provider from the PHP Geocoder. This is a **READ ONLY** repository. See the [main repo](https://github.com/geocoder-php/Geocoder) for information and documentation.

All usage of the Nominatim provider using `nominatim.openstreetmap.org` must follow the [Nominatim Usage Policy](https://operations.osmfoundation.org/policies/nominatim/) !

Install
-------

[](#install)

```
composer require geocoder-php/nominatim-provider
```

Usage
-----

[](#usage)

If you want to use the "default" Nominatim instance () :

```
$provider = \Geocoder\Provider\Nominatim\Nominatim::withOpenStreetMapServer($httpClient, $userAgent);
```

If you want to specify yourself the server that will be used :

```
$provider = new \Geocoder\Provider\Nominatim($httpClient, 'https://nominatim.openstreetmap.org', $userAgent);
```

Contribute
----------

[](#contribute)

Contributions are very welcome! Send a pull request to the [main repository](https://github.com/geocoder-php/Geocoder) or report any issues you find on the [issue tracker](https://github.com/geocoder-php/Geocoder/issues).

###  Health Score

59

—

FairBetter than 99% of packages

Maintenance59

Moderate activity, may be stable

Popularity55

Moderate usage in the ecosystem

Community34

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~237 days

Recently: every ~348 days

Total

13

Last Release

398d ago

Major Versions

4.1.0 → 5.0.02018-07-08

PHP version history (5 changes)4.0.0PHP ^7.0

5.2.0PHP ^7.2

5.4.0PHP ^7.3 || ^8.0

5.6.0PHP ^7.4 || ^8.0

5.8.0PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/401ccc5eea13c60cf807ae982af00e368e2166e2f26d8eb541dcd881a57385bc?d=identicon)[Nyholm](/maintainers/Nyholm)

![](https://www.gravatar.com/avatar/b434ff5f6f9dcc7095f45c43254299b3cc8f6c83e9a757a80a6b7d229a4c9701?d=identicon)[jbelien](/maintainers/jbelien)

---

Top Contributors

[![Nyholm](https://avatars.githubusercontent.com/u/1275206?v=4)](https://github.com/Nyholm "Nyholm (34 commits)")[![jbelien](https://avatars.githubusercontent.com/u/1150563?v=4)](https://github.com/jbelien "jbelien (32 commits)")[![Chris53897](https://avatars.githubusercontent.com/u/7104259?v=4)](https://github.com/Chris53897 "Chris53897 (6 commits)")[![jief](https://avatars.githubusercontent.com/u/740893?v=4)](https://github.com/jief "jief (1 commits)")[![jkobus](https://avatars.githubusercontent.com/u/1527096?v=4)](https://github.com/jkobus "jkobus (1 commits)")[![mtmail](https://avatars.githubusercontent.com/u/3727288?v=4)](https://github.com/mtmail "mtmail (1 commits)")[![nicolas-grekas](https://avatars.githubusercontent.com/u/243674?v=4)](https://github.com/nicolas-grekas "nicolas-grekas (1 commits)")[![norkunas](https://avatars.githubusercontent.com/u/2722872?v=4)](https://github.com/norkunas "norkunas (1 commits)")[![pschocke](https://avatars.githubusercontent.com/u/26882621?v=4)](https://github.com/pschocke "pschocke (1 commits)")[![AntoineLemaire](https://avatars.githubusercontent.com/u/2025537?v=4)](https://github.com/AntoineLemaire "AntoineLemaire (1 commits)")[![sebalis](https://avatars.githubusercontent.com/u/8028279?v=4)](https://github.com/sebalis "sebalis (1 commits)")[![fbuchlak](https://avatars.githubusercontent.com/u/30214087?v=4)](https://github.com/fbuchlak "fbuchlak (1 commits)")[![JaZo](https://avatars.githubusercontent.com/u/3475007?v=4)](https://github.com/JaZo "JaZo (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/geocoder-php-nominatim-provider/health.svg)

```
[![Health](https://phpackages.com/badges/geocoder-php-nominatim-provider/health.svg)](https://phpackages.com/packages/geocoder-php-nominatim-provider)
```

###  Alternatives

[willdurand/geocoder-bundle

Integration of Geocoder into Symfony

3226.4M12](/packages/willdurand-geocoder-bundle)[geocoder-php/geo-plugin-provider

Geocoder GeoPlugin adapter

975.0M8](/packages/geocoder-php-geo-plugin-provider)[geocoder-php/chain-provider

Geocoder chain adapter

1046.8M13](/packages/geocoder-php-chain-provider)[geocoder-php/ipstack-provider

Geocoder Ipstack adapter

60334.1k2](/packages/geocoder-php-ipstack-provider)[swisnl/geocoder-php-nationaal-georegister-provider

PDOK (formerly Nationaal Georegister) provider for Geocoder PHP

28330.8k2](/packages/swisnl-geocoder-php-nationaal-georegister-provider)[geocoder-php/free-geoip-provider

Geocoder FreeGeoIp adapter

14751.8k7](/packages/geocoder-php-free-geoip-provider)

PHPackages © 2026

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