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

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

rinat-gizatullin/fkr-nominatim-bundle
=====================================

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

v1.0.4(10y ago)0114MITPHPPHP >=5.3.2

Since Mar 10Pushed 10y ago1 watchersCompare

[ Source](https://github.com/RinatGizatullin/FkrNominatimBundle)[ Packagist](https://packagist.org/packages/rinat-gizatullin/fkr-nominatim-bundle)[ Docs](https://github.com/fkrauthan/FkrNominatimBundle)[ RSS](/packages/rinat-gizatullin-fkr-nominatim-bundle/feed)WikiDiscussions master Synced 4d ago

READMEChangelog (1)Dependencies (1)Versions (6)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

28

—

LowBetter than 52% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 78.3% 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 ~253 days

Total

5

Last Release

3852d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1198738?v=4)[Rinat](/maintainers/Rinat)[@rinat](https://github.com/rinat)

---

Top Contributors

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

---

Tags

geolocationgeoSymfony Bundlenominatimosmopen street map

### Embed Badge

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

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

###  Alternatives

[maxh/php-nominatim

Wrapper for Nominatim API

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

Wrapper for Nominatim API to Laravel

1241.1k](/packages/jbohme-nominatim-laravel)[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.

1189.8k](/packages/rcsofttech-audit-trail-bundle)[web-auth/webauthn-framework

FIDO2/Webauthn library for PHP and Symfony Bundle.

515100.5k3](/packages/web-auth-webauthn-framework)[web-auth/webauthn-symfony-bundle

FIDO2/Webauthn Security Bundle For Symfony

66529.9k11](/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.

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

PHPackages © 2026

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