PHPackages                             opendi/nominatim - 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. opendi/nominatim

ActiveLibrary[API Development](/categories/api)

opendi/nominatim
================

A simple interface to OSM Nominatim search.

1.0.0(8y ago)31.6k2Apache-2.0PHPPHP ^5.6.0 || ^7.0.0CI failing

Since Jul 9Pushed 8y ago7 watchersCompare

[ Source](https://github.com/opendi/nominatim)[ Packagist](https://packagist.org/packages/opendi/nominatim)[ RSS](/packages/opendi-nominatim/feed)WikiDiscussions develop Synced today

READMEChangelogDependencies (3)Versions (5)Used By (0)

Opendi Nominatim
================

[](#opendi-nominatim)

A simple interface to OSM Nominatim search.

[![Latest Stable Version](https://camo.githubusercontent.com/b791f4fa5839e478cfacde7acda0e3a75c7768980428e47d4c1c426136b712ab/68747470733a2f2f706f7365722e707567782e6f72672f6f70656e64692f6e6f6d696e6174696d2f762f737461626c652e706e67)](https://packagist.org/packages/opendi/nominatim) [![Total Downloads](https://camo.githubusercontent.com/60b8d1ab6db7a4231d9c6aaf8821dbdbfb75a7a1af8af6fae7c28a498ee6fe09/68747470733a2f2f706f7365722e707567782e6f72672f6f70656e64692f6e6f6d696e6174696d2f646f776e6c6f6164732e706e67)](https://packagist.org/packages/opendi/nominatim) [![Build Status](https://camo.githubusercontent.com/d384afd8ec646aa50f3ab26aabe4bfefaf72aea24a1effc36b596d51e245afd1/68747470733a2f2f636972636c6563692e636f6d2f67682f6f70656e64692f6e6f6d696e6174696d2e706e673f636972636c652d746f6b656e3d37396238363234303637303662666234303230343837616139386161363531613731613563643466)](https://circleci.com/gh/opendi/nominatim) [![License](https://camo.githubusercontent.com/9897b584887c6f94c41dd7cd32d99fcdeaac10af99468074f21732b5dac6b609/68747470733a2f2f706f7365722e707567782e6f72672f6f70656e64692f6e6f6d696e6174696d2f6c6963656e73652e706e67)](https://packagist.org/packages/opendi/nominatim)

See [Nominatim documentation](http://wiki.openstreetmap.org/wiki/Nominatim) for info on the service.

Basic usage
-----------

[](#basic-usage)

Create a new instance of Nominatim by using the `newInstance()` factory method.

```
use Opendi\Nominatim\Nominatim;

$url = "http://nominatim.openstreetmap.org/";
$nominatim = Nominatim::newInstance($url);
```

Searching by query:

```
$search = $nominatim->newSearch();
$search->query('1600 Pennsylvania Ave NW, Washington, DC 20500, United States');

$nominatim->find($search);
```

Or break it down by address:

```
$search = $nominatim->newSearch()
    ->street('1600 Pennsylvania Ave NW')
    ->city('Washington')
    ->county('Washington')
    ->state('Washington DC')
    ->postalCode('DC 20500')
    ->country('United States')
    ->addressDetails();

$nominatim->find($search);
```

The result will be an array of results (in this case, only one result was found).

```
Array
(
    [0] => Array
        (
            [place_id] => 2632584431
            [licence] => Data © OpenStreetMap contributors, ODbL 1.0. http://www.openstreetmap.org/copyright
            [osm_type] => way
            [osm_id] => 238241022
            [boundingbox] => Array
                (
                    [0] => 38.8974898
                    [1] => 38.897911
                    [2] => -77.0368539
                    [3] => -77.0362521
                )

            [lat] => 38.8976989
            [lon] => -77.036553192281
            [display_name] => The White House, 1600, Pennsylvania Avenue Northwest, Thomas Circle, Southwest Waterfront, Washington, 20500, United States of America
            [class] => tourism
            [type] => attraction
            [importance] => 1.5576757387296
            [icon] => http://nominatim.openstreetmap.org/images/mapicons/poi_point_of_interest.p.20.png
            [address] => Array
                (
                    [attraction] => The White House
                    [house_number] => 1600
                    [pedestrian] => Pennsylvania Avenue Northwest
                    [neighbourhood] => Thomas Circle
                    [suburb] => Southwest Waterfront
                    [city] => Washington
                    [county] => Washington
                    [postcode] => 20500
                    [country] => United States of America
                    [country_code] => us
                )

        )

)
```

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity61

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

Total

3

Last Release

3030d ago

Major Versions

0.2.0 → 1.0.02018-01-22

PHP version history (2 changes)0.1PHP >=5.4.0

1.0.0PHP ^5.6.0 || ^7.0.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/69d0973e79ec870cb60522b5785e3e78e17d4b3569dde896d693b01a381c6f59?d=identicon)[ihabunek](/maintainers/ihabunek)

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

---

Top Contributors

[![bearzk](https://avatars.githubusercontent.com/u/775611?v=4)](https://github.com/bearzk "bearzk (11 commits)")[![ihabunek](https://avatars.githubusercontent.com/u/482138?v=4)](https://github.com/ihabunek "ihabunek (11 commits)")[![mfeldheim](https://avatars.githubusercontent.com/u/878755?v=4)](https://github.com/mfeldheim "mfeldheim (2 commits)")[![grobmeier](https://avatars.githubusercontent.com/u/873786?v=4)](https://github.com/grobmeier "grobmeier (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/opendi-nominatim/health.svg)

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

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

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