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

AbandonedArchivedSymfony-bundle[API Development](/categories/api)

fkr/nominatim-bundle
====================

Integrates nominatim api (Geolocation API based on OpenStreetMap) into Symfony2

v1.0.3(11y ago)65109[1 issues](https://github.com/fkrauthan/FkrNominatimBundle/issues)MITPHPPHP >=5.3.2

Since Mar 10Pushed 11y ago1 watchersCompare

[ Source](https://github.com/fkrauthan/FkrNominatimBundle)[ Packagist](https://packagist.org/packages/fkr/nominatim-bundle)[ Docs](https://github.com/fkrauthan/FkrNominatimBundle)[ RSS](/packages/fkr-nominatim-bundle/feed)WikiDiscussions master Synced today

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

FkrNominatimBundle
==================

[](#fkrnominatimbundle)

Integrates nominatim api (Geolocation API based on OpenStreetMap) into Symfony2.

What you need
=============

[](#what-you-need)

curl must be enabled on your server.

Installation
============

[](#installation)

Bring in the vendor library
---------------------------

[](#bring-in-the-vendor-library)

This can be done in three different ways:

**Method #1**) Use composer

```
"require": {
    "fkr/nominatim-bundle": "*"
}

```

**Method #2**) Use git submodules

```
git submodule add git://github.com/fkrauthan/FkrNominatimBundle.git vendor/bundles/Fkr/NominatimBundle

```

**Method #3**) Use deps file

```
[FkrNominatimBundle]
    git=git://github.com/fkrauthan/FkrNominatimBundle.git
	target=bundles/Fkr/NominatimBundle

```

Register the Fkr namespace
--------------------------

[](#register-the-fkr-namespace)

```
// app/autoload.php
$loader->registerNamespaces(array(
    'Fkr' => __DIR__.'/../vendor/bundles',
    // your other namespaces
));

```

Add FkrNominatimBundle to your application kernel
-------------------------------------------------

[](#add-fkrnominatimbundle-to-your-application-kernel)

```
// app/AppKernel.php
public function registerBundles()
{
    return array(
        // ...
        new Fkr\NominatimBundle\FkrNominatimBundle(),
        // ...
    );
}

```

Configuration
=============

[](#configuration)

```
# app/config.yml
fkr_nominatim:
    app_name:
    app_mail:

```

- app\_name: You must set your app name here (It's needed for OpenStreetMap API)
- app\_mail: You should set your mail here (It's needed that OpenStreetMap can contact you if any errors occours by using there API)

Usage
=====

[](#usage)

To get a GeolocationApi class instance just use the following code

```
$this->get('fkr_nominatim.geolocation_api')->locateAddress('My Street, 8888 MyCity');
$this->get('fkr_nominatim.geolocation_api')->locateAddress(array('My Street', '8888', 'MyCity'));

```

The result would be:

- null: If nothing was found
- Location object: If only one result was found
- array with Location objects: If more then one result was found

Licence
=======

[](#licence)

[Resources/meta/LICENSE](https://github.com/fkrauthan/FkrImagineBundle/blob/master/Resources/meta/LICENSE)

Nominatim usage policy
======================

[](#nominatim-usage-policy)

Please respect the [usage policy](http://wiki.openstreetmap.org/wiki/Nominatim_usage_policy) specified by Open Street Map for use of the Geocoding API.

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 94.7% 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 ~176 days

Total

4

Last Release

4331d ago

### Community

Maintainers

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

---

Top Contributors

[![fkrauthan](https://avatars.githubusercontent.com/u/1679841?v=4)](https://github.com/fkrauthan "fkrauthan (18 commits)")[![Buendon](https://avatars.githubusercontent.com/u/8401218?v=4)](https://github.com/Buendon "Buendon (1 commits)")

---

Tags

bundlephpsymfonysymfony-bundlegeolocationgeoSymfony Bundlenominatimosmopen street map

### Embed Badge

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

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

###  Alternatives

[maxh/php-nominatim

Wrapper for Nominatim API

50406.4k2](/packages/maxh-php-nominatim)[jbohme/nominatim-laravel

Wrapper for Nominatim API to Laravel

1240.5k](/packages/jbohme-nominatim-laravel)[web-auth/webauthn-framework

FIDO2/Webauthn library for PHP and Symfony Bundle.

51390.8k3](/packages/web-auth-webauthn-framework)[rcsofttech/audit-trail-bundle

Enterprise-grade, high-performance Symfony audit trail bundle. Automatically track Doctrine entity changes with split-phase architecture, multiple transports (HTTP, Queue, Doctrine), and sensitive data masking.

1175.2k](/packages/rcsofttech-audit-trail-bundle)[web-auth/webauthn-symfony-bundle

FIDO2/Webauthn Security Bundle For Symfony

65474.5k9](/packages/web-auth-webauthn-symfony-bundle)[ahmed-bhs/doctrine-doctor

Runtime analysis tool for Doctrine ORM integrated into Symfony Web Profiler. Unlike static linters, it analyzes actual query execution at runtime to detect performance bottlenecks, security vulnerabilities, and best practice violations during development with real execution context and data.

939.0k](/packages/ahmed-bhs-doctrine-doctor)

PHPackages © 2026

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